From 366a569167888a0e23ae073ce09010adec4df579 Mon Sep 17 00:00:00 2001 From: adrientaudiere <6680165+adrientaudiere@users.noreply.github.com> Date: Tue, 19 Nov 2024 06:47:26 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20adrienta?= =?UTF-8?q?udiere/greenAlgoR@5658709e96f66eb721199f048b238b33893a7d33=20?= =?UTF-8?q?=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- LICENSE.html | 2 +- authors.html | 2 +- news/index.html | 2 +- pkgdown.yml | 2 +- reference/csv_from_url_ga.html | 2 +- reference/ga_footprint.html | 90 +++++++++++++++--------------- reference/ga_targets-1.png | Bin 117775 -> 117582 bytes reference/ga_targets.html | 6 +- reference/greenAlgoR-package.html | 2 +- reference/round_conditionaly.html | 2 +- reference/session_runtime.html | 20 +++---- search.json | 2 +- 12 files changed, 66 insertions(+), 66 deletions(-) diff --git a/LICENSE.html b/LICENSE.html index 9d329f5..6e2e0e7 100644 --- a/LICENSE.html +++ b/LICENSE.html @@ -29,7 +29,7 @@

GNU General Public License

- Source: LICENSE.md + Source: LICENSE.md
diff --git a/authors.html b/authors.html index 50ff745..f98cd92 100644 --- a/authors.html +++ b/authors.html @@ -42,7 +42,7 @@

Authors

Citation

-

Source: DESCRIPTION

+

Source: DESCRIPTION

Taudière A (2024). greenAlgoR: Compute ecological footprint in R. diff --git a/news/index.html b/news/index.html index 711307c..b4ca229 100644 --- a/news/index.html +++ b/news/index.html @@ -29,7 +29,7 @@

Changelog

- Source: NEWS.md + Source: NEWS.md
diff --git a/pkgdown.yml b/pkgdown.yml index d7b4148..cddfca8 100644 --- a/pkgdown.yml +++ b/pkgdown.yml @@ -2,7 +2,7 @@ pandoc: 3.1.11 pkgdown: 2.1.1 pkgdown_sha: ~ articles: {} -last_built: 2024-11-19T06:37Z +last_built: 2024-11-19T06:47Z urls: reference: https://adrientaudiere.github.io/greenAlgoR/reference article: https://adrientaudiere.github.io/greenAlgoR/articles diff --git a/reference/csv_from_url_ga.html b/reference/csv_from_url_ga.html index a1f6d65..6da6ec4 100644 --- a/reference/csv_from_url_ga.html +++ b/reference/csv_from_url_ga.html @@ -35,7 +35,7 @@

Load csv files from green algo github repositories

- Source: R/utils.R + Source: R/utils.R
csv_from_url_ga.Rd
diff --git a/reference/ga_footprint.html b/reference/ga_footprint.html index 3f4c68c..156ef08 100644 --- a/reference/ga_footprint.html +++ b/reference/ga_footprint.html @@ -93,7 +93,7 @@

Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm

- Source: R/ga_footprint.R + Source: R/ga_footprint.R
ga_footprint.Rd
@@ -345,7 +345,7 @@

Examples#> [1] 1.1376 #> #> $power_draw_for_memory_kWh -#> [1] 0.0749053 +#> [1] 0.07490532 #> #> $energy_needed_kWh #> [1] 1.212505 @@ -354,16 +354,16 @@

Examples#> [1] 58.33613 #> #> $carbon_footprint_memory -#> [1] 3.841144 +#> [1] 3.841145 #> #> $carbon_footprint_total_gCO2 #> [1] 62.17727 #> #> $ref_value #> variable value -#> 1 Total 62.1772718537736 +#> 1 Total 62.1772727926653 #> 2 Cores 1.1376 -#> 3 Memory 0.07490530136064 +#> 3 Memory 0.07490531966976 #> 4 memoryPower 0.3725 #> 5 google_search 10 #> 6 streaming_netflix_perhour 36 @@ -395,7 +395,7 @@

Examples#> prop_footprint #> 1 1.000000e+00 #> 2 1.829607e-02 -#> 3 1.204705e-03 +#> 3 1.204706e-03 #> 4 5.990935e-03 #> 5 1.608305e-01 #> 6 5.789897e-01 @@ -405,7 +405,7 @@

Examples#> 10 4.036845e+00 #> 11 1.474815e+01 #> 12 1.769135e+02 -#> 13 8.041524e+02 +#> 13 8.041523e+02 #> 14 9.167337e+03 #> 15 3.715184e+04 #> @@ -415,8 +415,8 @@

Examples PUE = 1, ) #> $runtime_h -#> user.self -#> 0.001775833 +#> user.self +#> 0.0018375 #> #> $location_code #> [1] "WORLD" @@ -450,45 +450,45 @@

Examples#> #> $power_draw_for_cores_kWh #> user.self -#> 2.131e-05 +#> 2.205e-05 #> #> $power_draw_for_memory_kWh #> user.self -#> 1.108494e-05 +#> 1.146988e-05 #> #> $energy_needed_kWh #> user.self -#> 3.239494e-05 +#> 3.351988e-05 #> #> $carbon_footprint_cores #> user.self -#> 0.01012225 +#> 0.01047375 #> #> $carbon_footprint_memory #> user.self -#> 0.005265349 +#> 0.005448192 #> #> $carbon_footprint_total_gCO2 -#> user.self -#> 0.0153876 +#> user.self +#> 0.01592194 #> #> $ref_value -#> variable value -#> 1 Total 0.0153875985187343 -#> 2 Cores 2.131e-05 -#> 3 Memory 1.10849442499669e-05 -#> 4 memoryPower 0.3725 -#> 5 google_search 10 -#> 6 streaming_netflix_perhour 36 -#> 7 train_perkm 41 -#> 8 flight_economy_perkm 171 -#> 9 passengerCar_EU_perkm 175 -#> 10 passengerCar_US_perkm 251 -#> 11 tree_month 917 -#> 12 treeYear 11000 -#> 13 flight_PAR-LON 50000 -#> 14 flight_NY-SF 570000 -#> 15 flight_NYC-MEL 2310000 +#> variable value +#> 1 Total 0.0159219416103552 +#> 2 Cores 2.205e-05 +#> 3 Memory 1.1469877074432e-05 +#> 4 memoryPower 0.3725 +#> 5 google_search 10 +#> 6 streaming_netflix_perhour 36 +#> 7 train_perkm 41 +#> 8 flight_economy_perkm 171 +#> 9 passengerCar_EU_perkm 175 +#> 10 passengerCar_US_perkm 251 +#> 11 tree_month 917 +#> 12 treeYear 11000 +#> 13 flight_PAR-LON 50000 +#> 14 flight_NY-SF 570000 +#> 15 flight_NYC-MEL 2310000 #> source #> 1 <NA> #> 2 <NA> @@ -508,19 +508,19 @@

Examples#> prop_footprint #> 1 1.000000e+00 #> 2 1.384881e-03 -#> 3 7.203817e-04 -#> 4 2.420781e+01 -#> 5 6.498740e+02 -#> 6 2.339546e+03 -#> 7 2.664483e+03 -#> 8 1.111285e+04 -#> 9 1.137279e+04 -#> 10 1.631184e+04 -#> 11 5.959344e+04 -#> 12 7.148614e+05 -#> 13 3.249370e+06 -#> 14 3.704282e+07 -#> 15 1.501209e+08 +#> 3 7.203818e-04 +#> 4 2.339539e+01 +#> 5 6.280641e+02 +#> 6 2.261031e+03 +#> 7 2.575063e+03 +#> 8 1.073990e+04 +#> 9 1.099112e+04 +#> 10 1.576441e+04 +#> 11 5.759348e+04 +#> 12 6.908705e+05 +#> 13 3.140321e+06 +#> 14 3.579965e+07 +#> 15 1.450828e+08 #> res_ga <- ga_footprint( diff --git a/reference/ga_targets-1.png b/reference/ga_targets-1.png index cdbf6465c51d2aff392764830f09e5dd072927ca..b77628d166a092ee1c23216393f1532ffed5bb83 100644 GIT binary patch literal 117582 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%0D!Yh?I$RW^GC*)) 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⁡yaKC3ewBkZ8X4mo+ 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

bBs;rHZr{9_Sa&{G_R7OIh#|fL3%7$Vc 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 Xvd`>DCku@RLN#&f_o3r|`uYC=;)B&l diff --git a/reference/ga_targets.html b/reference/ga_targets.html index fad1ce7..1250135 100644 --- a/reference/ga_targets.html +++ b/reference/ga_targets.html @@ -39,7 +39,7 @@

Compute footprint in grams of CO2 for {targets} pipelines

- Source: R/ga_targets.R + Source: R/ga_targets.R
ga_targets.Rd
@@ -189,10 +189,10 @@

Examples ylab("Modality") }) #> ▶ dispatched target x -#> ● completed target x [0 seconds, 44 bytes] +#> ● completed target x [0.001 seconds, 44 bytes] #> ▶ dispatched target waiting #> ● completed target waiting [2.002 seconds, 44 bytes] -#> ▶ ended pipeline [2.064 seconds] +#> ▶ ended pipeline [2.067 seconds] #> diff --git a/reference/greenAlgoR-package.html b/reference/greenAlgoR-package.html index 59ac73d..f72bc7c 100644 --- a/reference/greenAlgoR-package.html +++ b/reference/greenAlgoR-package.html @@ -31,7 +31,7 @@

greenAlgoR package

- Source: R/greenAlgo-package.R + Source: R/greenAlgo-package.R
greenAlgoR-package.Rd
diff --git a/reference/round_conditionaly.html b/reference/round_conditionaly.html index 7597e81..4c32641 100644 --- a/reference/round_conditionaly.html +++ b/reference/round_conditionaly.html @@ -29,7 +29,7 @@

Round numeric vector conditionaly

- Source: R/utils.R + Source: R/utils.R
round_conditionaly.Rd
diff --git a/reference/session_runtime.html b/reference/session_runtime.html index 6e82562..62a80c4 100644 --- a/reference/session_runtime.html +++ b/reference/session_runtime.html @@ -37,7 +37,7 @@

Compute session run time and mass storage use (based on gc())

- Source: R/utils.R + Source: R/utils.R
session_runtime.Rd
@@ -77,42 +77,42 @@

Examples
session_runtime()
 #> $cpu_times_users
 #> user.self 
-#>     7.666 
+#>       7.9 
 #> 
 #> $cpu_times_system
 #> user.child 
-#>      1.929 
+#>      2.054 
 #> 
 #> $time_elapsed
 #> elapsed 
-#>  13.789 
+#>  13.381 
 #> 
 #> $cpu_times
 #> user.self 
-#>     9.595 
+#>     9.954 
 #> 
 #> $mass_storage_used
 #> [1] 236
 #> 
 #> $mass_storage_max
-#> [1] 357.8
+#> [1] 358.4
 #> 
 session_runtime(compute_mass_storage = FALSE)
 #> $cpu_times_users
 #> user.self 
-#>     8.122 
+#>      8.39 
 #> 
 #> $cpu_times_system
 #> user.child 
-#>      1.929 
+#>      2.054 
 #> 
 #> $time_elapsed
 #> elapsed 
-#>  14.245 
+#>  13.871 
 #> 
 #> $cpu_times
 #> user.self 
-#>    10.051 
+#>    10.444 
 #>

