Calculates total energy use by product — calc_total_use_by

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".

Value

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

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.

Examples

ECCTools::tidy_AB_data %>% 
   IEATools::add_psut_matnames() %>% 
   ECCTools::transform_to_dta() %>% 
   calc_total_use_by_product()
#> # A tibble: 5 × 9
#> # Groups:   Country, Method, Energy.type, Last.stage, Year, Product, Unit [5]
#>   Country Method Energy.type Last.stage  Year Product                      Unit 
#>   <chr>   <chr>  <chr>       <chr>      <dbl> <chr>                        <chr>
#> 1 A       PCM    E           Final       2018 Blast furnace gas            ktoe 
#> 2 A       PCM    E           Final       2018 Coke oven coke               ktoe 
#> 3 A       PCM    E           Final       2018 Kerosene type jet fuel excl… ktoe 
#> 4 A       PCM    E           Final       2018 Motor gasoline excl. biofue… ktoe 
#> 5 A       PCM    E           Final       2018 Natural gas                  ktoe 
#> # ℹ 2 more variables: product_without_origin <chr>, Total_Product_Use <dbl>