Skip to contents

Move the useful details energy matrices to exergy

extend_details_matrices_to_exergy.Rd

A function to extend a data frame of energy fu details matrices to exergy.

Usage

extend_details_matrices_to_exergy(
  fu_details_mats,
  phi_vecs,
  countries,
  country_colname = IEATools::iea_cols$country,
  year_colname = IEATools::iea_cols$year
)

Arguments

fu_details_mats

A data frame containing final-to-useful details matrices.

phi_vecs

The name of the phi vectors column in fu_details_mats.

countries

The countries for which this function should be applied.

country_colname, year_colname

Names of columns in fu_details_mats.

Value

A version of fu_details_mats with matrices containing exergy at the useful stage.

Details

The final-to-useful details matrices contain information in rows and columns about the transition from final to useful energy and exergy, including

  • the final energy product,

  • the final demand sector,

  • the final-to-useful machine, and

  • the the useful energy product.

Entries in the details matrices are useful energy amounts. Information is encoded in row and column labels of the details matrix:

  • Row names use RCLabels::arrow_notation with

    • a prefix that identifies the final energy product and

    • a suffix that identifies the sector in which the final-to-useful transformation occurs.

    • Example: "Aviation gasoline -> Domestic aviation".

  • Column names use RCLabels::from_notation with

    • a prefix that identifies the useful energy product and

    • a suffix that identifies the final-to-useful machine.

    • Example: "HPL [from Electric pumps]".

This function enables mapping over countries.