losses_to_balancing: Relocates losses in the Balancing matrix

In earamendia/ECCTools: ECCTools Assists With Energy Conversion Chain Analysis

Relocates losses in the Balancing matrix

Description

This function relocates losses to the balancing matrix B. The Balancing matrix is akin to an additional final demand matrix.

Usage

losses_to_balancing(
  .tidy_iea_df,
  flow = IEATools::iea_cols$flow,
  matnames = IEATools::mat_meta_cols$matnames,
  e_dot = IEATools::iea_cols$e_dot,
  ledger_side = IEATools::iea_cols$ledger_side,
  losses = IEATools::tfc_compare_flows$losses,
  balancing_matrix = "B"
)

Arguments

.tidy_iea_df	The .tidy_iea_df for which losses need to be relocated in the Balancing matrix.
flow, e_dot, ledger_side	See IEATools::iea_cols.
matnames	The column name of the column containing matrices names. Default is IEATools::mat_meta_cols$matnames.
losses	The name of losses flows. Default is IEATools::tfc_compare_flows$losses.
balancing_matrix	The name of the Balancing matrix. Default is "B".

Details

See the Balancing matrix vignette for more information. Note: one needs to add the column containing matrices names first, most likely using the IEATools::add_psut_matnames() function.

Importantly, we change the sign of losses flows when moving them to the balancing matrix, so that they stay akin to final demand flows. And we change their ledger side to "Consumption" so that the energy balance is respected.

Value

A .tidy_iea_df with losses relocated in the Balancing matrix.

Examples

tidy_AB_data %>%
tibble::add_row(
 Country = "A",
 Method = "PCM",
 Energy.type = "E",
 Last.stage = "Final",
 Year = 2018,
 Ledger.side = "Supply",
 Flow.aggregation.point = "TFC compare",
 Flow = "Losses",
 Product = "Electricity",
 Unit = "ktoe",
 E.dot = -100,
) %>%
 IEATools::add_psut_matnames() %>%
 dplyr::filter(matnames == "B")

earamendia/ECCTools documentation built on May 12, 2023, 2:12 a.m.