gcubed.exogenous_adjustments.autonomous_energy_usage_efficiency
This module provides handling of the exogenous projections of autonomous (manna from heaven) energy efficiency improvements that impact on production and consumption.
This class loads and provides access to Autonomous Energy Efficiency Improvements (AEEI) data.
The adjustments are incorporated into the baseline exogenous variable projections.
Constructor
Arguments
sym_data: The information about the SYM model definition.
The model configuration is accessible via this argument, thus enabling discovery of the location of the AEEI CSV file.
CSV file format
The default name of the CSV file containing the AEEI data is
autonomous_energy_efficiency_improvements.csv
.
That name can be changed by setting the ModelConfiguration.AutonomousEnergyEfficiencyImprovementsFile
value
to the preferred name of the CSV file.
The AEEI CSV file records Autonomous Energy Efficiency Improvements for all regions and all sectors within each region, through the projection years. It also captures these improvements for consumption.
See McKibbin and Wilcoxen (2013) A global approach to energy and environment: the G-Cubed model for details of AEEI.
An example layout for this CSV file is shown below for the 2 region/2 sector model:
2017 | 2018 | 2019 | .... | 2150 | |
---|---|---|---|---|---|
AEEI(a01,USA) | 0 | 0 | 0 | 0 | 0 |
AEEI(a01,USA) | 0 | 0 | 0 | 0 | 0 |
AEEI(a01,ROW) | 0 | 0 | 0 | 0 | 0 |
AEEI(a01,ROW) | 0 | 0 | 0 | 0 | 0 |
AEEIC(USA) | 0 | 0 | 0 | 0 | 0 |
AEEIC(ROW) | 0 | 0 | 0 | 0 | 0 |
The first row contains the ordered years as column labels.
Note that the first year can be before the first projection year.
The last year must be the last projection year.
The first column contains row labels. All row labels are made up from three components, in the following order:
- The prefix
AEEI
for production by sectors andAEEIC
for consumption. - In brackets, the set combinations that are affected by the autonomous energy efficiency improvements. For sectors, the set combinations are a sector code followed by a region code. For consumption, the set combination is just a region code.
For example, the row labelled AEEI(a01,USA)
is the AEEI projections for sector 1
for the United States.
The consumption rows must be the last rows in the file.
The sector rows must be in the SYM-defined sector order.
The rows must also be in the SYM-defined region order as you work down the file.
The data values are the percentage exogenous improvement in energy efficiency for that sector, or for consumption, in the given region for a given year. Thus, a value of 1 is a 1% improvement in energy efficiency in that year.
Overview
Accesses the annual sectoral autonomous energy efficiency gain projections for the given region.
Arguments
region
: The region code for which the data is required.
Returns
A dataframe containing the projected autonomous energy efficiency gains for the sectors in the given region.
Overview
The cumulative autonomous energy efficiency gain projections for the given region are calculated from the annual gains in the data file.
They are simply a cumulative sum of the annual gains.
Arguments
region
: The region code for which the data is required.
Returns
The dataframe of cumulative energy usage efficiency gains for the sectors in the given region.
Each dataframe has a row for each sector.
They are used to populate the projections for the exogenous variables
SHL(sector,region)
.
Overview
Accesses the annual consumption autonomous energy efficiency gain projections for all regions.
Arguments
region
: The region code for which the data is required.
Returns
A dataframe containing the projected autonomous energy efficiency gains for consumption with a row for each region and a column for each projection year.
Overview
The cumulative autonomous energy efficiency gain projections for consumption in all regions.
They are simply a cumulative sum of the annual gains.
Returns
The dataframe of cumulative energy usage efficiency gains for consumption in each region.
The dataframe has a row for each region.
They are used to populate the projections for the exogenous variables
SHEFC(region)
.
True
if the input AEEI data include consumption energy usage efficiency projections
for each region and False
otherwise.