Skip to contents

Calculates final energy consumption supplied by each fossil fuel group, including in the form of electricity and heat

calc_fec_from_ff_by_group.Rd

This function calculates final energy consumption supplied by each fossil fuel group, including in the form of electricity and heat. It calculates it using the list of use matrices supplied by the user, and the list of supply matrices to determine the share of supply of electricity and heat by fossil fuel group.

Usage

calc_fec_from_ff_by_group(
  .tidy_iea_df,
  include_non_energy_uses = FALSE,
  list_use_mats = c(IEATools::psut_cols$Y, IEATools::psut_cols$U_eiou),
  list_supply_mats = c(IEATools::psut_cols$V),
  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",
  energy.stage = "Energy.stage"
)

Arguments

.tidy_iea_df

The .tidy_iea_df for which the final energy consumption supplied by each fossil fuel group needs to be calculated.

include_non_energy_uses

A boolean indicating whether non-energy uses are included in the calculation of final energy consumption by fossil fuel group. Default is "FALSE".

list_use_mats

The list of matrices to be used for determining total final energy consumption by fossil fuel group. Default is c(IEATools::psut_cols$Y, IEATools::psut_cols$U_eiou).

list_supply_mats

The list of matrices to be used for determining the shares of supply of heat and electricity by fossil fuel group. Default is c(IEATools::psut_cols$V).

list_oil_products

The list of oil products to be used when calculating the use shares. Default is IEATools::oil_and_oil_products.

list_coal_products

The list of coal products to be used when calculating the use shares. Default is IEATools::coal_and_coal_products.

list_gas_products

The list of gas products to be used when calculating the use shares. Default is IEATools::primary_gas_products.

list_non_energy_flows

A list identifying non-energy flows. Default is IEATools::non_energy_flows.

exports

The character string identifying exports flows in the .tidy_iea_df. Default is IEATools::interface_industries$exports.

losses

The character string identifying losses flows in the .tidy_iea_df. 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 name of the column containing the product group name. Default is "Product.Group".

product.group

The name of the column containing the product group name. Default is "Product.Group".

energy.stage

The name of the column containing the energy stage. Default is "Energy.stage".

Value

A tidy data frame containing the final energy consumption supplied by each fossil fuel group, including in the form of heat and electricity.

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

Examples

ECCTools::tidy_AB_data %>% 
   IEATools::add_psut_matnames() %>% 
   ECCTools::transform_to_dta() %>% 
   calc_fec_from_ff_by_group()
#> # A tibble: 6 × 9
#> # Groups:   Country, Method, Energy.type, Last.stage, Year, Unit, Product.Group
#> #   [6]
#>   Country Method Energy.type Last.stage  Year Unit  Product.Group   Energy.stage
#>   <chr>   <chr>  <chr>       <chr>      <dbl> <chr> <chr>           <chr>       
#> 1 A       PCM    E           Final       2018 ktoe  All fossil fue… Final       
#> 2 A       PCM    E           Final       2018 ktoe  Coal products   Final       
#> 3 A       PCM    E           Final       2018 ktoe  Natural gas     Final       
#> 4 A       PCM    E           Final       2018 ktoe  Oil and gas pr… Final       
#> 5 A       PCM    E           Final       2018 ktoe  Oil products    Final       
#> 6 A       PCM    E           Final       2018 ktoe  NA              NA          
#> # ℹ 1 more variable: E.dot <dbl>