Source-data mapping columns

Mapping labels tell model-data tools which columns to use in source datasets. They are model metadata and should not be repeated in setup or run scripts.

GTAP mappings

Every model configuration declares country and commodity mappings:

mapping_columns:
  gtap:
    country: "W"
    commodity: standard_6

Add an Ember generation mapping

Models with electricity distribution and generation sectors declare both the feature and the Ember mapping:

model:
  version: "22N"
  build: "200"
  sector_count: 22
  electricity_distribution_sector: a01
  features:
    has_electricity_distribution_and_generation_sectors: true

mapping_columns:
  gtap:
    country: "N"
    commodity: standard_22
  ember:
    generation: standard_22

If the electricity feature is true, ember.generation is required. If the feature is absent or false, the Ember mapping must be absent. The optional model.electricity_distribution_sector names the single SYM distribution sector; it is not an Ember mapping label.

Model file names