calc_total_use_by_product: Calculates total energy use by product

In earamendia/EROITools: EROITools

Calculates total energy use by product

Description

This function calculates, for each country, year, method, the total energy use by product (for fossil fuels), where the matrices containing energy use flows can be specified in the total_use_mats argument. By default, these matrices are U_EIOU and Y, and excludes energy flows used as feedstock. Exports and losses are also excluded from the total energy use. See details for more explanations.

Usage

calc_total_use_by_product(
  .tidy_iea_df,
  include_non_energy_uses = FALSE,
  total_use_mats = c(IEATools::psut_cols$Y, IEATools::psut_cols$U_eiou),
  list_oil_products = IEATools::oil_and_oil_products,
  list_coal_products = IEATools::coal_and_coal_products,
  list_gas_products = IEATools::primary_gas_products,
  list_non_energy_flows = IEATools::non_energy_flows,
  exports = IEATools::interface_industries$exports,
  losses = IEATools::tfc_compare_flows$losses,
  country = IEATools::iea_cols$country,
  method = IEATools::iea_cols$method,
  energy_type = IEATools::iea_cols$energy_type,
  last_stage = IEATools::iea_cols$last_stage,
  year = IEATools::iea_cols$year,
  product = IEATools::iea_cols$product,
  unit = IEATools::iea_cols$unit,
  flow = IEATools::iea_cols$flow,
  e_dot = IEATools::iea_cols$e_dot,
  matnames = IEATools::mat_meta_cols$matnames,
  total_product_use = "Total_Product_Use",
  product_without_origin = "product_without_origin"
)

Arguments

.tidy_iea_df	Tidy data frame for which to calculate total energy use by product
include_non_energy_uses	A boolean defining whether non-energy uses should be included in the calculation of total final energy use. Default is FALSE.
total_use_mats	A list describing from which matrices should total final energy uses be calculated. Default is c(IEATools::psut_cols$Y, IEATools::psut_cols$U_eiou).
list_oil_products	A list of oil products. Default is IEATools::oil_and_oil_products.
list_coal_products	A list of coal products. Default is IEATools::coal_and_coal_products.
list_gas_products	A list of natural gas products. Default is IEATools::primary_gas_products.
list_non_energy_flows	A list containing the names of non-energy flows in IEA data. Default is IEATools::non_energy_flows.
exports	A string identifying Exports flows. Default is IEATools::interface_industries$exports.
losses	A string identifying Losses flows. Default is IEATools::tfc_compare_flows$losses.
country, method, energy_type, last_stage, year, product, unit, flow, e_dot	See IEATools::iea_cols.
matnames	The column name of the column having matrices names. Default is IEATools::mat_meta_cols$matnames.
total_product_use	Column name containing total energy use by product. Default is "Total_Product_Use".
product_without_origin	Column name containing the name of the product excluding the country of origin. Helpful for doing calculations with Global Market Assumption. Default is "product_without_origin".

Details

The function can work both on a single country Energy Conversion Chain of Domestic Technology Assumption type, or with a multi-regional Energy Conversion Chain for instance using the Global Market Assumption. The input data frame will have to be slightly adapted in this case (for an example see the tests related to the function), and the energy use by product will be returned as the pair (Origin_Country, Product). Non-energy use flows can be included or excluded from the calculations using the include_non_energy_uses boolean.

Value

A data frame containing the values of total energy use by product.

Examples

ECCTools::tidy_AB_data %>% 
   IEATools::add_psut_matnames() %>% 
   ECCTools::transform_to_dta() %>% 
   calc_total_use_by_product()

earamendia/EROITools documentation built on May 19, 2023, 10:30 a.m.