calc_all_products_use_by_group: Calculates the use of energy products by group

In earamendia/EROITools: EROITools

Calculates the use of energy products by group

Description

This function calculates the use of energy products by group for each fossil fuel group. 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_all_products_use_by_group(
  .tidy_iea_df,
  include_non_energy_uses = FALSE,
  final_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,
  product.group = "Product.Group",
  total_group_use = "Total_Group_Use",
  energy.stage = "Energy.stage",
  product_without_origin = "product_without_origin"
)

Arguments

.tidy_iea_df	The tidy iea data frame for which the use of energy products by group needs to be calculated.
include_non_energy_uses	A boolean indicating whether non-energy uses should be included in the calculation. Default is FALSE.
final_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 containing the names of oil products. Default is IEATools::oil_and_oil_products.
list_coal_products	A list containing the names of coal products. Default is IEATools::coal_and_coal_products.
list_gas_products	A list containing the names of 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.
product.group	The column name of the column defining the fossil fuel group. Default is "Product.Group".
total_group_use	Column name containing total energy use by product group. Default is "Total_Group_Use".
energy.stage	The column name of the column defining the energy stage. Default is "Energy.stage".
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. Non-energy use flows can be included or excluded from the calculations using the include_non_energy_uses boolean.

Value

A tidy data frame indicating the final energy use for each product group.

Examples

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

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