Model Specification

December 19, 2024 ยท View on GitHub

Model specifications are assigned in a yml file based on the parameters shown below

ItemTypeRequired?Description
ModelstrYThe model name
BaseIOSchemaintYThe base IO schema (e.g. 2012)
BaseIOLevelstrYThe base IO level of detail (e.g. Detail)
IOYearintYThe base IO year
AliasstrNThe alias provided to the model, typically also included in the model name. Required for two region models from stateior.
ModelRegionAcronymslistYThe model region acronyms
ModelTypestrYThe model type (e.g. EEIO)
IODataSourcestrYThe model source (e.g. BEA or stateior)
IODataVersionstrNRequired if IODataSource is stateior, stateior model version number
BasePriceTypestrYThe model base price type (PRO: producer or PUR: purchaser)
BasewithRedefinitionsboolYWhether the model is based with redefinitions (TRUE or FALSE)
CommodityorIndustryTypestrYDefine if this is a commodity x commodity (Commodity) or industry x industry (Industry) model
ScrapIncludedboolYWhether the model includes scrap (TRUE or FALSE)
DisaggregationSpecsstrNThe disaggregation specifications
HybridizationSpecsstrNThe hybridization specifications
MUIOSpecsstrNThe mixed unit hybridization specifications
WIOSpecsstrNThe waste input output specifications
ExternalImportFactorsboolNWhether the model includes specifications for Import Emission Factors
SatelliteTablelistThe satellite table specifications
IndicatorslistNThe indicator specifications
DemandVectorslistThe demand vector specifications

Model Types

  • EEIO: (default) Environmentally Extended Input Output
  • EEIO-IH: Integrated Hybrid model
  • MUIO: Mixed Unit Input-Output
  • WIO: Waste Input-Output

Satellite Table Specifications

ItemTypeRequired?Description
FullNamestrYThe name of the satellite table
AbbreviationstrYAbbreviation used for the satellite table
StaticSourceboolYIf TRUE, indicates the use of a static source file. If FALSE the data will be generated dynamically
StaticFilestrNRequired if StaticSource = TRUE, indicates the path of the source file
FileLocationstrYThe location of the source file. Options are 'DataCommons' or 'useeior'. If StaticSource = FALSE, set to None
DataYearslistYYears reprsented by flows included in the satellite table
LocationslistYThe model name
SectorListSourcestrYThe source category used for sectors in the satellite table (e.g. 'BEA' or 'NAICS')
SectorListYearintYThe year of the SectorListSource
SectorListLevelstrYThe level of detail for the SectorListSource (e.g. 'Detail' or '6' for 6-digit NAICS)
OriginalFlowSourcestrYSource list for flow names. If not 'FEDEFL', used to identify appropriate flow mapping
ScriptFunctionCallstrNFunction name for additional processing of satellite table
ScriptFunctionParameterslistNParameters for ScriptFunctionCall
DataSourceslistNMetadata for the satellite table sources

Indicator Specifications

ItemTypeRequired?Description
NamestrYThe indicator name
CodestrYThe indicator code
GroupstrYThe type of indicator (e.g. 'Impact Potential', 'Resource Use','Chemical Releases','Economic & Social')
UnitstrYUnit for the indicator
SimpleUnitstrY
SimpleNamestrY
StaticSourceboolYIf TRUE, indicates the use of a static source file. If FALSE the data will be generated dynamically
StaticFilestrNRequired if StaticSource = TRUE, indicates the path of the source file
FileLocationstrYThe location of the source file. Options are 'DataCommons' or 'useeior'.
ScriptFunctionCallstrNFunction name for additional processing of indicator
ScriptFunctionParameterslistNParameters for ScriptFunctionCall
DataSourceslistNMetadata for the indicator sources

Demand Vector Specifications

Default demand vectors include CompleteProduction, DomesticProduction, CompleteConsumption, and DomesticConsumption.

Customized demand vector list is given a unique Name, such as HouseholdConsumption.

ItemTypeRequired?Description
TypestrY
YearintY (customized), N (default)Use model IO data year (default)
SystemstrY
LocationstrY (customized), N (default)Use model region acronym (default)

DataSources Specifications

ItemTypeRequired?Description
TitlestrYTitle of the source
AuthorstrYAuthors of the source
DataYearintYYear of publication
URLstrYSource URL
PrimaryboolY