The R
package EROITools
provides tools to aggregate Energy Return On Investment (EROI) values previously calculated using a Physical Supply Use Table (PSUT) framework to represent the Energy Conversion Chain (see Heun, Owen, and Brockway (2018)). Previous to using the EROITools
package, the World Energy Extended Balances (WEEB) from the International Energy Agency (IEA) can be loaded and tidied using the IEATools
and ECCTools
R
packages. The Recca
R
package then allows analysts to calculate a wide range of EROIs at the product and industry levels, and the EROITools
package provides tools aggregate the calculated EROIs by product group. Important features of the EROITools
package include the following:
- Aggregations can be performed either at the global or national level;
- Aggregations can be performed at both the primary and final stage of energy use, but also at the useful stage of energy use providing that final-to-useful efficiencies are provided by the analyst for each energy product;
- At the useful stage, the package also allows analysts to conduct these aggregations respecting sectoral or end-use breakdowns, so that the average useful stage EROI of a product group can be calculated for a given final demand sector (for instance steelmaking) or for a given end-use category (for instance high temperature heating);
- Last, the package allows analysts to add additional energy requirements (supposing that these are provided by the analyst) that cannot be quantified using the IEA’s WEEB such as supply chain energy requirements — see Brockway et al. (2019) or Brand-Correa et al. (2017) for examples of a quantification of such indirect energy flows.
Installation
You can install EROITools
from github with:
# install devtools if not already installed
# install.packages("devtools")
devtools::install_github("earamendia/EROITools")
# To build vignettes locally, use
devtools::install_github("earamendia/EROITools", build_vignettes = TRUE)
History
This package builds upon the previous IEATools
, Recca
, and ECCTools
R
packages and will be demonstrated in a paper as soon as possible. The calculations conducted within the package are heavily dependent on the Physical Supply Use Table framework introduced to represent the Energy Conversion Chain in Heun, Owen, and Brockway (2018) and further developed in Aramendia et al. (2022).
More Information
Find more information, including vignettes and function documentation, at https://earamendia.github.io/EROITools/.