Data Model

Todo

Update once new data model is agreed to

Data fed into aneris is assumed to be so-called wide-style panel data. Within the code base, standard Pandas :code:`DataFrame`s are used. When using the CLI, Excel spreadsheets or csvs are supported.

Variable Names

The most important data underlying harmonizations are timeseries. Timeseries are defined by a Variable and a number of Data columns for each timestep in the timeseries. Variable names are assumed to follow the IAMC style and have the form:

<prefix>|Emissions|<gas>|<sector>|<suffix>

• prefix: a designation for the current study (e.g., “CEDS”)

• gas: the emissions species (e.g., “BC”)

• sector: the emissions sector (e.g., “Transportation”)

• suffix: a designation for raw-model data (e.g., “Unharmonized”)

Importantly, model data variable names must match historical data variable names exactly.

Unharmonized IAM Data

Data from IAMs is expected to be in the following format with a sheetname “data”.

Example Model Input

Model	Scenario	Region	Variable	Unit	2005	2010	2020	2030
model	sspn	regionc	prefix|Emissions|BC|sector1|suffix	Mt BC/yr	10	11	12	13
model	sspn	regionc	prefix|Emissions|BC|sector2|suffix	Mt BC/yr	11	12	13	14
model	sspn	regionc	prefix|Emissions|BC|suffix	Mt BC/yr	21	23	25	27

If overrides are provided, they are expected to be in the following formay with a sheetname “harmonization”.

Example Harmonization Overrides

Model	Scenario	Region	Variable	Unit	Method
model	sspn	regionc	prefix|Emissions|BC|sector1|suffix	Mt BC/yr	reduce_ratio_2100

Additionally, configuration parameters (described in Run Control and Configuration) can be set by two columns titled “Configuration” and “Value” in the harmonization sheet.

Historical Data

Historical data is expected to be in the following format

Example Historical Data

Model	Scenario	Region	Variable	Unit	2000	2001	2002	2003
History	scen	regiona	prefix|Emissions|BC|sector1|suffix	Mt BC/yr	1	2	3	4
History	scen	regiona	prefix|Emissions|BC|sector2|suffix	Mt BC/yr	2	3	4	5
History	scen	regiona	prefix|Emissions|BC|suffix	Mt BC/yr	3	5	7	9

Regional Definitions

Data for regional mappings (countries to IAM regions) is expected to be in the following format

Example Regional Definitions

ISO Code	Country	Native Region Code	5_region
regiona	Region A	regionc	R5LAM
regionb	Region B	regionc	R5LAM
World	World	World	World