diff --git a/search.json b/search.json index 92e423a..f3226c4 100644 --- a/search.json +++ b/search.json @@ -1 +1 @@ -[{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"GNU General Public License","title":"GNU General Public License","text":"Version 3, 29 June 2007Copyright © 2007 Free Software Foundation, Inc.  Everyone permitted copy distribute verbatim copies license document, changing allowed.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"preamble","dir":"","previous_headings":"","what":"Preamble","title":"GNU General Public License","text":"GNU General Public License free, copyleft license software kinds works. licenses software practical works designed take away freedom share change works. contrast, GNU General Public License intended guarantee freedom share change versions program–make sure remains free software users. , Free Software Foundation, use GNU General Public License software; applies also work released way authors. can apply programs, . speak free software, referring freedom, price. General Public Licenses designed make sure freedom distribute copies free software (charge wish), receive source code can get want , can change software use pieces new free programs, know can things. protect rights, need prevent others denying rights asking surrender rights. Therefore, certain responsibilities distribute copies software, modify : responsibilities respect freedom others. example, distribute copies program, whether gratis fee, must pass recipients freedoms received. must make sure , , receive can get source code. must show terms know rights. Developers use GNU GPL protect rights two steps: (1) assert copyright software, (2) offer License giving legal permission copy, distribute /modify . developers’ authors’ protection, GPL clearly explains warranty free software. users’ authors’ sake, GPL requires modified versions marked changed, problems attributed erroneously authors previous versions. devices designed deny users access install run modified versions software inside , although manufacturer can . fundamentally incompatible aim protecting users’ freedom change software. systematic pattern abuse occurs area products individuals use, precisely unacceptable. Therefore, designed version GPL prohibit practice products. problems arise substantially domains, stand ready extend provision domains future versions GPL, needed protect freedom users. Finally, every program threatened constantly software patents. States allow patents restrict development use software general-purpose computers, , wish avoid special danger patents applied free program make effectively proprietary. prevent , GPL assures patents used render program non-free. precise terms conditions copying, distribution modification follow.","code":""},{"path":[]},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_0-definitions","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"0. Definitions","title":"GNU General Public License","text":"“License” refers version 3 GNU General Public License. “Copyright” also means copyright-like laws apply kinds works, semiconductor masks. “Program” refers copyrightable work licensed License. licensee addressed “”. “Licensees” “recipients” may individuals organizations. “modify” work means copy adapt part work fashion requiring copyright permission, making exact copy. resulting work called “modified version” earlier work work “based ” earlier work. “covered work” means either unmodified Program work based Program. “propagate” work means anything , without permission, make directly secondarily liable infringement applicable copyright law, except executing computer modifying private copy. Propagation includes copying, distribution (without modification), making available public, countries activities well. “convey” work means kind propagation enables parties make receive copies. Mere interaction user computer network, transfer copy, conveying. interactive user interface displays “Appropriate Legal Notices” extent includes convenient prominently visible feature (1) displays appropriate copyright notice, (2) tells user warranty work (except extent warranties provided), licensees may convey work License, view copy License. interface presents list user commands options, menu, prominent item list meets criterion.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_1-source-code","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"1. Source Code","title":"GNU General Public License","text":"“source code” work means preferred form work making modifications . “Object code” means non-source form work. “Standard Interface” means interface either official standard defined recognized standards body, , case interfaces specified particular programming language, one widely used among developers working language. “System Libraries” executable work include anything, work whole, () included normal form packaging Major Component, part Major Component, (b) serves enable use work Major Component, implement Standard Interface implementation available public source code form. “Major Component”, context, means major essential component (kernel, window system, ) specific operating system () executable work runs, compiler used produce work, object code interpreter used run . “Corresponding Source” work object code form means source code needed generate, install, (executable work) run object code modify work, including scripts control activities. However, include work’s System Libraries, general-purpose tools generally available free programs used unmodified performing activities part work. example, Corresponding Source includes interface definition files associated source files work, source code shared libraries dynamically linked subprograms work specifically designed require, intimate data communication control flow subprograms parts work. Corresponding Source need include anything users can regenerate automatically parts Corresponding Source. Corresponding Source work source code form work.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_2-basic-permissions","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"2. Basic Permissions","title":"GNU General Public License","text":"rights granted License granted term copyright Program, irrevocable provided stated conditions met. License explicitly affirms unlimited permission run unmodified Program. output running covered work covered License output, given content, constitutes covered work. License acknowledges rights fair use equivalent, provided copyright law. may make, run propagate covered works convey, without conditions long license otherwise remains force. may convey covered works others sole purpose make modifications exclusively , provide facilities running works, provided comply terms License conveying material control copyright. thus making running covered works must exclusively behalf, direction control, terms prohibit making copies copyrighted material outside relationship . Conveying circumstances permitted solely conditions stated . Sublicensing allowed; section 10 makes unnecessary.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_3-protecting-users-legal-rights-from-anti-circumvention-law","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"3. Protecting Users’ Legal Rights From Anti-Circumvention Law","title":"GNU General Public License","text":"covered work shall deemed part effective technological measure applicable law fulfilling obligations article 11 WIPO copyright treaty adopted 20 December 1996, similar laws prohibiting restricting circumvention measures. convey covered work, waive legal power forbid circumvention technological measures extent circumvention effected exercising rights License respect covered work, disclaim intention limit operation modification work means enforcing, work’s users, third parties’ legal rights forbid circumvention technological measures.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_4-conveying-verbatim-copies","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"4. Conveying Verbatim Copies","title":"GNU General Public License","text":"may convey verbatim copies Program’s source code receive , medium, provided conspicuously appropriately publish copy appropriate copyright notice; keep intact notices stating License non-permissive terms added accord section 7 apply code; keep intact notices absence warranty; give recipients copy License along Program. may charge price price copy convey, may offer support warranty protection fee.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_5-conveying-modified-source-versions","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"5. Conveying Modified Source Versions","title":"GNU General Public License","text":"may convey work based Program, modifications produce Program, form source code terms section 4, provided also meet conditions: ) work must carry prominent notices stating modified , giving relevant date. b) work must carry prominent notices stating released License conditions added section 7. requirement modifies requirement section 4 “keep intact notices”. c) must license entire work, whole, License anyone comes possession copy. License therefore apply, along applicable section 7 additional terms, whole work, parts, regardless packaged. License gives permission license work way, invalidate permission separately received . d) work interactive user interfaces, must display Appropriate Legal Notices; however, Program interactive interfaces display Appropriate Legal Notices, work need make . compilation covered work separate independent works, nature extensions covered work, combined form larger program, volume storage distribution medium, called “aggregate” compilation resulting copyright used limit access legal rights compilation’s users beyond individual works permit. Inclusion covered work aggregate cause License apply parts aggregate.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_6-conveying-non-source-forms","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"6. Conveying Non-Source Forms","title":"GNU General Public License","text":"may convey covered work object code form terms sections 4 5, provided also convey machine-readable Corresponding Source terms License, one ways: ) Convey object code , embodied , physical product (including physical distribution medium), accompanied Corresponding Source fixed durable physical medium customarily used software interchange. b) Convey object code , embodied , physical product (including physical distribution medium), accompanied written offer, valid least three years valid long offer spare parts customer support product model, give anyone possesses object code either (1) copy Corresponding Source software product covered License, durable physical medium customarily used software interchange, price reasonable cost physically performing conveying source, (2) access copy Corresponding Source network server charge. c) Convey individual copies object code copy written offer provide Corresponding Source. alternative allowed occasionally noncommercially, received object code offer, accord subsection 6b. d) Convey object code offering access designated place (gratis charge), offer equivalent access Corresponding Source way place charge. need require recipients copy Corresponding Source along object code. place copy object code network server, Corresponding Source may different server (operated third party) supports equivalent copying facilities, provided maintain clear directions next object code saying find Corresponding Source. Regardless server hosts Corresponding Source, remain obligated ensure available long needed satisfy requirements. e) Convey object code using peer--peer transmission, provided inform peers object code Corresponding Source work offered general public charge subsection 6d. separable portion object code, whose source code excluded Corresponding Source System Library, need included conveying object code work. “User Product” either (1) “consumer product”, means tangible personal property normally used personal, family, household purposes, (2) anything designed sold incorporation dwelling. determining whether product consumer product, doubtful cases shall resolved favor coverage. particular product received particular user, “normally used” refers typical common use class product, regardless status particular user way particular user actually uses, expects expected use, product. product consumer product regardless whether product substantial commercial, industrial non-consumer uses, unless uses represent significant mode use product. “Installation Information” User Product means methods, procedures, authorization keys, information required install execute modified versions covered work User Product modified version Corresponding Source. information must suffice ensure continued functioning modified object code case prevented interfered solely modification made. convey object code work section , , specifically use , User Product, conveying occurs part transaction right possession use User Product transferred recipient perpetuity fixed term (regardless transaction characterized), Corresponding Source conveyed section must accompanied Installation Information. requirement apply neither third party retains ability install modified object code User Product (example, work installed ROM). requirement provide Installation Information include requirement continue provide support service, warranty, updates work modified installed recipient, User Product modified installed. Access network may denied modification materially adversely affects operation network violates rules protocols communication across network. Corresponding Source conveyed, Installation Information provided, accord section must format publicly documented (implementation available public source code form), must require special password key unpacking, reading copying.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_7-additional-terms","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"7. Additional Terms","title":"GNU General Public License","text":"“Additional permissions” terms supplement terms License making exceptions one conditions. Additional permissions applicable entire Program shall treated though included License, extent valid applicable law. additional permissions apply part Program, part may used separately permissions, entire Program remains governed License without regard additional permissions. convey copy covered work, may option remove additional permissions copy, part . (Additional permissions may written require removal certain cases modify work.) may place additional permissions material, added covered work, can give appropriate copyright permission. Notwithstanding provision License, material add covered work, may (authorized copyright holders material) supplement terms License terms: ) Disclaiming warranty limiting liability differently terms sections 15 16 License; b) Requiring preservation specified reasonable legal notices author attributions material Appropriate Legal Notices displayed works containing ; c) Prohibiting misrepresentation origin material, requiring modified versions material marked reasonable ways different original version; d) Limiting use publicity purposes names licensors authors material; e) Declining grant rights trademark law use trade names, trademarks, service marks; f) Requiring indemnification licensors authors material anyone conveys material (modified versions ) contractual assumptions liability recipient, liability contractual assumptions directly impose licensors authors. non-permissive additional terms considered “restrictions” within meaning section 10. Program received , part , contains notice stating governed License along term restriction, may remove term. license document contains restriction permits relicensing conveying License, may add covered work material governed terms license document, provided restriction survive relicensing conveying. add terms covered work accord section, must place, relevant source files, statement additional terms apply files, notice indicating find applicable terms. Additional terms, permissive non-permissive, may stated form separately written license, stated exceptions; requirements apply either way.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_8-termination","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"8. Termination","title":"GNU General Public License","text":"may propagate modify covered work except expressly provided License. attempt otherwise propagate modify void, automatically terminate rights License (including patent licenses granted third paragraph section 11). However, cease violation License, license particular copyright holder reinstated () provisionally, unless copyright holder explicitly finally terminates license, (b) permanently, copyright holder fails notify violation reasonable means prior 60 days cessation. Moreover, license particular copyright holder reinstated permanently copyright holder notifies violation reasonable means, first time received notice violation License (work) copyright holder, cure violation prior 30 days receipt notice. Termination rights section terminate licenses parties received copies rights License. rights terminated permanently reinstated, qualify receive new licenses material section 10.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_9-acceptance-not-required-for-having-copies","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"9. Acceptance Not Required for Having Copies","title":"GNU General Public License","text":"required accept License order receive run copy Program. Ancillary propagation covered work occurring solely consequence using peer--peer transmission receive copy likewise require acceptance. However, nothing License grants permission propagate modify covered work. actions infringe copyright accept License. Therefore, modifying propagating covered work, indicate acceptance License .","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_10-automatic-licensing-of-downstream-recipients","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"10. Automatic Licensing of Downstream Recipients","title":"GNU General Public License","text":"time convey covered work, recipient automatically receives license original licensors, run, modify propagate work, subject License. responsible enforcing compliance third parties License. “entity transaction” transaction transferring control organization, substantially assets one, subdividing organization, merging organizations. propagation covered work results entity transaction, party transaction receives copy work also receives whatever licenses work party’s predecessor interest give previous paragraph, plus right possession Corresponding Source work predecessor interest, predecessor can get reasonable efforts. may impose restrictions exercise rights granted affirmed License. example, may impose license fee, royalty, charge exercise rights granted License, may initiate litigation (including cross-claim counterclaim lawsuit) alleging patent claim infringed making, using, selling, offering sale, importing Program portion .","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_11-patents","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"11. Patents","title":"GNU General Public License","text":"“contributor” copyright holder authorizes use License Program work Program based. work thus licensed called contributor’s “contributor version”. contributor’s “essential patent claims” patent claims owned controlled contributor, whether already acquired hereafter acquired, infringed manner, permitted License, making, using, selling contributor version, include claims infringed consequence modification contributor version. purposes definition, “control” includes right grant patent sublicenses manner consistent requirements License. contributor grants non-exclusive, worldwide, royalty-free patent license contributor’s essential patent claims, make, use, sell, offer sale, import otherwise run, modify propagate contents contributor version. following three paragraphs, “patent license” express agreement commitment, however denominated, enforce patent (express permission practice patent covenant sue patent infringement). “grant” patent license party means make agreement commitment enforce patent party. convey covered work, knowingly relying patent license, Corresponding Source work available anyone copy, free charge terms License, publicly available network server readily accessible means, must either (1) cause Corresponding Source available, (2) arrange deprive benefit patent license particular work, (3) arrange, manner consistent requirements License, extend patent license downstream recipients. “Knowingly relying” means actual knowledge , patent license, conveying covered work country, recipient’s use covered work country, infringe one identifiable patents country reason believe valid. , pursuant connection single transaction arrangement, convey, propagate procuring conveyance , covered work, grant patent license parties receiving covered work authorizing use, propagate, modify convey specific copy covered work, patent license grant automatically extended recipients covered work works based . patent license “discriminatory” include within scope coverage, prohibits exercise , conditioned non-exercise one rights specifically granted License. may convey covered work party arrangement third party business distributing software, make payment third party based extent activity conveying work, third party grants, parties receive covered work , discriminatory patent license () connection copies covered work conveyed (copies made copies), (b) primarily connection specific products compilations contain covered work, unless entered arrangement, patent license granted, prior 28 March 2007. Nothing License shall construed excluding limiting implied license defenses infringement may otherwise available applicable patent law.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_12-no-surrender-of-others-freedom","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"12. No Surrender of Others’ Freedom","title":"GNU General Public License","text":"conditions imposed (whether court order, agreement otherwise) contradict conditions License, excuse conditions License. convey covered work satisfy simultaneously obligations License pertinent obligations, consequence may convey . example, agree terms obligate collect royalty conveying convey Program, way satisfy terms License refrain entirely conveying Program.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_13-use-with-the-gnu-affero-general-public-license","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"13. Use with the GNU Affero General Public License","title":"GNU General Public License","text":"Notwithstanding provision License, permission link combine covered work work licensed version 3 GNU Affero General Public License single combined work, convey resulting work. terms License continue apply part covered work, special requirements GNU Affero General Public License, section 13, concerning interaction network apply combination .","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_14-revised-versions-of-this-license","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"14. Revised Versions of this License","title":"GNU General Public License","text":"Free Software Foundation may publish revised /new versions GNU General Public License time time. new versions similar spirit present version, may differ detail address new problems concerns. version given distinguishing version number. Program specifies certain numbered version GNU General Public License “later version” applies , option following terms conditions either numbered version later version published Free Software Foundation. Program specify version number GNU General Public License, may choose version ever published Free Software Foundation. Program specifies proxy can decide future versions GNU General Public License can used, proxy’s public statement acceptance version permanently authorizes choose version Program. Later license versions may give additional different permissions. However, additional obligations imposed author copyright holder result choosing follow later version.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_15-disclaimer-of-warranty","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"15. Disclaimer of Warranty","title":"GNU General Public License","text":"WARRANTY PROGRAM, EXTENT PERMITTED APPLICABLE LAW. EXCEPT OTHERWISE STATED WRITING COPYRIGHT HOLDERS /PARTIES PROVIDE PROGRAM “” WITHOUT WARRANTY KIND, EITHER EXPRESSED IMPLIED, INCLUDING, LIMITED , IMPLIED WARRANTIES MERCHANTABILITY FITNESS PARTICULAR PURPOSE. ENTIRE RISK QUALITY PERFORMANCE PROGRAM . PROGRAM PROVE DEFECTIVE, ASSUME COST NECESSARY SERVICING, REPAIR CORRECTION.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_16-limitation-of-liability","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"16. Limitation of Liability","title":"GNU General Public License","text":"EVENT UNLESS REQUIRED APPLICABLE LAW AGREED WRITING COPYRIGHT HOLDER, PARTY MODIFIES /CONVEYS PROGRAM PERMITTED , LIABLE DAMAGES, INCLUDING GENERAL, SPECIAL, INCIDENTAL CONSEQUENTIAL DAMAGES ARISING USE INABILITY USE PROGRAM (INCLUDING LIMITED LOSS DATA DATA RENDERED INACCURATE LOSSES SUSTAINED THIRD PARTIES FAILURE PROGRAM OPERATE PROGRAMS), EVEN HOLDER PARTY ADVISED POSSIBILITY DAMAGES.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_17-interpretation-of-sections-15-and-16","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"17. Interpretation of Sections 15 and 16","title":"GNU General Public License","text":"disclaimer warranty limitation liability provided given local legal effect according terms, reviewing courts shall apply local law closely approximates absolute waiver civil liability connection Program, unless warranty assumption liability accompanies copy Program return fee. END TERMS CONDITIONS","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"how-to-apply-these-terms-to-your-new-programs","dir":"","previous_headings":"","what":"How to Apply These Terms to Your New Programs","title":"GNU General Public License","text":"develop new program, want greatest possible use public, best way achieve make free software everyone can redistribute change terms. , attach following notices program. safest attach start source file effectively state exclusion warranty; file least “copyright” line pointer full notice found. Also add information contact electronic paper mail. program terminal interaction, make output short notice like starts interactive mode: hypothetical commands show w show c show appropriate parts General Public License. course, program’s commands might different; GUI interface, use “box”. also get employer (work programmer) school, , sign “copyright disclaimer” program, necessary. information , apply follow GNU GPL, see . GNU General Public License permit incorporating program proprietary programs. program subroutine library, may consider useful permit linking proprietary applications library. want , use GNU Lesser General Public License instead License. first, please read .","code":" Copyright (C) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type 'show w'. This is free software, and you are welcome to redistribute it under certain conditions; type 'show c' for details."},{"path":"https://adrientaudiere.github.io/greenAlgoR/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Adrien Taudière. Author, maintainer, copyright holder.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Taudière (2024). greenAlgoR: Compute ecological footprint R. R package version 0.1, https://adrientaudiere.github.io/greenAlgoR/, https://github.com/adrientaudiere/greenAlgoR.","code":"@Manual{, title = {greenAlgoR: Compute ecological footprint in R}, author = {Adrien Taudière}, year = {2024}, note = {R package version 0.1, https://adrientaudiere.github.io/greenAlgoR/}, url = {https://github.com/adrientaudiere/greenAlgoR}, }"},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"greenalgor","dir":"","previous_headings":"","what":"Compute ecological footprint in R","title":"Compute ecological footprint in R","text":"package computes ecological footprint R (based green-algorithms, Lannelongue, Grealey, Inouye (2021)). aim facilitate programmatic used green-algorithms using function ga_footprint(). Moreover, greenAlgoR made simple compute ecological footprint {targets} pipelines using function ga_targets(). beta-version. Please submit issues found problems want contribute.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Compute ecological footprint in R","text":"greenAlgoR available CRAN moment. can install stable development version GitHub :","code":"if (!require(\"devtools\", quietly = TRUE)) { install.packages(\"devtools\") } devtools::install_github(\"adrientaudiere/greenAlgoR\")"},{"path":[]},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"the-algorithm-from-lannelongue-grealey-and-inouye-2021","dir":"","previous_headings":"Scientific foundation","what":"The algorithm from Lannelongue, Grealey, and Inouye (2021)","title":"Compute ecological footprint in R","text":"can refer green-algorithms Lannelongue, Grealey, Inouye (2021) understand algorithm. short description green-algorithms carbon footprint calculated estimating energy draw algorithm carbon intensity producing energy given location: energy needed : power draw computing cores depends model number cores, memory power draw depends size memory available. usage factor corrects real core usage (default 1, .e. full usage). PUE (Power Usage Effectiveness) measures much extra energy needed operate data centre (cooling, lighting etc.). PSF (Pragmatic Scaling Factor) used take account multiple identical runs (e.g. testing optimisation). Carbon Intensity depends location technologies used produce electricity.","code":"carbon footprint = energy needed * carbon intensity runtime * (power draw for cores * usage + power draw for memory) * PUE * PSF"},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"basic-use","dir":"","previous_headings":"","what":"Basic use","title":"Compute ecological footprint in R","text":"","code":"devtools::load_all() library(\"greenAlgoR\")"},{"path":[]},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"using-explicit-input","dir":"","previous_headings":"Basic use > In classical workflow","what":"Using explicit input","title":"Compute ecological footprint in R","text":"","code":"# Your model must match exactly a name in TDP_cpu_internal$model fp_12h <- ga_footprint(runtime_h = 12, cpu_model = \"Core i3-10300\") fp_12h$carbon_footprint_total_gCO2 #> [1] 829.0232 fp_12h$energy_needed_kWh #> [1] 1.745312 ggplot(fp_12h$ref_value, aes( y = variable, x = as.numeric(value), fill = log10(prop_footprint) )) + geom_col() + geom_col( data = data.frame( variable = \"Total\", value = fp_12h$carbon_footprint_total_gCO2 ), fill = \"grey30\" ) + geom_col( data = data.frame( variable = \"Cores\", value = fp_12h$carbon_footprint_cores ), fill = \"darkred\" ) + geom_col( data = data.frame( variable = \"Memory\", value = fp_12h$carbon_footprint_memory ), fill = \"orange\" ) + scale_x_continuous( trans = \"log1p\", breaks = c(0, 10^c(1:max(log1p(as.numeric(fp_12h$ref_value$value))))) ) + geom_vline( xintercept = fp_12h$carbon_footprint_total_gCO2, col = \"grey30\", lwd = 1.2 ) + geom_label( aes(label = round_conditionaly(prop_footprint)), fill = \"grey90\", position = position_stack(vjust = 1.1) ) + labs( title = \"Carbon footprint of the analysis\", subtitle = paste0(\"(\", fp_12h$carbon_footprint_total_gCO2, \" g CO2\", \")\"), caption = \"Please cite Lannelongue et al. 2021 (10.1002/advs.202100707)\" ) + xlab(\"Carbon footprint (g CO2) in log10\") + ylab(\"Modality\") + theme(legend.position = \"none\")"},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"based-on-the-r-session","dir":"","previous_headings":"Basic use > In classical workflow","what":"Based on the R session","title":"Compute ecological footprint in R","text":"","code":"fp_session <- ga_footprint(runtime_h = \"session\", add_storage_estimation = TRUE) fp_session$carbon_footprint_total_gCO2 #> user.self #> 0.01989738 fp_session$energy_needed_kWh #> user.self #> 4.188922e-05"},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"based-on-a-targets-pipeline","dir":"","previous_headings":"Basic use","what":"Based on a targets pipeline","title":"Compute ecological footprint in R","text":"","code":"ga_targets()"},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"roadmap","dir":"","previous_headings":"","what":"Roadmap","title":"Compute ecological footprint in R","text":"Automatically find cpu model using benchmarkme::get_cpu() Submit CRAN?","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/csv_from_url_ga.html","id":null,"dir":"Reference","previous_headings":"","what":"Load csv files from green algo github repositories — csv_from_url_ga","title":"Load csv files from green algo github repositories — csv_from_url_ga","text":"Mainly internal use","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/csv_from_url_ga.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load csv files from green algo github repositories — csv_from_url_ga","text":"","code":"csv_from_url_ga(url, remove_first_line = TRUE)"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/csv_from_url_ga.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load csv files from green algo github repositories — csv_from_url_ga","text":"url url raw csv file remove_first_line (logical, default TRUE): remove first line csv file.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/csv_from_url_ga.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Load csv files from green algo github repositories — csv_from_url_ga","text":"data.frame","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/csv_from_url_ga.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Load csv files from green algo github repositories — csv_from_url_ga","text":"Adrien Taudière","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/csv_from_url_ga.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Load csv files from green algo github repositories — csv_from_url_ga","text":"","code":"carbon_intensity_internal <- csv_from_url_ga(\"https://raw.githubusercontent.com/GreenAlgorithms/green-algorithms-tool/refs/heads/master/data/v2.2/CI_aggregated.csv\")"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_footprint.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm — ga_footprint","title":"Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm — ga_footprint","text":"Please cite Lannelongue, L., Grealey, J., Inouye, M., Green Algorithms: Quantifying Carbon Footprint Computation. Adv. Sci. 2021, 2100707. https://doi.org/10.1002/advs.202100707 Default value https://github.com/GreenAlgorithms/green-algorithms-tool: PUE: https://github.com/GreenAlgorithms/green-algorithms-tool/blob/master/data/v2.2/defaults_PUE.csv TDP_per_core: https://raw.githubusercontent.com/GreenAlgorithms/green-algorithms-tool/refs/heads/master/data/v2.2/TDP_cpu.csv power_draw_per_gb: https://onlinelibrary.wiley.com/doi/10.1002/advs.202100707 Description algorithm green-algorithms website: \"\"\" carbon footprint calculated estimating energy draw algorithm carbon intensity producing energy given location: $$carbon footprint = energy needed * carbon intensity$$ energy needed : $$runtime * (power draw cores * usage + power draw memory) * PUE * PSF$$ power draw computing cores depends model number cores, memory power draw depends size memory available. usage factor corrects real core usage (default 1, .e. full usage). PUE (Power Usage Effectiveness) measures much extra energy needed operate data centre (cooling, lighting etc.). PSF (Pragmatic Scaling Factor) used take account multiple identical runs (e.g. testing optimisation). Carbon Intensity depends location technologies used produce electricity. note \"energy needed\" [...] independent location. \"\"\"","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_footprint.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm — ga_footprint","text":"","code":"ga_footprint( runtime_h = NULL, location_code = \"WORLD\", PUE = 1.67, TDP_per_core = 12, n_cores = 1, cpu_model = \"Any\", memory_ram = NULL, power_draw_per_gb = 0.3725, PSF = 1, usage_core = 1, add_ref_values = TRUE, add_storage_estimation = FALSE, mass_storage = NULL, carbon_intensity = NULL, TDP_cpu = NULL, ref_value = NULL )"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_footprint.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm — ga_footprint","text":"runtime_h Run time hours (int). runtime_h == \"session\", runtime compute using actual R session location_code (character list country region available ) PUE (int) Power usage effectiveness server. See https://github.com/GreenAlgorithms/green-algorithms-tool/blob/master/data/v2.2/defaults_PUE.csv example values. using personal computer, set PUE 1. TDP_per_core (int. Watt, default 12). Find cpu TDP nb cpu https://www.techpowerup.com/cpu-specs/ http://calculator.green-algorithms.org/ available. Owerwrite cpu_model param. n_cores (int, default 1) Number cores. Owerwrite cpu_model param. cpu_model Must present list http://calculator.green-algorithms.org/. CPU set, parameter TPD_per_core n_cores overwriting info cpu_model. \"auto\" modality (find cpu using benchmarkme::get_cpu()$model_name) running moment. memory_ram (int. GB) memory RAM. memory_ram NULL, use benchmarkme::get_ram() get RAM. power_draw_per_gb (int. Watt, default 0.3725) power draw GB RAM PSF (int, default 1) Pragmatic Scaling Factor. Citation Lannelongue et al. 2021: \"Many analyses presented single run particular algorithm software tool; however, computations rarely performed . Algorithms run multiple times, sometimes hundreds, systematically manually, different parameterizations. Statistical models may include number combinations covariates, fitting procedures, etc. important include repeats carbon footprint. take account number times computation performed practice, PSF defined, scaling factor estimated GHG emissions multiplied.\" usage_core (int, default 1). usage factor corrects real core usage (default 1, .e. full usage). add_ref_values (logical, default TRUE) compute return reference values compare footprint ? add_storage_estimation (logical, default FALSE) compute footprint mass storage ? default FALSE far less important cpu memory usage. Note green-algorithms website compute mass storage usage. mass_storage (int. GB, default NULL) size mass_storage. used add_storage_estimation set TRUE. set NULL, use base::gc() function estimate storage used. carbon_intensity (default NULL). Advanced users . dataframe location carbonIntensity columns. Set carbon_intensity_internal NULL. carbon_intensity_internal set using command line csv_from_url_ga(\"https://raw.githubusercontent.com/GreenAlgorithms/ green-algorithms-tool/refs/heads/master/data/v2.2/CI_aggregated.csv\") TDP_cpu (default NULL). Advanced users . dataframe model, n_cores TDP_per_core columns. Set TDP_cpu_internal NULL. TDP_cpu_internal set using command line csv_from_url_ga(\"https://raw.githubusercontent.com/GreenAlgorithms/ green-algorithms-tool/refs/heads/master/data/v2.2/TDP_cpu.csv\") ref_value (default NULL). Advanced users . dataframe variable value columns. Set ref_value_internal NULL. ref_value_internal set using command line csv_from_url_ga(\"https://raw.githubusercontent.com/GreenAlgorithms/ green-algorithms-tool/refs/heads/master/data/v2.2/referenceValues.csv\")","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_footprint.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm — ga_footprint","text":"list values runtime_h: input run time hours location_code: input location code TDP_per_core: input TDP_per_core (cpu_model set, correspond TDP_per_core cpu) n_cores: input n_cores (cpu_model set, correspond n_cores cpu) cpu_model: input cpu model. set \"\", TDP_per_core ncore used memory_ram: input memory ram GB power_draw_per_gb: input power draw per GB usage_core: input usage core carbon_intensity: input carbon intensity (depend location code) PUE: input PUE PSF: input PUE power_draw_for_cores_kWh: output power draw cores kWh power_draw_for_memory_kWh: output power draw RAM memory kWh energy_needed_kWh: output energy needed kWh carbon_footprint_cores: output carbon footprint grams CO2 cores usage carbon_footprint_memory: output carbon footprint grams CO2 memory usage carbon_footprint_total_gCO2: total output carbon footprint grams CO2 ref_value: (optionnal, return add_ref_values TRUE) : dataframe power_draw_storage_kWh: (optionnal, return add_storage_estimation TRUE) output power draw mass storage kWh","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_footprint.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm — ga_footprint","text":"Adrien Taudière","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_footprint.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm — ga_footprint","text":"","code":"ga_footprint( runtime_h = 12, n_cores = 6, TDP_per_core = 15.8, location_code = \"FR\", PUE = 1, cpu_model = \"Core i5-9600KF\" ) #> $runtime_h #> [1] 12 #> #> $location_code #> [1] \"FR\" #> #> $TDP_per_core #> [1] 15.8 #> #> $n_cores #> [1] 6 #> #> $cpu_model #> [1] \"Core i5-9600KF\" #> #> $memory_ram #> [1] 16.75734 #> #> $power_draw_per_gb #> [1] 0.3725 #> #> $`usage core` #> [1] 1 #> #> $carbon_intensity #> [1] 51.28 #> #> $PUE #> [1] 1 #> #> $PSF #> [1] 1 #> #> $power_draw_for_cores_kWh #> [1] 1.1376 #> #> $power_draw_for_memory_kWh #> [1] 0.0749053 #> #> $energy_needed_kWh #> [1] 1.212505 #> #> $carbon_footprint_cores #> [1] 58.33613 #> #> $carbon_footprint_memory #> [1] 3.841144 #> #> $carbon_footprint_total_gCO2 #> [1] 62.17727 #> #> $ref_value #> variable value #> 1 Total 62.1772718537736 #> 2 Cores 1.1376 #> 3 Memory 0.07490530136064 #> 4 memoryPower 0.3725 #> 5 google_search 10 #> 6 streaming_netflix_perhour 36 #> 7 train_perkm 41 #> 8 flight_economy_perkm 171 #> 9 passengerCar_EU_perkm 175 #> 10 passengerCar_US_perkm 251 #> 11 tree_month 917 #> 12 treeYear 11000 #> 13 flight_PAR-LON 50000 #> 14 flight_NY-SF 570000 #> 15 flight_NYC-MEL 2310000 #> source #> 1 #> 2 #> 3 #> 4 in W/GB from http://dl.acm.org/citation.cfm?doid=3076113.3076117 and https://www.tomshardware.com/uk/reviews/intel-core-i7-5960x-haswell-e-cpu,3918-13.html #> 5 gCO2 from http://www.janavirgin.com/CO2/CO2GLE_about.html #> 6 gCO2 from https://www.carbonbrief.org/factcheck-what-is-the-carbon-footprint-of-streaming-video-on-netflix (update) #> 7 in gCO2/km, but more like 5-37g, from https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2020 #> 8 in gCO2/km, but more like 139-244g, from https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2020 #> 9 in gCO2/km from http://www.sciencedirect.com/science/article/pii/S1352231018307295 and https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2019 #> 10 in gCO2/km from https://www.epa.gov/greenvehicles/greenhouse-gas-emissions-typical-passenger-vehicle #> 11 gCO2 same source as treeYear #> 12 in gCO2/tree/year from http://www.sciencedirect.com/science/article/pii/S0269749101002640 #> 13 gCO2e from https://calculator.carbonfootprint.com/calculator.aspx?tab=3 #> 14 gCO2e from https://calculator.carbonfootprint.com/calculator.aspx?tab=3 #> 15 gCO2e from https://calculator.carbonfootprint.com/calculator.aspx?tab=3 #> prop_footprint #> 1 1.000000e+00 #> 2 1.829607e-02 #> 3 1.204705e-03 #> 4 5.990935e-03 #> 5 1.608305e-01 #> 6 5.789897e-01 #> 7 6.594049e-01 #> 8 2.750201e+00 #> 9 2.814533e+00 #> 10 4.036845e+00 #> 11 1.474815e+01 #> 12 1.769135e+02 #> 13 8.041524e+02 #> 14 9.167337e+03 #> 15 3.715184e+04 #> ga_footprint( runtime_h = \"session\", PUE = 1, ) #> $runtime_h #> user.self #> 0.001775833 #> #> $location_code #> [1] \"WORLD\" #> #> $TDP_per_core #> [1] 12 #> #> $n_cores #> [1] 1 #> #> $cpu_model #> [1] \"Any\" #> #> $memory_ram #> [1] 16.75734 #> #> $power_draw_per_gb #> [1] 0.3725 #> #> $`usage core` #> [1] 1 #> #> $carbon_intensity #> [1] 475 #> #> $PUE #> [1] 1 #> #> $PSF #> [1] 1 #> #> $power_draw_for_cores_kWh #> user.self #> 2.131e-05 #> #> $power_draw_for_memory_kWh #> user.self #> 1.108494e-05 #> #> $energy_needed_kWh #> user.self #> 3.239494e-05 #> #> $carbon_footprint_cores #> user.self #> 0.01012225 #> #> $carbon_footprint_memory #> user.self #> 0.005265349 #> #> $carbon_footprint_total_gCO2 #> user.self #> 0.0153876 #> #> $ref_value #> variable value #> 1 Total 0.0153875985187343 #> 2 Cores 2.131e-05 #> 3 Memory 1.10849442499669e-05 #> 4 memoryPower 0.3725 #> 5 google_search 10 #> 6 streaming_netflix_perhour 36 #> 7 train_perkm 41 #> 8 flight_economy_perkm 171 #> 9 passengerCar_EU_perkm 175 #> 10 passengerCar_US_perkm 251 #> 11 tree_month 917 #> 12 treeYear 11000 #> 13 flight_PAR-LON 50000 #> 14 flight_NY-SF 570000 #> 15 flight_NYC-MEL 2310000 #> source #> 1 #> 2 #> 3 #> 4 in W/GB from http://dl.acm.org/citation.cfm?doid=3076113.3076117 and https://www.tomshardware.com/uk/reviews/intel-core-i7-5960x-haswell-e-cpu,3918-13.html #> 5 gCO2 from http://www.janavirgin.com/CO2/CO2GLE_about.html #> 6 gCO2 from https://www.carbonbrief.org/factcheck-what-is-the-carbon-footprint-of-streaming-video-on-netflix (update) #> 7 in gCO2/km, but more like 5-37g, from https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2020 #> 8 in gCO2/km, but more like 139-244g, from https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2020 #> 9 in gCO2/km from http://www.sciencedirect.com/science/article/pii/S1352231018307295 and https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2019 #> 10 in gCO2/km from https://www.epa.gov/greenvehicles/greenhouse-gas-emissions-typical-passenger-vehicle #> 11 gCO2 same source as treeYear #> 12 in gCO2/tree/year from http://www.sciencedirect.com/science/article/pii/S0269749101002640 #> 13 gCO2e from https://calculator.carbonfootprint.com/calculator.aspx?tab=3 #> 14 gCO2e from https://calculator.carbonfootprint.com/calculator.aspx?tab=3 #> 15 gCO2e from https://calculator.carbonfootprint.com/calculator.aspx?tab=3 #> prop_footprint #> 1 1.000000e+00 #> 2 1.384881e-03 #> 3 7.203817e-04 #> 4 2.420781e+01 #> 5 6.498740e+02 #> 6 2.339546e+03 #> 7 2.664483e+03 #> 8 1.111285e+04 #> 9 1.137279e+04 #> 10 1.631184e+04 #> 11 5.959344e+04 #> 12 7.148614e+05 #> 13 3.249370e+06 #> 14 3.704282e+07 #> 15 1.501209e+08 #> res_ga <- ga_footprint( runtime_h = 12, n_cores = 6, memory_ram = 64, PUE = 1, add_storage_estimation = TRUE, mass_storage = 1 ) ggplot(res_ga$ref_value, aes(y = variable, x = as.numeric(value), fill = log10(prop_footprint))) + geom_col() + geom_col(data = data.frame( variable = \"Total\", value = res_ga$carbon_footprint_total_gCO2 ), fill = \"grey30\") + geom_col(data = data.frame( variable = \"Cores\", value = res_ga$carbon_footprint_cores ), fill = \"darkred\") + geom_col(data = data.frame( variable = \"Memory\", value = res_ga$carbon_footprint_memory ), fill = \"orange\") + geom_col(data = data.frame( variable = \"Mass storage\", value = res_ga$carbon_footprint_storage ), fill = \"violet\") + scale_x_continuous( trans = \"log1p\", breaks = c(0, 10^c(1:max(log1p(as.numeric(res_ga$ref_value$value))))) ) + geom_vline( xintercept = res_ga$carbon_footprint_total_gCO2, col = \"grey30\", lwd = 1.2 ) + geom_label(aes(label = round_conditionaly(prop_footprint)), fill = \"grey90\", position = position_stack(vjust = 1.1) ) + labs( title = \"Carbon footprint of the analysis\", subtitle = paste0( \"(\", res_ga$carbon_footprint_total_gCO2, \" g CO2\", \")\" ), caption = \"Please cite Lannelongue et al. 2021 (10.1002/advs.202100707)\" ) + xlab(\"Carbon footprint (g CO2) in log10\") + ylab(\"Modality\") + theme(legend.position = \"none\")"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_targets.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute footprint in grams of CO2 for {targets} pipelines — ga_targets","title":"Compute footprint in grams of CO2 for {targets} pipelines — ga_targets","text":"mainly wrapper function ga_footprint() compute run time mass_storage (used add_storage_estimation = TRUE) using targets::tar_meta().","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_targets.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute footprint in grams of CO2 for {targets} pipelines — ga_targets","text":"","code":"ga_targets( names = NULL, fields = NULL, targets_only = TRUE, complete_only = FALSE, store = targets::tar_config_get(\"store\"), tar_meta_raw = NULL, ... )"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_targets.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute footprint in grams of CO2 for {targets} pipelines — ga_targets","text":"names Optional, names targets. See ?targets::tar_meta() fields Optional, names columns/fields select. See ?targets::tar_meta() targets_only Logical, whether just show information targets also return metadata functions global objects. complete_only Logical, whether return complete rows (NA values). store Character length 1, path targets data store. See ?targets::tar_meta() tar_meta_raw Optional, NULL, listed options (params targets::tar_meta() used. ... args passed ga_footprint()","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_targets.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute footprint in grams of CO2 for {targets} pipelines — ga_targets","text":"list value. See ?ga_footprint details.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_targets.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Compute footprint in grams of CO2 for {targets} pipelines — ga_targets","text":"Adrien Taudière","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_targets.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compute footprint in grams of CO2 for {targets} pipelines — ga_targets","text":"","code":"# In a targets folder, just run function ga_targets() # with the options you want # The next exemple emulate a mini-targets before to ask for tar_meta tar_dir({ # tar_dir() runs code from a temp dir for CRAN. tar_script( { list( tar_target( name = waiting, command = Sys.sleep(2), description = \"Sleep 2 seconds\" ), tar_target(x, writeLines( targets::tar_option_get(\"error\"), \"error.txt\" )) ) }, ask = FALSE ) tar_make() tm <- tar_meta() res_gat <- ga_targets( tar_meta_raw = tm, n_cores = 6, TDP_per_core = 15.8, location_code = \"FR\", PUE = 2, add_storage_estimation = TRUE ) ggplot(res_gat$ref_value, aes( y = reorder(variable, as.numeric(value)), x = as.numeric(value), fill = log10(prop_footprint) )) + geom_col() + geom_col(data = data.frame( variable = \"Total \", value = res_gat$carbon_footprint_total_gCO2 ), fill = \"grey30\") + geom_col( data = data.frame( variable = \"Cores\", value = res_gat$carbon_intensity * res_gat$power_draw_for_cores_kWh ), fill = \"darkred\" ) + geom_col( data = data.frame( variable = \"Memory\", value = res_gat$carbon_intensity * res_gat$power_draw_for_memory_kWh ), fill = \"orange\" ) + geom_col( data = data.frame( variable = \"Storage\", value = res_gat$carbon_intensity * res_gat$power_draw_per_gb ), fill = \"violet\" ) + scale_x_continuous(trans = \"log1p\") + geom_vline( xintercept = res_gat$carbon_footprint_total_gCO2, col = \"grey30\", lwd = 1.2 ) + geom_label(aes(label = round(prop_footprint, 1)), fill = \"grey90\") + xlab(\"g CO^2\") + ylab(\"Modality\") }) #> ▶ dispatched target x #> ● completed target x [0 seconds, 44 bytes] #> ▶ dispatched target waiting #> ● completed target waiting [2.002 seconds, 44 bytes] #> ▶ ended pipeline [2.064 seconds] #>"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/greenAlgoR-package.html","id":null,"dir":"Reference","previous_headings":"","what":"greenAlgoR package — greenAlgoR-package","title":"greenAlgoR package — greenAlgoR-package","text":"package computes ecological footprint R (based green-algorithms. greenAlgoR also made simple compute ecological footprint targets pipelines..","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/round_conditionaly.html","id":null,"dir":"Reference","previous_headings":"","what":"Round numeric vector conditionaly — round_conditionaly","title":"Round numeric vector conditionaly — round_conditionaly","text":"Round numeric vector conditionaly","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/round_conditionaly.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Round numeric vector conditionaly — round_conditionaly","text":"","code":"round_conditionaly( vec, cond = cbind(c(1e-05, 5), c(0.001, 3), c(0.01, 3), c(1, 2), c(10, 1), c(100, 0)) )"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/round_conditionaly.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Round numeric vector conditionaly — round_conditionaly","text":"vec numeric vector cond : matrix 2 row n column first row defining condition second row defining number round. cond order decreasing order 1 row internally. Thus order cond rows important","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/round_conditionaly.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Round numeric vector conditionaly — round_conditionaly","text":"numeric vector length vec","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/round_conditionaly.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Round numeric vector conditionaly — round_conditionaly","text":"Adrien Taudière","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/round_conditionaly.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Round numeric vector conditionaly — round_conditionaly","text":"","code":"round_conditionaly(vec = c(1000.27890, 10.87988, 1.769869, 0.99796, 0.000179)) #> [1] 1000.27890 10.87988 1.76987 0.99796 0.00018 round_conditionaly( vec = c(1000.27890, 0.000179, 10e-11), cond = cbind(c(10e-5, 5), c(10, 2)) ) #> [1] 1.000279e+03 1.800000e-04 1.000000e-10"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/session_runtime.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute session run time and mass storage use (based on gc()) — session_runtime","title":"Compute session run time and mass storage use (based on gc()) — session_runtime","text":"Compute cpu times using base::proc.time() mass storage using base::gc()","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/session_runtime.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute session run time and mass storage use (based on gc()) — session_runtime","text":"","code":"session_runtime(compute_mass_storage = TRUE)"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/session_runtime.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute session run time and mass storage use (based on gc()) — session_runtime","text":"compute_mass_storage (logical, default TRUE) mass storage computed base::gc() function","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/session_runtime.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute session run time and mass storage use (based on gc()) — session_runtime","text":"list values","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/session_runtime.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Compute session run time and mass storage use (based on gc()) — session_runtime","text":"Adrien Taudière","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/session_runtime.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compute session run time and mass storage use (based on gc()) — session_runtime","text":"","code":"session_runtime() #> $cpu_times_users #> user.self #> 7.666 #> #> $cpu_times_system #> user.child #> 1.929 #> #> $time_elapsed #> elapsed #> 13.789 #> #> $cpu_times #> user.self #> 9.595 #> #> $mass_storage_used #> [1] 236 #> #> $mass_storage_max #> [1] 357.8 #> session_runtime(compute_mass_storage = FALSE) #> $cpu_times_users #> user.self #> 8.122 #> #> $cpu_times_system #> user.child #> 1.929 #> #> $time_elapsed #> elapsed #> 14.245 #> #> $cpu_times #> user.self #> 10.051 #>"},{"path":"https://adrientaudiere.github.io/greenAlgoR/news/index.html","id":"greenalgor-01","dir":"Changelog","previous_headings":"","what":"greenAlgoR 0.1","title":"greenAlgoR 0.1","text":"Initial github submission. Creation function ga_footprint() ga_targets()","code":""}] +[{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"GNU General Public License","title":"GNU General Public License","text":"Version 3, 29 June 2007Copyright © 2007 Free Software Foundation, Inc.  Everyone permitted copy distribute verbatim copies license document, changing allowed.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"preamble","dir":"","previous_headings":"","what":"Preamble","title":"GNU General Public License","text":"GNU General Public License free, copyleft license software kinds works. licenses software practical works designed take away freedom share change works. contrast, GNU General Public License intended guarantee freedom share change versions program–make sure remains free software users. , Free Software Foundation, use GNU General Public License software; applies also work released way authors. can apply programs, . speak free software, referring freedom, price. General Public Licenses designed make sure freedom distribute copies free software (charge wish), receive source code can get want , can change software use pieces new free programs, know can things. protect rights, need prevent others denying rights asking surrender rights. Therefore, certain responsibilities distribute copies software, modify : responsibilities respect freedom others. example, distribute copies program, whether gratis fee, must pass recipients freedoms received. must make sure , , receive can get source code. must show terms know rights. Developers use GNU GPL protect rights two steps: (1) assert copyright software, (2) offer License giving legal permission copy, distribute /modify . developers’ authors’ protection, GPL clearly explains warranty free software. users’ authors’ sake, GPL requires modified versions marked changed, problems attributed erroneously authors previous versions. devices designed deny users access install run modified versions software inside , although manufacturer can . fundamentally incompatible aim protecting users’ freedom change software. systematic pattern abuse occurs area products individuals use, precisely unacceptable. Therefore, designed version GPL prohibit practice products. problems arise substantially domains, stand ready extend provision domains future versions GPL, needed protect freedom users. Finally, every program threatened constantly software patents. States allow patents restrict development use software general-purpose computers, , wish avoid special danger patents applied free program make effectively proprietary. prevent , GPL assures patents used render program non-free. precise terms conditions copying, distribution modification follow.","code":""},{"path":[]},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_0-definitions","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"0. Definitions","title":"GNU General Public License","text":"“License” refers version 3 GNU General Public License. “Copyright” also means copyright-like laws apply kinds works, semiconductor masks. “Program” refers copyrightable work licensed License. licensee addressed “”. “Licensees” “recipients” may individuals organizations. “modify” work means copy adapt part work fashion requiring copyright permission, making exact copy. resulting work called “modified version” earlier work work “based ” earlier work. “covered work” means either unmodified Program work based Program. “propagate” work means anything , without permission, make directly secondarily liable infringement applicable copyright law, except executing computer modifying private copy. Propagation includes copying, distribution (without modification), making available public, countries activities well. “convey” work means kind propagation enables parties make receive copies. Mere interaction user computer network, transfer copy, conveying. interactive user interface displays “Appropriate Legal Notices” extent includes convenient prominently visible feature (1) displays appropriate copyright notice, (2) tells user warranty work (except extent warranties provided), licensees may convey work License, view copy License. interface presents list user commands options, menu, prominent item list meets criterion.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_1-source-code","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"1. Source Code","title":"GNU General Public License","text":"“source code” work means preferred form work making modifications . “Object code” means non-source form work. “Standard Interface” means interface either official standard defined recognized standards body, , case interfaces specified particular programming language, one widely used among developers working language. “System Libraries” executable work include anything, work whole, () included normal form packaging Major Component, part Major Component, (b) serves enable use work Major Component, implement Standard Interface implementation available public source code form. “Major Component”, context, means major essential component (kernel, window system, ) specific operating system () executable work runs, compiler used produce work, object code interpreter used run . “Corresponding Source” work object code form means source code needed generate, install, (executable work) run object code modify work, including scripts control activities. However, include work’s System Libraries, general-purpose tools generally available free programs used unmodified performing activities part work. example, Corresponding Source includes interface definition files associated source files work, source code shared libraries dynamically linked subprograms work specifically designed require, intimate data communication control flow subprograms parts work. Corresponding Source need include anything users can regenerate automatically parts Corresponding Source. Corresponding Source work source code form work.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_2-basic-permissions","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"2. Basic Permissions","title":"GNU General Public License","text":"rights granted License granted term copyright Program, irrevocable provided stated conditions met. License explicitly affirms unlimited permission run unmodified Program. output running covered work covered License output, given content, constitutes covered work. License acknowledges rights fair use equivalent, provided copyright law. may make, run propagate covered works convey, without conditions long license otherwise remains force. may convey covered works others sole purpose make modifications exclusively , provide facilities running works, provided comply terms License conveying material control copyright. thus making running covered works must exclusively behalf, direction control, terms prohibit making copies copyrighted material outside relationship . Conveying circumstances permitted solely conditions stated . Sublicensing allowed; section 10 makes unnecessary.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_3-protecting-users-legal-rights-from-anti-circumvention-law","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"3. Protecting Users’ Legal Rights From Anti-Circumvention Law","title":"GNU General Public License","text":"covered work shall deemed part effective technological measure applicable law fulfilling obligations article 11 WIPO copyright treaty adopted 20 December 1996, similar laws prohibiting restricting circumvention measures. convey covered work, waive legal power forbid circumvention technological measures extent circumvention effected exercising rights License respect covered work, disclaim intention limit operation modification work means enforcing, work’s users, third parties’ legal rights forbid circumvention technological measures.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_4-conveying-verbatim-copies","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"4. Conveying Verbatim Copies","title":"GNU General Public License","text":"may convey verbatim copies Program’s source code receive , medium, provided conspicuously appropriately publish copy appropriate copyright notice; keep intact notices stating License non-permissive terms added accord section 7 apply code; keep intact notices absence warranty; give recipients copy License along Program. may charge price price copy convey, may offer support warranty protection fee.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_5-conveying-modified-source-versions","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"5. Conveying Modified Source Versions","title":"GNU General Public License","text":"may convey work based Program, modifications produce Program, form source code terms section 4, provided also meet conditions: ) work must carry prominent notices stating modified , giving relevant date. b) work must carry prominent notices stating released License conditions added section 7. requirement modifies requirement section 4 “keep intact notices”. c) must license entire work, whole, License anyone comes possession copy. License therefore apply, along applicable section 7 additional terms, whole work, parts, regardless packaged. License gives permission license work way, invalidate permission separately received . d) work interactive user interfaces, must display Appropriate Legal Notices; however, Program interactive interfaces display Appropriate Legal Notices, work need make . compilation covered work separate independent works, nature extensions covered work, combined form larger program, volume storage distribution medium, called “aggregate” compilation resulting copyright used limit access legal rights compilation’s users beyond individual works permit. Inclusion covered work aggregate cause License apply parts aggregate.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_6-conveying-non-source-forms","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"6. Conveying Non-Source Forms","title":"GNU General Public License","text":"may convey covered work object code form terms sections 4 5, provided also convey machine-readable Corresponding Source terms License, one ways: ) Convey object code , embodied , physical product (including physical distribution medium), accompanied Corresponding Source fixed durable physical medium customarily used software interchange. b) Convey object code , embodied , physical product (including physical distribution medium), accompanied written offer, valid least three years valid long offer spare parts customer support product model, give anyone possesses object code either (1) copy Corresponding Source software product covered License, durable physical medium customarily used software interchange, price reasonable cost physically performing conveying source, (2) access copy Corresponding Source network server charge. c) Convey individual copies object code copy written offer provide Corresponding Source. alternative allowed occasionally noncommercially, received object code offer, accord subsection 6b. d) Convey object code offering access designated place (gratis charge), offer equivalent access Corresponding Source way place charge. need require recipients copy Corresponding Source along object code. place copy object code network server, Corresponding Source may different server (operated third party) supports equivalent copying facilities, provided maintain clear directions next object code saying find Corresponding Source. Regardless server hosts Corresponding Source, remain obligated ensure available long needed satisfy requirements. e) Convey object code using peer--peer transmission, provided inform peers object code Corresponding Source work offered general public charge subsection 6d. separable portion object code, whose source code excluded Corresponding Source System Library, need included conveying object code work. “User Product” either (1) “consumer product”, means tangible personal property normally used personal, family, household purposes, (2) anything designed sold incorporation dwelling. determining whether product consumer product, doubtful cases shall resolved favor coverage. particular product received particular user, “normally used” refers typical common use class product, regardless status particular user way particular user actually uses, expects expected use, product. product consumer product regardless whether product substantial commercial, industrial non-consumer uses, unless uses represent significant mode use product. “Installation Information” User Product means methods, procedures, authorization keys, information required install execute modified versions covered work User Product modified version Corresponding Source. information must suffice ensure continued functioning modified object code case prevented interfered solely modification made. convey object code work section , , specifically use , User Product, conveying occurs part transaction right possession use User Product transferred recipient perpetuity fixed term (regardless transaction characterized), Corresponding Source conveyed section must accompanied Installation Information. requirement apply neither third party retains ability install modified object code User Product (example, work installed ROM). requirement provide Installation Information include requirement continue provide support service, warranty, updates work modified installed recipient, User Product modified installed. Access network may denied modification materially adversely affects operation network violates rules protocols communication across network. Corresponding Source conveyed, Installation Information provided, accord section must format publicly documented (implementation available public source code form), must require special password key unpacking, reading copying.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_7-additional-terms","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"7. Additional Terms","title":"GNU General Public License","text":"“Additional permissions” terms supplement terms License making exceptions one conditions. Additional permissions applicable entire Program shall treated though included License, extent valid applicable law. additional permissions apply part Program, part may used separately permissions, entire Program remains governed License without regard additional permissions. convey copy covered work, may option remove additional permissions copy, part . (Additional permissions may written require removal certain cases modify work.) may place additional permissions material, added covered work, can give appropriate copyright permission. Notwithstanding provision License, material add covered work, may (authorized copyright holders material) supplement terms License terms: ) Disclaiming warranty limiting liability differently terms sections 15 16 License; b) Requiring preservation specified reasonable legal notices author attributions material Appropriate Legal Notices displayed works containing ; c) Prohibiting misrepresentation origin material, requiring modified versions material marked reasonable ways different original version; d) Limiting use publicity purposes names licensors authors material; e) Declining grant rights trademark law use trade names, trademarks, service marks; f) Requiring indemnification licensors authors material anyone conveys material (modified versions ) contractual assumptions liability recipient, liability contractual assumptions directly impose licensors authors. non-permissive additional terms considered “restrictions” within meaning section 10. Program received , part , contains notice stating governed License along term restriction, may remove term. license document contains restriction permits relicensing conveying License, may add covered work material governed terms license document, provided restriction survive relicensing conveying. add terms covered work accord section, must place, relevant source files, statement additional terms apply files, notice indicating find applicable terms. Additional terms, permissive non-permissive, may stated form separately written license, stated exceptions; requirements apply either way.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_8-termination","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"8. Termination","title":"GNU General Public License","text":"may propagate modify covered work except expressly provided License. attempt otherwise propagate modify void, automatically terminate rights License (including patent licenses granted third paragraph section 11). However, cease violation License, license particular copyright holder reinstated () provisionally, unless copyright holder explicitly finally terminates license, (b) permanently, copyright holder fails notify violation reasonable means prior 60 days cessation. Moreover, license particular copyright holder reinstated permanently copyright holder notifies violation reasonable means, first time received notice violation License (work) copyright holder, cure violation prior 30 days receipt notice. Termination rights section terminate licenses parties received copies rights License. rights terminated permanently reinstated, qualify receive new licenses material section 10.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_9-acceptance-not-required-for-having-copies","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"9. Acceptance Not Required for Having Copies","title":"GNU General Public License","text":"required accept License order receive run copy Program. Ancillary propagation covered work occurring solely consequence using peer--peer transmission receive copy likewise require acceptance. However, nothing License grants permission propagate modify covered work. actions infringe copyright accept License. Therefore, modifying propagating covered work, indicate acceptance License .","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_10-automatic-licensing-of-downstream-recipients","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"10. Automatic Licensing of Downstream Recipients","title":"GNU General Public License","text":"time convey covered work, recipient automatically receives license original licensors, run, modify propagate work, subject License. responsible enforcing compliance third parties License. “entity transaction” transaction transferring control organization, substantially assets one, subdividing organization, merging organizations. propagation covered work results entity transaction, party transaction receives copy work also receives whatever licenses work party’s predecessor interest give previous paragraph, plus right possession Corresponding Source work predecessor interest, predecessor can get reasonable efforts. may impose restrictions exercise rights granted affirmed License. example, may impose license fee, royalty, charge exercise rights granted License, may initiate litigation (including cross-claim counterclaim lawsuit) alleging patent claim infringed making, using, selling, offering sale, importing Program portion .","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_11-patents","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"11. Patents","title":"GNU General Public License","text":"“contributor” copyright holder authorizes use License Program work Program based. work thus licensed called contributor’s “contributor version”. contributor’s “essential patent claims” patent claims owned controlled contributor, whether already acquired hereafter acquired, infringed manner, permitted License, making, using, selling contributor version, include claims infringed consequence modification contributor version. purposes definition, “control” includes right grant patent sublicenses manner consistent requirements License. contributor grants non-exclusive, worldwide, royalty-free patent license contributor’s essential patent claims, make, use, sell, offer sale, import otherwise run, modify propagate contents contributor version. following three paragraphs, “patent license” express agreement commitment, however denominated, enforce patent (express permission practice patent covenant sue patent infringement). “grant” patent license party means make agreement commitment enforce patent party. convey covered work, knowingly relying patent license, Corresponding Source work available anyone copy, free charge terms License, publicly available network server readily accessible means, must either (1) cause Corresponding Source available, (2) arrange deprive benefit patent license particular work, (3) arrange, manner consistent requirements License, extend patent license downstream recipients. “Knowingly relying” means actual knowledge , patent license, conveying covered work country, recipient’s use covered work country, infringe one identifiable patents country reason believe valid. , pursuant connection single transaction arrangement, convey, propagate procuring conveyance , covered work, grant patent license parties receiving covered work authorizing use, propagate, modify convey specific copy covered work, patent license grant automatically extended recipients covered work works based . patent license “discriminatory” include within scope coverage, prohibits exercise , conditioned non-exercise one rights specifically granted License. may convey covered work party arrangement third party business distributing software, make payment third party based extent activity conveying work, third party grants, parties receive covered work , discriminatory patent license () connection copies covered work conveyed (copies made copies), (b) primarily connection specific products compilations contain covered work, unless entered arrangement, patent license granted, prior 28 March 2007. Nothing License shall construed excluding limiting implied license defenses infringement may otherwise available applicable patent law.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_12-no-surrender-of-others-freedom","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"12. No Surrender of Others’ Freedom","title":"GNU General Public License","text":"conditions imposed (whether court order, agreement otherwise) contradict conditions License, excuse conditions License. convey covered work satisfy simultaneously obligations License pertinent obligations, consequence may convey . example, agree terms obligate collect royalty conveying convey Program, way satisfy terms License refrain entirely conveying Program.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_13-use-with-the-gnu-affero-general-public-license","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"13. Use with the GNU Affero General Public License","title":"GNU General Public License","text":"Notwithstanding provision License, permission link combine covered work work licensed version 3 GNU Affero General Public License single combined work, convey resulting work. terms License continue apply part covered work, special requirements GNU Affero General Public License, section 13, concerning interaction network apply combination .","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_14-revised-versions-of-this-license","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"14. Revised Versions of this License","title":"GNU General Public License","text":"Free Software Foundation may publish revised /new versions GNU General Public License time time. new versions similar spirit present version, may differ detail address new problems concerns. version given distinguishing version number. Program specifies certain numbered version GNU General Public License “later version” applies , option following terms conditions either numbered version later version published Free Software Foundation. Program specify version number GNU General Public License, may choose version ever published Free Software Foundation. Program specifies proxy can decide future versions GNU General Public License can used, proxy’s public statement acceptance version permanently authorizes choose version Program. Later license versions may give additional different permissions. However, additional obligations imposed author copyright holder result choosing follow later version.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_15-disclaimer-of-warranty","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"15. Disclaimer of Warranty","title":"GNU General Public License","text":"WARRANTY PROGRAM, EXTENT PERMITTED APPLICABLE LAW. EXCEPT OTHERWISE STATED WRITING COPYRIGHT HOLDERS /PARTIES PROVIDE PROGRAM “” WITHOUT WARRANTY KIND, EITHER EXPRESSED IMPLIED, INCLUDING, LIMITED , IMPLIED WARRANTIES MERCHANTABILITY FITNESS PARTICULAR PURPOSE. ENTIRE RISK QUALITY PERFORMANCE PROGRAM . PROGRAM PROVE DEFECTIVE, ASSUME COST NECESSARY SERVICING, REPAIR CORRECTION.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_16-limitation-of-liability","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"16. Limitation of Liability","title":"GNU General Public License","text":"EVENT UNLESS REQUIRED APPLICABLE LAW AGREED WRITING COPYRIGHT HOLDER, PARTY MODIFIES /CONVEYS PROGRAM PERMITTED , LIABLE DAMAGES, INCLUDING GENERAL, SPECIAL, INCIDENTAL CONSEQUENTIAL DAMAGES ARISING USE INABILITY USE PROGRAM (INCLUDING LIMITED LOSS DATA DATA RENDERED INACCURATE LOSSES SUSTAINED THIRD PARTIES FAILURE PROGRAM OPERATE PROGRAMS), EVEN HOLDER PARTY ADVISED POSSIBILITY DAMAGES.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"id_17-interpretation-of-sections-15-and-16","dir":"","previous_headings":"TERMS AND CONDITIONS","what":"17. Interpretation of Sections 15 and 16","title":"GNU General Public License","text":"disclaimer warranty limitation liability provided given local legal effect according terms, reviewing courts shall apply local law closely approximates absolute waiver civil liability connection Program, unless warranty assumption liability accompanies copy Program return fee. END TERMS CONDITIONS","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/LICENSE.html","id":"how-to-apply-these-terms-to-your-new-programs","dir":"","previous_headings":"","what":"How to Apply These Terms to Your New Programs","title":"GNU General Public License","text":"develop new program, want greatest possible use public, best way achieve make free software everyone can redistribute change terms. , attach following notices program. safest attach start source file effectively state exclusion warranty; file least “copyright” line pointer full notice found. Also add information contact electronic paper mail. program terminal interaction, make output short notice like starts interactive mode: hypothetical commands show w show c show appropriate parts General Public License. course, program’s commands might different; GUI interface, use “box”. also get employer (work programmer) school, , sign “copyright disclaimer” program, necessary. information , apply follow GNU GPL, see . GNU General Public License permit incorporating program proprietary programs. program subroutine library, may consider useful permit linking proprietary applications library. want , use GNU Lesser General Public License instead License. first, please read .","code":" Copyright (C) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type 'show w'. This is free software, and you are welcome to redistribute it under certain conditions; type 'show c' for details."},{"path":"https://adrientaudiere.github.io/greenAlgoR/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Adrien Taudière. Author, maintainer, copyright holder.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Taudière (2024). greenAlgoR: Compute ecological footprint R. R package version 0.1, https://adrientaudiere.github.io/greenAlgoR/, https://github.com/adrientaudiere/greenAlgoR.","code":"@Manual{, title = {greenAlgoR: Compute ecological footprint in R}, author = {Adrien Taudière}, year = {2024}, note = {R package version 0.1, https://adrientaudiere.github.io/greenAlgoR/}, url = {https://github.com/adrientaudiere/greenAlgoR}, }"},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"greenalgor","dir":"","previous_headings":"","what":"Compute ecological footprint in R","title":"Compute ecological footprint in R","text":"package computes ecological footprint R (based green-algorithms, Lannelongue, Grealey, Inouye (2021)). aim facilitate programmatic used green-algorithms using function ga_footprint(). Moreover, greenAlgoR made simple compute ecological footprint {targets} pipelines using function ga_targets(). beta-version. Please submit issues found problems want contribute.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Compute ecological footprint in R","text":"greenAlgoR available CRAN moment. can install stable development version GitHub :","code":"if (!require(\"devtools\", quietly = TRUE)) { install.packages(\"devtools\") } devtools::install_github(\"adrientaudiere/greenAlgoR\")"},{"path":[]},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"the-algorithm-from-lannelongue-grealey-and-inouye-2021","dir":"","previous_headings":"Scientific foundation","what":"The algorithm from Lannelongue, Grealey, and Inouye (2021)","title":"Compute ecological footprint in R","text":"can refer green-algorithms Lannelongue, Grealey, Inouye (2021) understand algorithm. short description green-algorithms carbon footprint calculated estimating energy draw algorithm carbon intensity producing energy given location: energy needed : power draw computing cores depends model number cores, memory power draw depends size memory available. usage factor corrects real core usage (default 1, .e. full usage). PUE (Power Usage Effectiveness) measures much extra energy needed operate data centre (cooling, lighting etc.). PSF (Pragmatic Scaling Factor) used take account multiple identical runs (e.g. testing optimisation). Carbon Intensity depends location technologies used produce electricity.","code":"carbon footprint = energy needed * carbon intensity runtime * (power draw for cores * usage + power draw for memory) * PUE * PSF"},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"basic-use","dir":"","previous_headings":"","what":"Basic use","title":"Compute ecological footprint in R","text":"","code":"devtools::load_all() library(\"greenAlgoR\")"},{"path":[]},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"using-explicit-input","dir":"","previous_headings":"Basic use > In classical workflow","what":"Using explicit input","title":"Compute ecological footprint in R","text":"","code":"# Your model must match exactly a name in TDP_cpu_internal$model fp_12h <- ga_footprint(runtime_h = 12, cpu_model = \"Core i3-10300\") fp_12h$carbon_footprint_total_gCO2 #> [1] 829.0232 fp_12h$energy_needed_kWh #> [1] 1.745312 ggplot(fp_12h$ref_value, aes( y = variable, x = as.numeric(value), fill = log10(prop_footprint) )) + geom_col() + geom_col( data = data.frame( variable = \"Total\", value = fp_12h$carbon_footprint_total_gCO2 ), fill = \"grey30\" ) + geom_col( data = data.frame( variable = \"Cores\", value = fp_12h$carbon_footprint_cores ), fill = \"darkred\" ) + geom_col( data = data.frame( variable = \"Memory\", value = fp_12h$carbon_footprint_memory ), fill = \"orange\" ) + scale_x_continuous( trans = \"log1p\", breaks = c(0, 10^c(1:max(log1p(as.numeric(fp_12h$ref_value$value))))) ) + geom_vline( xintercept = fp_12h$carbon_footprint_total_gCO2, col = \"grey30\", lwd = 1.2 ) + geom_label( aes(label = round_conditionaly(prop_footprint)), fill = \"grey90\", position = position_stack(vjust = 1.1) ) + labs( title = \"Carbon footprint of the analysis\", subtitle = paste0(\"(\", fp_12h$carbon_footprint_total_gCO2, \" g CO2\", \")\"), caption = \"Please cite Lannelongue et al. 2021 (10.1002/advs.202100707)\" ) + xlab(\"Carbon footprint (g CO2) in log10\") + ylab(\"Modality\") + theme(legend.position = \"none\")"},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"based-on-the-r-session","dir":"","previous_headings":"Basic use > In classical workflow","what":"Based on the R session","title":"Compute ecological footprint in R","text":"","code":"fp_session <- ga_footprint(runtime_h = \"session\", add_storage_estimation = TRUE) fp_session$carbon_footprint_total_gCO2 #> user.self #> 0.01989738 fp_session$energy_needed_kWh #> user.self #> 4.188922e-05"},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"based-on-a-targets-pipeline","dir":"","previous_headings":"Basic use","what":"Based on a targets pipeline","title":"Compute ecological footprint in R","text":"","code":"ga_targets()"},{"path":"https://adrientaudiere.github.io/greenAlgoR/index.html","id":"roadmap","dir":"","previous_headings":"","what":"Roadmap","title":"Compute ecological footprint in R","text":"Automatically find cpu model using benchmarkme::get_cpu() Submit CRAN?","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/csv_from_url_ga.html","id":null,"dir":"Reference","previous_headings":"","what":"Load csv files from green algo github repositories — csv_from_url_ga","title":"Load csv files from green algo github repositories — csv_from_url_ga","text":"Mainly internal use","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/csv_from_url_ga.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load csv files from green algo github repositories — csv_from_url_ga","text":"","code":"csv_from_url_ga(url, remove_first_line = TRUE)"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/csv_from_url_ga.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load csv files from green algo github repositories — csv_from_url_ga","text":"url url raw csv file remove_first_line (logical, default TRUE): remove first line csv file.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/csv_from_url_ga.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Load csv files from green algo github repositories — csv_from_url_ga","text":"data.frame","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/csv_from_url_ga.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Load csv files from green algo github repositories — csv_from_url_ga","text":"Adrien Taudière","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/csv_from_url_ga.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Load csv files from green algo github repositories — csv_from_url_ga","text":"","code":"carbon_intensity_internal <- csv_from_url_ga(\"https://raw.githubusercontent.com/GreenAlgorithms/green-algorithms-tool/refs/heads/master/data/v2.2/CI_aggregated.csv\")"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_footprint.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm — ga_footprint","title":"Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm — ga_footprint","text":"Please cite Lannelongue, L., Grealey, J., Inouye, M., Green Algorithms: Quantifying Carbon Footprint Computation. Adv. Sci. 2021, 2100707. https://doi.org/10.1002/advs.202100707 Default value https://github.com/GreenAlgorithms/green-algorithms-tool: PUE: https://github.com/GreenAlgorithms/green-algorithms-tool/blob/master/data/v2.2/defaults_PUE.csv TDP_per_core: https://raw.githubusercontent.com/GreenAlgorithms/green-algorithms-tool/refs/heads/master/data/v2.2/TDP_cpu.csv power_draw_per_gb: https://onlinelibrary.wiley.com/doi/10.1002/advs.202100707 Description algorithm green-algorithms website: \"\"\" carbon footprint calculated estimating energy draw algorithm carbon intensity producing energy given location: $$carbon footprint = energy needed * carbon intensity$$ energy needed : $$runtime * (power draw cores * usage + power draw memory) * PUE * PSF$$ power draw computing cores depends model number cores, memory power draw depends size memory available. usage factor corrects real core usage (default 1, .e. full usage). PUE (Power Usage Effectiveness) measures much extra energy needed operate data centre (cooling, lighting etc.). PSF (Pragmatic Scaling Factor) used take account multiple identical runs (e.g. testing optimisation). Carbon Intensity depends location technologies used produce electricity. note \"energy needed\" [...] independent location. \"\"\"","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_footprint.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm — ga_footprint","text":"","code":"ga_footprint( runtime_h = NULL, location_code = \"WORLD\", PUE = 1.67, TDP_per_core = 12, n_cores = 1, cpu_model = \"Any\", memory_ram = NULL, power_draw_per_gb = 0.3725, PSF = 1, usage_core = 1, add_ref_values = TRUE, add_storage_estimation = FALSE, mass_storage = NULL, carbon_intensity = NULL, TDP_cpu = NULL, ref_value = NULL )"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_footprint.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm — ga_footprint","text":"runtime_h Run time hours (int). runtime_h == \"session\", runtime compute using actual R session location_code (character list country region available ) PUE (int) Power usage effectiveness server. See https://github.com/GreenAlgorithms/green-algorithms-tool/blob/master/data/v2.2/defaults_PUE.csv example values. using personal computer, set PUE 1. TDP_per_core (int. Watt, default 12). Find cpu TDP nb cpu https://www.techpowerup.com/cpu-specs/ http://calculator.green-algorithms.org/ available. Owerwrite cpu_model param. n_cores (int, default 1) Number cores. Owerwrite cpu_model param. cpu_model Must present list http://calculator.green-algorithms.org/. CPU set, parameter TPD_per_core n_cores overwriting info cpu_model. \"auto\" modality (find cpu using benchmarkme::get_cpu()$model_name) running moment. memory_ram (int. GB) memory RAM. memory_ram NULL, use benchmarkme::get_ram() get RAM. power_draw_per_gb (int. Watt, default 0.3725) power draw GB RAM PSF (int, default 1) Pragmatic Scaling Factor. Citation Lannelongue et al. 2021: \"Many analyses presented single run particular algorithm software tool; however, computations rarely performed . Algorithms run multiple times, sometimes hundreds, systematically manually, different parameterizations. Statistical models may include number combinations covariates, fitting procedures, etc. important include repeats carbon footprint. take account number times computation performed practice, PSF defined, scaling factor estimated GHG emissions multiplied.\" usage_core (int, default 1). usage factor corrects real core usage (default 1, .e. full usage). add_ref_values (logical, default TRUE) compute return reference values compare footprint ? add_storage_estimation (logical, default FALSE) compute footprint mass storage ? default FALSE far less important cpu memory usage. Note green-algorithms website compute mass storage usage. mass_storage (int. GB, default NULL) size mass_storage. used add_storage_estimation set TRUE. set NULL, use base::gc() function estimate storage used. carbon_intensity (default NULL). Advanced users . dataframe location carbonIntensity columns. Set carbon_intensity_internal NULL. carbon_intensity_internal set using command line csv_from_url_ga(\"https://raw.githubusercontent.com/GreenAlgorithms/ green-algorithms-tool/refs/heads/master/data/v2.2/CI_aggregated.csv\") TDP_cpu (default NULL). Advanced users . dataframe model, n_cores TDP_per_core columns. Set TDP_cpu_internal NULL. TDP_cpu_internal set using command line csv_from_url_ga(\"https://raw.githubusercontent.com/GreenAlgorithms/ green-algorithms-tool/refs/heads/master/data/v2.2/TDP_cpu.csv\") ref_value (default NULL). Advanced users . dataframe variable value columns. Set ref_value_internal NULL. ref_value_internal set using command line csv_from_url_ga(\"https://raw.githubusercontent.com/GreenAlgorithms/ green-algorithms-tool/refs/heads/master/data/v2.2/referenceValues.csv\")","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_footprint.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm — ga_footprint","text":"list values runtime_h: input run time hours location_code: input location code TDP_per_core: input TDP_per_core (cpu_model set, correspond TDP_per_core cpu) n_cores: input n_cores (cpu_model set, correspond n_cores cpu) cpu_model: input cpu model. set \"\", TDP_per_core ncore used memory_ram: input memory ram GB power_draw_per_gb: input power draw per GB usage_core: input usage core carbon_intensity: input carbon intensity (depend location code) PUE: input PUE PSF: input PUE power_draw_for_cores_kWh: output power draw cores kWh power_draw_for_memory_kWh: output power draw RAM memory kWh energy_needed_kWh: output energy needed kWh carbon_footprint_cores: output carbon footprint grams CO2 cores usage carbon_footprint_memory: output carbon footprint grams CO2 memory usage carbon_footprint_total_gCO2: total output carbon footprint grams CO2 ref_value: (optionnal, return add_ref_values TRUE) : dataframe power_draw_storage_kWh: (optionnal, return add_storage_estimation TRUE) output power draw mass storage kWh","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_footprint.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm — ga_footprint","text":"Adrien Taudière","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_footprint.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compute footprint in grams of CO2 using Lannelongue et al. 2021 algorithm — ga_footprint","text":"","code":"ga_footprint( runtime_h = 12, n_cores = 6, TDP_per_core = 15.8, location_code = \"FR\", PUE = 1, cpu_model = \"Core i5-9600KF\" ) #> $runtime_h #> [1] 12 #> #> $location_code #> [1] \"FR\" #> #> $TDP_per_core #> [1] 15.8 #> #> $n_cores #> [1] 6 #> #> $cpu_model #> [1] \"Core i5-9600KF\" #> #> $memory_ram #> [1] 16.75734 #> #> $power_draw_per_gb #> [1] 0.3725 #> #> $`usage core` #> [1] 1 #> #> $carbon_intensity #> [1] 51.28 #> #> $PUE #> [1] 1 #> #> $PSF #> [1] 1 #> #> $power_draw_for_cores_kWh #> [1] 1.1376 #> #> $power_draw_for_memory_kWh #> [1] 0.07490532 #> #> $energy_needed_kWh #> [1] 1.212505 #> #> $carbon_footprint_cores #> [1] 58.33613 #> #> $carbon_footprint_memory #> [1] 3.841145 #> #> $carbon_footprint_total_gCO2 #> [1] 62.17727 #> #> $ref_value #> variable value #> 1 Total 62.1772727926653 #> 2 Cores 1.1376 #> 3 Memory 0.07490531966976 #> 4 memoryPower 0.3725 #> 5 google_search 10 #> 6 streaming_netflix_perhour 36 #> 7 train_perkm 41 #> 8 flight_economy_perkm 171 #> 9 passengerCar_EU_perkm 175 #> 10 passengerCar_US_perkm 251 #> 11 tree_month 917 #> 12 treeYear 11000 #> 13 flight_PAR-LON 50000 #> 14 flight_NY-SF 570000 #> 15 flight_NYC-MEL 2310000 #> source #> 1 #> 2 #> 3 #> 4 in W/GB from http://dl.acm.org/citation.cfm?doid=3076113.3076117 and https://www.tomshardware.com/uk/reviews/intel-core-i7-5960x-haswell-e-cpu,3918-13.html #> 5 gCO2 from http://www.janavirgin.com/CO2/CO2GLE_about.html #> 6 gCO2 from https://www.carbonbrief.org/factcheck-what-is-the-carbon-footprint-of-streaming-video-on-netflix (update) #> 7 in gCO2/km, but more like 5-37g, from https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2020 #> 8 in gCO2/km, but more like 139-244g, from https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2020 #> 9 in gCO2/km from http://www.sciencedirect.com/science/article/pii/S1352231018307295 and https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2019 #> 10 in gCO2/km from https://www.epa.gov/greenvehicles/greenhouse-gas-emissions-typical-passenger-vehicle #> 11 gCO2 same source as treeYear #> 12 in gCO2/tree/year from http://www.sciencedirect.com/science/article/pii/S0269749101002640 #> 13 gCO2e from https://calculator.carbonfootprint.com/calculator.aspx?tab=3 #> 14 gCO2e from https://calculator.carbonfootprint.com/calculator.aspx?tab=3 #> 15 gCO2e from https://calculator.carbonfootprint.com/calculator.aspx?tab=3 #> prop_footprint #> 1 1.000000e+00 #> 2 1.829607e-02 #> 3 1.204706e-03 #> 4 5.990935e-03 #> 5 1.608305e-01 #> 6 5.789897e-01 #> 7 6.594049e-01 #> 8 2.750201e+00 #> 9 2.814533e+00 #> 10 4.036845e+00 #> 11 1.474815e+01 #> 12 1.769135e+02 #> 13 8.041523e+02 #> 14 9.167337e+03 #> 15 3.715184e+04 #> ga_footprint( runtime_h = \"session\", PUE = 1, ) #> $runtime_h #> user.self #> 0.0018375 #> #> $location_code #> [1] \"WORLD\" #> #> $TDP_per_core #> [1] 12 #> #> $n_cores #> [1] 1 #> #> $cpu_model #> [1] \"Any\" #> #> $memory_ram #> [1] 16.75734 #> #> $power_draw_per_gb #> [1] 0.3725 #> #> $`usage core` #> [1] 1 #> #> $carbon_intensity #> [1] 475 #> #> $PUE #> [1] 1 #> #> $PSF #> [1] 1 #> #> $power_draw_for_cores_kWh #> user.self #> 2.205e-05 #> #> $power_draw_for_memory_kWh #> user.self #> 1.146988e-05 #> #> $energy_needed_kWh #> user.self #> 3.351988e-05 #> #> $carbon_footprint_cores #> user.self #> 0.01047375 #> #> $carbon_footprint_memory #> user.self #> 0.005448192 #> #> $carbon_footprint_total_gCO2 #> user.self #> 0.01592194 #> #> $ref_value #> variable value #> 1 Total 0.0159219416103552 #> 2 Cores 2.205e-05 #> 3 Memory 1.1469877074432e-05 #> 4 memoryPower 0.3725 #> 5 google_search 10 #> 6 streaming_netflix_perhour 36 #> 7 train_perkm 41 #> 8 flight_economy_perkm 171 #> 9 passengerCar_EU_perkm 175 #> 10 passengerCar_US_perkm 251 #> 11 tree_month 917 #> 12 treeYear 11000 #> 13 flight_PAR-LON 50000 #> 14 flight_NY-SF 570000 #> 15 flight_NYC-MEL 2310000 #> source #> 1 #> 2 #> 3 #> 4 in W/GB from http://dl.acm.org/citation.cfm?doid=3076113.3076117 and https://www.tomshardware.com/uk/reviews/intel-core-i7-5960x-haswell-e-cpu,3918-13.html #> 5 gCO2 from http://www.janavirgin.com/CO2/CO2GLE_about.html #> 6 gCO2 from https://www.carbonbrief.org/factcheck-what-is-the-carbon-footprint-of-streaming-video-on-netflix (update) #> 7 in gCO2/km, but more like 5-37g, from https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2020 #> 8 in gCO2/km, but more like 139-244g, from https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2020 #> 9 in gCO2/km from http://www.sciencedirect.com/science/article/pii/S1352231018307295 and https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2019 #> 10 in gCO2/km from https://www.epa.gov/greenvehicles/greenhouse-gas-emissions-typical-passenger-vehicle #> 11 gCO2 same source as treeYear #> 12 in gCO2/tree/year from http://www.sciencedirect.com/science/article/pii/S0269749101002640 #> 13 gCO2e from https://calculator.carbonfootprint.com/calculator.aspx?tab=3 #> 14 gCO2e from https://calculator.carbonfootprint.com/calculator.aspx?tab=3 #> 15 gCO2e from https://calculator.carbonfootprint.com/calculator.aspx?tab=3 #> prop_footprint #> 1 1.000000e+00 #> 2 1.384881e-03 #> 3 7.203818e-04 #> 4 2.339539e+01 #> 5 6.280641e+02 #> 6 2.261031e+03 #> 7 2.575063e+03 #> 8 1.073990e+04 #> 9 1.099112e+04 #> 10 1.576441e+04 #> 11 5.759348e+04 #> 12 6.908705e+05 #> 13 3.140321e+06 #> 14 3.579965e+07 #> 15 1.450828e+08 #> res_ga <- ga_footprint( runtime_h = 12, n_cores = 6, memory_ram = 64, PUE = 1, add_storage_estimation = TRUE, mass_storage = 1 ) ggplot(res_ga$ref_value, aes(y = variable, x = as.numeric(value), fill = log10(prop_footprint))) + geom_col() + geom_col(data = data.frame( variable = \"Total\", value = res_ga$carbon_footprint_total_gCO2 ), fill = \"grey30\") + geom_col(data = data.frame( variable = \"Cores\", value = res_ga$carbon_footprint_cores ), fill = \"darkred\") + geom_col(data = data.frame( variable = \"Memory\", value = res_ga$carbon_footprint_memory ), fill = \"orange\") + geom_col(data = data.frame( variable = \"Mass storage\", value = res_ga$carbon_footprint_storage ), fill = \"violet\") + scale_x_continuous( trans = \"log1p\", breaks = c(0, 10^c(1:max(log1p(as.numeric(res_ga$ref_value$value))))) ) + geom_vline( xintercept = res_ga$carbon_footprint_total_gCO2, col = \"grey30\", lwd = 1.2 ) + geom_label(aes(label = round_conditionaly(prop_footprint)), fill = \"grey90\", position = position_stack(vjust = 1.1) ) + labs( title = \"Carbon footprint of the analysis\", subtitle = paste0( \"(\", res_ga$carbon_footprint_total_gCO2, \" g CO2\", \")\" ), caption = \"Please cite Lannelongue et al. 2021 (10.1002/advs.202100707)\" ) + xlab(\"Carbon footprint (g CO2) in log10\") + ylab(\"Modality\") + theme(legend.position = \"none\")"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_targets.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute footprint in grams of CO2 for {targets} pipelines — ga_targets","title":"Compute footprint in grams of CO2 for {targets} pipelines — ga_targets","text":"mainly wrapper function ga_footprint() compute run time mass_storage (used add_storage_estimation = TRUE) using targets::tar_meta().","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_targets.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute footprint in grams of CO2 for {targets} pipelines — ga_targets","text":"","code":"ga_targets( names = NULL, fields = NULL, targets_only = TRUE, complete_only = FALSE, store = targets::tar_config_get(\"store\"), tar_meta_raw = NULL, ... )"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_targets.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute footprint in grams of CO2 for {targets} pipelines — ga_targets","text":"names Optional, names targets. See ?targets::tar_meta() fields Optional, names columns/fields select. See ?targets::tar_meta() targets_only Logical, whether just show information targets also return metadata functions global objects. complete_only Logical, whether return complete rows (NA values). store Character length 1, path targets data store. See ?targets::tar_meta() tar_meta_raw Optional, NULL, listed options (params targets::tar_meta() used. ... args passed ga_footprint()","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_targets.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute footprint in grams of CO2 for {targets} pipelines — ga_targets","text":"list value. See ?ga_footprint details.","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_targets.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Compute footprint in grams of CO2 for {targets} pipelines — ga_targets","text":"Adrien Taudière","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/ga_targets.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compute footprint in grams of CO2 for {targets} pipelines — ga_targets","text":"","code":"# In a targets folder, just run function ga_targets() # with the options you want # The next exemple emulate a mini-targets before to ask for tar_meta tar_dir({ # tar_dir() runs code from a temp dir for CRAN. tar_script( { list( tar_target( name = waiting, command = Sys.sleep(2), description = \"Sleep 2 seconds\" ), tar_target(x, writeLines( targets::tar_option_get(\"error\"), \"error.txt\" )) ) }, ask = FALSE ) tar_make() tm <- tar_meta() res_gat <- ga_targets( tar_meta_raw = tm, n_cores = 6, TDP_per_core = 15.8, location_code = \"FR\", PUE = 2, add_storage_estimation = TRUE ) ggplot(res_gat$ref_value, aes( y = reorder(variable, as.numeric(value)), x = as.numeric(value), fill = log10(prop_footprint) )) + geom_col() + geom_col(data = data.frame( variable = \"Total \", value = res_gat$carbon_footprint_total_gCO2 ), fill = \"grey30\") + geom_col( data = data.frame( variable = \"Cores\", value = res_gat$carbon_intensity * res_gat$power_draw_for_cores_kWh ), fill = \"darkred\" ) + geom_col( data = data.frame( variable = \"Memory\", value = res_gat$carbon_intensity * res_gat$power_draw_for_memory_kWh ), fill = \"orange\" ) + geom_col( data = data.frame( variable = \"Storage\", value = res_gat$carbon_intensity * res_gat$power_draw_per_gb ), fill = \"violet\" ) + scale_x_continuous(trans = \"log1p\") + geom_vline( xintercept = res_gat$carbon_footprint_total_gCO2, col = \"grey30\", lwd = 1.2 ) + geom_label(aes(label = round(prop_footprint, 1)), fill = \"grey90\") + xlab(\"g CO^2\") + ylab(\"Modality\") }) #> ▶ dispatched target x #> ● completed target x [0.001 seconds, 44 bytes] #> ▶ dispatched target waiting #> ● completed target waiting [2.002 seconds, 44 bytes] #> ▶ ended pipeline [2.067 seconds] #>"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/greenAlgoR-package.html","id":null,"dir":"Reference","previous_headings":"","what":"greenAlgoR package — greenAlgoR-package","title":"greenAlgoR package — greenAlgoR-package","text":"package computes ecological footprint R (based green-algorithms. greenAlgoR also made simple compute ecological footprint targets pipelines..","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/round_conditionaly.html","id":null,"dir":"Reference","previous_headings":"","what":"Round numeric vector conditionaly — round_conditionaly","title":"Round numeric vector conditionaly — round_conditionaly","text":"Round numeric vector conditionaly","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/round_conditionaly.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Round numeric vector conditionaly — round_conditionaly","text":"","code":"round_conditionaly( vec, cond = cbind(c(1e-05, 5), c(0.001, 3), c(0.01, 3), c(1, 2), c(10, 1), c(100, 0)) )"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/round_conditionaly.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Round numeric vector conditionaly — round_conditionaly","text":"vec numeric vector cond : matrix 2 row n column first row defining condition second row defining number round. cond order decreasing order 1 row internally. Thus order cond rows important","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/round_conditionaly.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Round numeric vector conditionaly — round_conditionaly","text":"numeric vector length vec","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/round_conditionaly.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Round numeric vector conditionaly — round_conditionaly","text":"Adrien Taudière","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/round_conditionaly.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Round numeric vector conditionaly — round_conditionaly","text":"","code":"round_conditionaly(vec = c(1000.27890, 10.87988, 1.769869, 0.99796, 0.000179)) #> [1] 1000.27890 10.87988 1.76987 0.99796 0.00018 round_conditionaly( vec = c(1000.27890, 0.000179, 10e-11), cond = cbind(c(10e-5, 5), c(10, 2)) ) #> [1] 1.000279e+03 1.800000e-04 1.000000e-10"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/session_runtime.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute session run time and mass storage use (based on gc()) — session_runtime","title":"Compute session run time and mass storage use (based on gc()) — session_runtime","text":"Compute cpu times using base::proc.time() mass storage using base::gc()","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/session_runtime.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute session run time and mass storage use (based on gc()) — session_runtime","text":"","code":"session_runtime(compute_mass_storage = TRUE)"},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/session_runtime.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute session run time and mass storage use (based on gc()) — session_runtime","text":"compute_mass_storage (logical, default TRUE) mass storage computed base::gc() function","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/session_runtime.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute session run time and mass storage use (based on gc()) — session_runtime","text":"list values","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/session_runtime.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Compute session run time and mass storage use (based on gc()) — session_runtime","text":"Adrien Taudière","code":""},{"path":"https://adrientaudiere.github.io/greenAlgoR/reference/session_runtime.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Compute session run time and mass storage use (based on gc()) — session_runtime","text":"","code":"session_runtime() #> $cpu_times_users #> user.self #> 7.9 #> #> $cpu_times_system #> user.child #> 2.054 #> #> $time_elapsed #> elapsed #> 13.381 #> #> $cpu_times #> user.self #> 9.954 #> #> $mass_storage_used #> [1] 236 #> #> $mass_storage_max #> [1] 358.4 #> session_runtime(compute_mass_storage = FALSE) #> $cpu_times_users #> user.self #> 8.39 #> #> $cpu_times_system #> user.child #> 2.054 #> #> $time_elapsed #> elapsed #> 13.871 #> #> $cpu_times #> user.self #> 10.444 #>"},{"path":"https://adrientaudiere.github.io/greenAlgoR/news/index.html","id":"greenalgor-01","dir":"Changelog","previous_headings":"","what":"greenAlgoR 0.1","title":"greenAlgoR 0.1","text":"Initial github submission. Creation function ga_footprint() ga_targets()","code":""}]