Data and configuration files

Sets (material/set.yaml)

# Set configuration for the MESSAGE-Materials model

# For each set in the MESSAGEix framework, the group contains:
# - 'require': elements that must be present for the model to be set up.
# - 'remove': elements to remove.
# - 'add': elements to add.

common:
  node:
    add:
    - R12_GLB

  technology:
    add:
    - extract__freshwater_supply
    remove:
    # remove deprecated technologies that are sometimes still existent in older MESSAGEix-GLOBIOM versions
    - hp_gas_i
    - sp_coal_I
    - hp_gas_rc

  commodity:
    require:
    - coal
    - gas
    - electr
    - ethanol
    - methanol
    - fueloil
    - lightoil
    - hydrogen
    - lh2
    - d_heat
    - biomass
    add:
    - water
    - fresh_water_supply
    - freshwater_supply

  level:
    add:
    - water_supply

    require:
    - primary
    - secondary
    - useful
    - final
    #- water_supply
    - export
    - import

# Not used at the moment
# maybe to be used in updated legacy reporting
#  type_tec:
#    add:
#    - industry

  mode:
    add:
    - M1
    - M2

  emission:
    add:
    - CO2
    - CH4
    - N2O
    - NOx
    - SO2
    - PM2p5 # Just add there since it is already in Shaohui's data
    - CF4
    - CO2_industry
    - CO2_transport
    - CO2_transformation

  year:
    require:
    - 1980
    - 1990
    - 1995
    - 2000
    - 2005
    - 2010
    - 2015

  unit:
    add:
    - t/kW
    - Mt
    - Mt/yr
    - USD/kW


generic:
  commodity:
    add:
    - ht_heat
    - lt_heat

  level:
    add:
    - useful_steel
    - useful_cement
    - useful_aluminum
    - useful_refining
    - useful_petro
    - useful_resins

  technology:
    add:
    - furnace_foil_steel
    - furnace_loil_steel
    - furnace_biomass_steel
    - furnace_ethanol_steel
    - furnace_methanol_steel
    - furnace_gas_steel
    - furnace_coal_steel
    - furnace_elec_steel
    - furnace_h2_steel
    - hp_elec_steel
    - fc_h2_steel
    - solar_steel
    - dheat_steel
    - furnace_foil_cement
    - furnace_loil_cement
    - furnace_biomass_cement
    - furnace_ethanol_cement
    - furnace_methanol_cement
    - furnace_gas_cement
    - furnace_coal_cement
    - furnace_elec_cement
    - furnace_h2_cement
    - hp_elec_cement
    - fc_h2_cement
    - solar_cement
    - dheat_cement
    - furnace_coal_aluminum
    - furnace_foil_aluminum
    - furnace_loil_aluminum
    - furnace_ethanol_aluminum
    - furnace_biomass_aluminum
    - furnace_methanol_aluminum
    - furnace_gas_aluminum
    - furnace_elec_aluminum
    - furnace_h2_aluminum
    - hp_elec_aluminum
    - fc_h2_aluminum
    - solar_aluminum
    - dheat_aluminum
    - furnace_coke_petro
    - furnace_coal_petro
    - furnace_foil_petro
    - furnace_loil_petro
    - furnace_ethanol_petro
    - furnace_biomass_petro
    - furnace_methanol_petro
    - furnace_gas_petro
    - furnace_elec_petro
    - furnace_h2_petro
    - hp_elec_petro
    - fc_h2_petro
    - solar_petro
    - dheat_petro
    - furnace_coke_refining
    - furnace_coal_refining
    - furnace_foil_refining
    - furnace_loil_refining
    - furnace_ethanol_refining
    - furnace_biomass_refining
    - furnace_methanol_refining
    - furnace_gas_refining
    - furnace_elec_refining
    - furnace_h2_refining
    - hp_elec_refining
    - fc_h2_refining
    - solar_refining
    - dheat_refining
    - furnace_coal_resins
    - furnace_foil_resins
    - furnace_loil_resins
    - furnace_ethanol_resins
    - furnace_biomass_resins
    - furnace_methanol_resins
    - furnace_gas_resins
    - furnace_elec_resins
    - furnace_h2_resins
    - hp_elec_resins
    - fc_h2_resins
    - solar_resins
    - dheat_resins

  mode:
    add:
    - low_temp
    - high_temp

petro_chemicals:
  commodity:
    require:
    - crudeoil
    add:
    - HVC
    - naphtha
    - kerosene
    - diesel
    - atm_residue
    - refinery_gas
    - atm_gasoil
    - atm_residue
    - vacuum_gasoil
    - vacuum_residue
    - gasoline
    - heavy_foil
    - light_foil
    - propylene
    - pet_coke
    - ethane
    - propane
    - ethylene
    - BTX
    remove:
    - i_feed

  level:
    require:
    - secondary
    - final
    add:
    - pre_intermediate
    - desulfurized
    - intermediate
    - secondary_material
    - final_material
    - demand
    - refinery

  balance_equality:
    add:
      - ["lightoil", "import"]
      - ["lightoil", "export"]
      - ["fueloil", "import"]
      - ["fueloil", "export"]

  mode:
    add:
    - atm_gasoil
    - vacuum_gasoil
    - naphtha
    - kerosene
    - diesel
    - cracking_gasoline
    - cracking_loil
    - ethane
    - propane
    - light_foil
    - refinery_gas
    - refinery_gas_int
    - heavy_foil
    - pet_coke
    - atm_residue
    - vacuum_residue
    - gasoline
    - ethylene
    - propylene
    - BTX

  technology:
    add:
    - atm_distillation_ref
    - vacuum_distillation_ref
    - hydrotreating_ref
    - catalytic_cracking_ref
    - visbreaker_ref
    - coking_ref
    - catalytic_reforming_ref
    - hydro_cracking_ref
    - steam_cracker_petro
    - ethanol_to_ethylene_petro
    - agg_ref
    - gas_processing_petro
    - trade_petro
    - import_petro
    - export_petro
    - feedstock_t/d
    - production_HVC
    remove:
    # Any representation of refinery.
    - ref_hil
    - ref_lol
    - coal_fs
    - ethanol_fs
    - gas_fs
    - foil_fs
    - loil_fs
    - methanol_fs

  shares:
    add:
    - steam_cracker

  sector:
    remove:
    - i_feed

steel:
  mode:
    add:
    - M3
    - M4

  commodity:
    add:
    - steel
    - pig_iron
    - pig_iron_dummy
    - charcoal
    - sponge_iron
    - sinter_iron
    - pellet_iron
    - ore_iron
    - limestone_iron
    - coke_iron
    - slag_iron
    - co_gas
    - bf_gas
    - off_gas

  level:
    add:
    - new_scrap
    - old_scrap_1
    - old_scrap_2
    - old_scrap_3
    - primary_material
    - secondary_material
    - tertiary_material
    - final_material
    - useful_material
    - waste_material
    - product
    - demand
    - dummy_emission
    - end_of_life
    - dummy_end_of_life_1
    - dummy_end_of_life_2
    - dummy_end_of_life_3
    - dummy_ccs

  technology:
    add:
    - cokeoven_steel
    - sinter_steel
    - pellet_steel
    - bf_steel
    - bf_ccs_steel
    - dri_steel
    - dri_coal_steel
    - dri_gas_steel
    - dri_gas_ccs_steel
    - dri_h2_steel
    - sr_steel
    - bof_steel
    - eaf_steel
    - prep_secondary_steel_1
    - prep_secondary_steel_2
    - prep_secondary_steel_3
    - finishing_steel
    - manuf_steel
    - scrap_recovery_steel_1
    - scrap_recovery_steel_2
    - scrap_recovery_steel_3
    - DUMMY_ore_supply
    - DUMMY_limestone_supply_steel
    - DUMMY_coal_supply
    - DUMMY_gas_supply
    - trade_steel
    - import_steel
    - export_steel
    - other_EOL_steel
    - total_EOL_steel
    - bf_biomass_steel
    - prod_charcoal_steel

  relation:
    add:
      - minimum_recycling_steel
      - max_global_recycling_steel
      - max_regional_recycling_steel
      - eaf_bound_2020
      - bof_bound_2020
      - bf_bound_2020

#  balance_equality:
#    add:
#      - ["steel","old_scrap_1"]
#      - ["steel","old_scrap_2"]
#      - ["steel","old_scrap_3"]
#      - ["steel","end_of_life"]
#      - ["steel","product"]
#      - ["steel","new_scrap"]
#      - ["steel","useful_material"]
#      - ["steel","final_material"]

  addon:
    add:
      - bf_ccs_steel
      - dri_coal_steel
      - dri_gas_ccs_steel
      - dri_gas_steel
      - dri_h2_steel

  type_addon:
    add:
      - bf_ccs_steel_addon
      - dri_gas_ccs_steel_addon
      - dri_steel_addon

  map_tec_addon:
    add:
      - [bf_steel, bf_ccs_steel_addon]
      - [dri_gas_steel, dri_gas_ccs_steel_addon]
      - [dri_steel, dri_steel_addon]

  cat_addon:
    add:
      - [bf_ccs_steel_addon, bf_ccs_steel]
      - [dri_gas_ccs_steel_addon, dri_gas_ccs_steel]
      - [dri_steel_addon, dri_coal_steel]
      - [dri_steel_addon, dri_gas_steel]
      - [dri_steel_addon, dri_h2_steel]

cement:
  commodity:
    add:
    - cement
    - clinker_cement
    - raw_meal_cement
    - limestone_cement

  level:
    add:
    - primary_material
    - secondary_material
    - tertiary_material
    - final_material
    - useful_material
    - demand
    - dummy_end_of_life
    - end_of_life

  technology:
    add:
    - raw_meal_prep_cement
    - clinker_dry_cement
    - clinker_wet_cement
    - clinker_dry_ccs_cement
    - clinker_wet_ccs_cement
    - grinding_ballmill_cement
    - grinding_vertmill_cement
    - DUMMY_limestone_supply_cement
    - total_EOL_cement
    - other_EOL_cement
    - scrap_recovery_cement

    remove:
    - cement_co2scr
    - cement_CO2

  relation:
    remove:
    - cement_pro
    - cement_scrub_lim

  balance_equality:
    add:
      - ["cement","end_of_life"]

  addon:
    add:
    - clinker_dry_ccs_cement
    - clinker_wet_ccs_cement

  type_addon:
    add:
    - wet_ccs_cement
    - dry_ccs_cement

  map_tec_addon:
    add:
    - [clinker_dry_cement, dry_ccs_cement]
    - [clinker_wet_cement, wet_ccs_cement]

  cat_addon:
    add:
    - [dry_ccs_cement, clinker_dry_ccs_cement]
    - [wet_ccs_cement, clinker_wet_ccs_cement]

aluminum:
  commodity:
    add:
    - aluminum
    - bauxite
    - alumina

  level:
    add:
    - new_scrap
    - old_scrap_1
    - old_scrap_2
    - old_scrap_3
    - useful_aluminum
    - final_material
    - useful_material
    - product
    - secondary_material
    - primary_material
    - demand
    - end_of_life
    - dummy_end_of_life_1
    - dummy_end_of_life_2
    - dummy_end_of_life_3

  technology:
    add:
    - trade_alumina
    - import_alumina
    - export_alumina
    - refining_aluminum
    - soderberg_aluminum
    - prebake_aluminum
    - secondary_aluminum
    - prep_secondary_aluminum_1
    - prep_secondary_aluminum_2
    - prep_secondary_aluminum_3
    - finishing_aluminum
    - manuf_aluminum
    - scrap_recovery_aluminum_1
    - scrap_recovery_aluminum_2
    - scrap_recovery_aluminum_3
    - DUMMY_bauxite_supply
    - trade_aluminum
    - import_aluminum
    - export_aluminum
    - other_EOL_aluminum
    - total_EOL_aluminum

  relation:
    add:
      - minimum_recycling_aluminum
      - maximum_recycling_aluminum

  balance_equality:
    add:
      - ["aluminum","old_scrap_1"]
      - ["aluminum","old_scrap_2"]
      - ["aluminum","old_scrap_3"]
      - ["aluminum","end_of_life"]
      - ["aluminum","product"]
      - ["aluminum","new_scrap"]

fertilizer:
  commodity:
    require:
    - electr
    add:
    - NH3
    - Fertilizer Use|Nitrogen
    - wastewater

  level:
    add:
    - secondary_material
    - final_material
    - wastewater

  technology:
    require:
    - h2_bio_ccs  # Reference for vent-to-storage ratio
    add:
    - biomass_NH3
    - electr_NH3
    - gas_NH3
    - coal_NH3
    - fueloil_NH3
    - NH3_to_N_fertil
    - trade_NFert
    - export_NFert
    - import_NFert
    - trade_NH3
    - export_NH3
    - import_NH3
    - residual_NH3
    - biomass_NH3_ccs
    - gas_NH3_ccs
    - coal_NH3_ccs
    - fueloil_NH3_ccs

  relation:
    add:
      - NH3_trd_cap
      - NFert_trd_cap

methanol:
  commodity:
    require:
    - electr
    - biomass
    - hydrogen
    - d_heat
    add:
    - methanol
    - ht_heat
    - formaldehyde
    - ethylene
    - propylene
    - fcoh_resin

  level:
    add:
    - final_material
    - secondary_material
    - primary_material
    - export_fs
    - import_fs

  mode:
    add:
    - feedstock
    - fuel
    - ethanol

  technology:
    add:
    - meth_bio
    - meth_bio_ccs
    - meth_h2
    - meth_t_d_material
    - MTO_petro
    - CH2O_synth
    - CH2O_to_resin
    - meth_coal
    - meth_coal_ccs
    - meth_ng
    - meth_ng_ccs
    - meth_t_d
    - meth_bal
    - meth_trd
    - meth_exp
    - meth_imp
    - meth_ind_fs
    remove:
    - sp_meth_I
    - meth_rc
    - meth_ic_trp
    - meth_fc_trp
    - meth_i
    - meth_coal
    - meth_coal_ccs
    - meth_ng
    - meth_ng_ccs
    - meth_t_d
    - meth_bal
    - meth_trd
    - meth_exp
    - meth_imp

  addon:
    add:
      - meth_h2

  type_addon:
    add:
      - methanol_synthesis_addon

  map_tec_addon:
    add:
      - [h2_elec, methanol_synthesis_addon]

  cat_addon:
    add:
      - [methanol_synthesis_addon, meth_h2]

  relation:
    add:
      - CO2_PtX_trans_disp_split
      - meth_exp_tot

  balance_equality:
    add:
    - ["methanol","export"]
    - ["methanol","export_fs"]
    - ["methanol","import"]
    - ["methanol","import_fs"]
    - ["methanol","final"]

  emission:
    add:
    - BCA
    - CO
    - HFC
    - OCA
    - NH3
    - SF6
    - VOC

buildings:
  level:
    add:
    - service

  commodity:
    add:
    - floor_area

  technology:
    add:
    - buildings

power_sector:
  unit:
    add:
      - t/kW

# NB this codelist added by #125

# iron-steel:
#   name: Iron and Steel
#   description: Iron is a chemical element with the symbol Fe, while steel is an alloy of iron and carbon and, sometimes, other elements. Measured as the total mass of material.
#   unit: Mt
#
# non-ferrous:
#   name: Non-ferrous metals
#   description: Metals and alloys which do not contain iron. Measured as the total mass of material.
#   unit: Mt
#
# aluminum:
#   name: Aluminum
#   description: Aluminum (or aluminium) is a chemical element with the symbol Al. Measured as the total mass of material.
#   unit: Mt
#   parent: non-ferrous
#
# copper:
#   name: Copper
#   description: Copper is a chemical element with the symbol Cu. Measured as the total mass of material.
#   unit: Mt
#   parent: non-ferrous
#
# minerals:
#   name: Minerals
#   description: Non-metallic minerals are minerals that have no metallic luster, break easily and include, e.g., sand, limestone, marble, clay and salt. Measured as the FE-equivalent mass of material using LCA midpoint characterization factors.
#   unit: MtFe-eq
#
# cement:
#   name: Cement
#   description: Cement is a binder used for construction that sets, hardens, and adheres to other materials to bind them together. Measured as the total mass of material.
#   unit: Mt
#   parent: minerals
#
# chemicals:
#   name: Chemicals
#   description: Industrial chemicals that form the basis of many products. Measured as the total mass of material.
#   unit: Mt
#
# ethylene:
#   name: Ethylene
#   description: Ethylene is a hydrocarbon with the formula C2H4. Measured as the total mass of material.
#   unit: Mt
#   parent: chemicals
#
# ammonia:
#   name: Ammonia
#   description: Ammonia is a compound of nitrogen and hydrogen with the formula NH3. Measured as the total mass of material.
#   unit: Mt
#   parent: chemicals
#
# paper-pulp:
#   name: Paper and pulp for paper
#   description: Pulp is a lignocellulosic fibrous material prepared by chemically or mechanically separating cellulose fibers and the raw material for making paper. Measured as the total mass of material.
#   unit: Mt

Technologies (material/technology.yaml)

# Collection of all material/industry technologies of MESSAGEix-Materials
CH2O_synth:
  description: Synthesis of formaldehyde from methanol via silver-catalyst pathway
  name: Formaldehyde Synthesis

CH2O_to_resin:
  description: Synthesis of formaldehyde resins (proxy chemical phenol-formaldehyde)
  name: Formaldehyde resin synthesis

DUMMY_alumina_supply:
  description: Pseudo technology supplying alumina (aluminum oxide)
  name: Alumina supply

DUMMY_coal_supply:
  description: Pseudo technology supplying coal for steel sector to be used in emissions reporting
  name: Coal supply for steel sector

DUMMY_gas_supply:
  description: Pseudo technology supplying natural gas for steel sector to be used in emissions reporting
  name: Gas supply for steel sector

DUMMY_limestone_supply_cement:
  description: Pseudo technology supplying limestone for cement
  name: Limestone supply for cement sector

DUMMY_limestone_supply_steel:
  description: Pseudo technology supplying limestone for steel
  name: Limestone supply for steel sector

DUMMY_ore_supply:
  description: Pseudo technology supplying iron ore
  name: Iron ore supply for steel sector

MTO_petro:
  description: Methanol-to-Olefins process unit producing ethylene and propylene from methanol
  name: Methanol-to-Olefins

NH3_to_N_fertil:
  description: Nitrogen fertilizer production from ammonia
  name: Nitrogen fertilizer production

agg_ref:
  description: Pseudo technology aggregating petroleum products to light-oil and heavy-oil
  name: Petroleum fuel aggregation

atm_distillation_ref:
  description: First step in the refining process to separate crude oil into its components based on their boiling points
  name: Atmospheric distillation unit

bf_steel:
  description: Blast furnace producing iron from iron ore
  name: Blast furnace

biomass_NH3:
  description: Ammonia synthesis with hydrogen produced from biomass gasification
  name: Ammonia production from biomass

biomass_NH3_ccs:
  description: Ammonia synthesis with hydrogen produced from biomass gasification with CCS
  name: Bioammonia production with CCS

bof_steel:
  description: Type of steelmaking furnace used to convert molten iron produced in a blast furnace into steel
  name: Basic oxygen furnace

catalytic_cracking_ref:
  description: Catalytic cracking converts gas oils with high gasoline yield
  name: Catalytic cracking process unit

catalytic_reforming_ref:
  description: Catalytic reforming used to produce hydrogen from refinery feedstock
  name: Catalytic reforming process unit

clinker_dry_ccs_cement:
  description: Addon technology for clinker_dry_cement capturing process emissions
  name: Dry process clinker kiln CCS addon

clinker_dry_cement:
  description: Clinker kiln using the more efficient dry calcining process
  name: Dry process clinker kiln

clinker_wet_ccs_cement:
  description: Addon technology for clinker_wet_cement capturing process emissions
  name:  Wet process clinker kiln CCS addon

clinker_wet_cement:
  description: Clinker kiln using the less efficient wet calcining process
  name: Wet calcining clinker production

coal_NH3:
  description: Ammonia synthesis with hydrogen from coal gasification
  name: Ammonia production from coal

coal_NH3_ccs:
  description: Ammonia synthesis with hydrogen from coal gasification with CCS
  name: Ammonia production from coal with CCS

cokeoven_steel:
  description: Coke oven transforming coal to coke for steel production
  name: Coke oven for steel production

coking_ref:
  description: Deep conversion technology of refinery upgrading heavy residues of vacuum distillation
  name: Refinery coker process unit

dheat_aluminum:
  description: Low temperature heat from a district heating network for aluminum sector
  name: District heat for aluminum production

dheat_cement:
  description: Low temperature heat from a district heating network for cement sector
  name: District heat for cement production

dheat_petro:
  description: Low temperature heat from a district heating network for petrochemical production
  name: District heat for chemical production

dheat_refining:
  description: Low temperature heat from a district heating network for refineries
  name: District heat for refineries

dheat_resins:
  description: Low temperature heat from a district heating network for resin production
  name: District heat for resin production

dheat_steel:
  description: Low temperature heat from a district heating network for steel sector
  name: District heat for steel production

dri_steel:
  description: Sponge iron production through direct reduction of iron ore
  name: Direct reduction iron process

eaf_steel:
  description: Electric arc furnace for steel making from direct reduced iron or steel scrap
  name: Electric arc furnace

electr_NH3:
  description: Integrated ammonia production facility combining on-site hydrogen electrolyser with ammonia synthesis unit
  name: Ammonia production from electricity

ethanol_to_ethylene_petro:
  description: Ethylene production via ethanol dehydration
  name: Ethanol dehydration

export_NFert:
  description: Pseudo technology representing regional nitrogen fertilizer exports to global market
  name: Nitrogen fertilizer export

export_NH3:
  description: Pseudo technology representing regional ammonia exports to global market
  name: NH3 export

export_aluminum:
  description: Pseudo technology representing regional aluminum exports to global market
  name: Aluminum export

export_petro:
  description: Pseudo technology representing regional HVC exports to global market
  name: HVC export

export_steel:
  description: Pseudo technology representing regional steel exports to global market
  name: Steel export

#FIXME: fuel cells are currently only producing low temp heat, but no electricity
fc_h2_aluminum:
  description: Fuel cell using hydrogen to produce heat for aluminum and electricity
  name: Hydrogen fuel-cell for aluminum process heat

fc_h2_cement:
  description: Fuel cell using hydrogen to produce heat for cement and electricity
  name: Hydrogen fuel-cell for cement process heat

fc_h2_petro:
  description: Fuel cell using hydrogen to produce heat for petrochemicals and electricity
  name: Hydrogen fuel-cell for petrochemicals process heat

fc_h2_refining:
  description: Fuel cell using hydrogen to produce heat for refineries and electricity
  name: Hydrogen fuel-cell for refinery process heat

fc_h2_resins:
  description: Fuel cell using hydrogen to produce heat for resins and electricity
  name: Hydrogen fuel-cell for resin process heat

fc_h2_steel:
  description: Fuel cell using hydrogen to produce heat for steel and electricity
  name: Hydrogen fuel-cell for steel process heat

feedstock_t/d:
  description: Distribution of feedstocks for high value chemicals
  name: Chemical feedstock distribution

finishing_aluminum:
  description: Finishing of aluminum
  name: Aluminum finishing

finishing_steel:
  description: Finishing of steel
  name: Steel finishing

fueloil_NH3:
  description: Ammonia synthesis with hydrogen via partial oxidation of fueloil
  name: Ammonia production from fueloil

fueloil_NH3_ccs:
  description: Ammonia synthesis with hydrogen via partial oxidation of fueloil with CCS
  name: Ammonia production from fueloil with CCS

furnace_biomass_aluminum:
  description: Generalized furnace using biomass to provide process heat for aluminum production
  name: Industrial furnace from biomass for aluminum sector

furnace_biomass_cement:
  description: Generalized furnace using biomass to provide process heat for cement production
  name: Industrial furnace from biomass for cement sector

furnace_biomass_petro:
  description: Generalized furnace using biomass to provide process heat for petrochemical production
  name: Industrial furnace from biomass for petrochemical sector

furnace_biomass_refining:
  description: Generalized furnace using biomass to provide process heat for refineries
  name: Industrial furnace from biomass for refinery sector

furnace_biomass_resins:
  description: Generalized furnace using biomass to provide process heat for resin production
  name: Industrial furnace from biomass for resin sector

furnace_biomass_steel:
  description: Generalized furnace using biomass to provide process heat for steel production
  name: Industrial furnace from biomass for iron/steel sector

furnace_coal_aluminum:
  description: Generalized furnace using coal to provide process heat for aluminum production
  name: Industrial furnace from coal for aluminum sector

furnace_coal_cement:
  description: Generalized furnace using coal to provide process heat for cement production
  name: Industrial furnace from coal for cement sector

furnace_coal_petro:
  description: Generalized furnace using coal to provide process heat for petrochemicals production
  name: Industrial furnace from coal for petrochemicals sector

furnace_coal_refining:
  description: Generalized furnace using coal to provide process heat for refineries
  name: Industrial furnace from coal for refinery sector

furnace_coal_resins:
  description: Generalized furnace using coal to provide process heat for resins production
  name: Industrial furnace from coal for resins sector

furnace_coal_steel:
  description: Generalized furnace using coal to provide process heat for steel production
  name: Industrial furnace from coal for steel sector

furnace_coke_petro:
  description: Generalized furnace using coke to provide process heat for petrochemical production
  name: Industrial furnace from coke for petrochemical sector

furnace_coke_refining:
  description: Generalized furnace using coke to provide process heat for refineries
  name: Industrial furnace from coke for refinery sector

furnace_elec_aluminum:
  description: Generalized furnace using electricity to provide process heat for aluminum production
  name: Industrial furnace using electricity for aluminum sector

furnace_elec_cement:
  description: Generalized furnace using electricity to provide process heat for cement production
  name: Industrial furnace using electricity for cement sector

furnace_elec_petro:
  description: Generalized furnace using electricity to provide process heat for petrochemical production
  name: Industrial furnace using electricity for petrochemical sector

furnace_elec_refining:
  description: Generalized furnace using electricity to provide process heat for refineries
  name: Industrial furnace using electricity for refinery sector

furnace_elec_resins:
  description: Generalized furnace using electricity to provide process heat for resin production
  name: Industrial furnace using electricity for resin sector

furnace_elec_steel:
  description: Generalized furnace using electricity to provide process heat for steel production
  name: Industrial furnace using electricity for steel sector

furnace_ethanol_aluminum:
  description: Generalized furnace using ethanol to provide process heat for aluminum production
  name: Industrial furnace using ethanol for aluminum sector

furnace_ethanol_cement:
  description: Generalized furnace using ethanol to provide process heat for cement production
  name: Industrial furnace using ethanol for cement sector

furnace_ethanol_petro:
  description: Generalized furnace using ethanol to provide process heat for petrochemicals production
  name: Industrial furnace using ethanol for petrochemical sector

furnace_ethanol_refining:
  description: Generalized furnace using ethanol to provide process heat for refineries
  name: Industrial furnace using ethanol for refinery sector

furnace_ethanol_resins:
  description: Generalized furnace using ethanol to provide process heat for resins production
  name: Industrial furnace using ethanol for resins sector

furnace_ethanol_steel:
  description: Generalized furnace using ethanol to provide process heat for steel production
  name: Industrial furnace using ethanol for steel sector

furnace_foil_aluminum:
  description: Generalized furnace using fueloil to provide process heat for aluminum production
  name: Industrial furnace using fueloil for aluminum sector

furnace_foil_cement:
  description: Generalized furnace using fueloil to provide process heat for cement production
  name: Industrial furnace using fueloil for cement sector

furnace_foil_petro:
  description: Generalized furnace using fueloil to provide process heat for petrochemicals production
  name: Industrial furnace using fueloil for petrochemical sector

furnace_foil_refining:
  description: Generalized furnace using fueloil to provide process heat for refineries
  name: Industrial furnace using fueloil for refinery sector

furnace_foil_resins:
  description: Generalized furnace using fueloil to provide process heat for resins production
  name: Industrial furnace using fueloil for resin sector

furnace_foil_steel:
  description: Generalized furnace using fueloil to provide process heat for steel production
  name: Industrial furnace using fueloil for steel sector

furnace_gas_aluminum:
  description: Generalized furnace using gas to provide process heat for aluminum production
  name: Industrial furnace using natural gas for aluminum sector

furnace_gas_cement:
  description: Generalized furnace using gas to provide process heat for cement production
  name: Industrial furnace using natural gas for cement sector

furnace_gas_petro:
  description: Generalized furnace using gas to provide process heat for petrochemicals production
  name: Industrial furnace using natural gas for petrochemical sector

furnace_gas_refining:
  description: Generalized furnace using gas to provide process heat for refineries
  name: Industrial furnace using natural gas for refinery sector

furnace_gas_resins:
  description: Generalized furnace using gas to provide process heat for resins production
  name: Industrial furnace using natural gas for resin sector

furnace_gas_steel:
  description: Generalized furnace using gas to provide process heat for steel production
  name: Industrial furnace using natural gas for steel sector

furnace_h2_aluminum:
  description: Generalized furnace using hydrogen to provide process heat for aluminum production
  name: Industrial furnace using hydrogen for aluminum sector

furnace_h2_cement:
  description: Generalized furnace using hydrogen to provide process heat for cement production
  name: Industrial furnace using hydrogen for cement sector

furnace_h2_petro:
  description: Generalized furnace using hydrogen to provide process heat for petrochemicals production
  name: Industrial furnace using hydrogen for petrochemicals sector

furnace_h2_refining:
  description: Generalized furnace using hydrogen to provide process heat for refineries
  name: Industrial furnace using hydrogen for refinery sector

furnace_h2_resins:
  description: Generalized furnace using hydrogen to provide process heat for resins production
  name: Industrial furnace using hydrogen for resin sector

furnace_h2_steel:
  description: Generalized furnace using hydrogen to provide process heat for steel production
  name: Industrial furnace using hydrogen for steel sector

furnace_loil_aluminum:
  description: Generalized furnace using lightoil to provide process heat for aluminum production
  name: Industrial furnace using lightoil for aluminum sector

furnace_loil_cement:
  description: Generalized furnace using lightoil to provide process heat for cement production
  name: Industrial furnace using lightoil for cement sector

furnace_loil_petro:
  description: Generalized furnace using lightoil to provide process heat for petrochemical production
  name: Industrial furnace using lightoil for petrochemical sector

furnace_loil_refining:
  description: Generalized furnace using lightoil to provide process heat for refineries
  name: Industrial furnace using lightoil for refinery sector

furnace_loil_resins:
  description: Generalized furnace using lightoil to provide process heat for resin production
  name: Industrial furnace using lightoil for resin sector

furnace_loil_steel:
  description: Generalized furnace using lightoil to provide process heat for steel production
  name: Industrial furnace using lightoil for steel sector

furnace_methanol_aluminum:
  description: Generalized furnace using methanol to provide process heat for aluminum production
  name: Industrial furnace using methanol for aluminum sector

furnace_methanol_cement:
  description: Generalized furnace using methanol to provide process heat for cement production
  name: Industrial furnace using methanol for cement sector

furnace_methanol_petro:
  description: Generalized furnace using methanol to provide process heat for petrochemical production
  name: Industrial furnace using methanol for petrochemical sector

furnace_methanol_refining:
  description: Generalized furnace using methanol to provide process heat for refineries
  name: Industrial furnace using methanol for refinery sector

furnace_methanol_resins:
  description: Generalized furnace using methanol to provide process heat for resins production
  name: Industrial furnace using methanol for resin sector

furnace_methanol_steel:
  description: Generalized furnace using methanol to provide process heat for steel production
  name: Industrial furnace using methanol for steel sector

gas_NH3:
  description: Ammonia synthesis with hydrogen via steam reforming of methane
  name: Ammonia production from natural gas

gas_NH3_ccs:
  description: Ammonia synthesis with hydrogen via steam reforming of methane with CCS
  name: Ammonia production from natural gas with CCS

gas_processing_petro:
  description: Processing of raw natural gas to separate gas liquids
  name: Natural gas processing

grinding_ballmill_cement:
  description: Cement grinding using a ballmill
  name: Ballmill cement grinding

grinding_vertmill_cement:
  description: Cement grinding using a vertical mill
  name: Vertical cement grinding

hp_elec_aluminum:
  description: Electric heat pump used to provide process heat for aluminum production
  name: Electric heat pump for aluminum process heat

hp_elec_cement:
  description: Electric heat pump used to provide process heat for cement production
  name: Electric heat pump for cement process heat

hp_elec_petro:
  description: Electric heat pump used to provide process heat for petrochemical production
  name: Electric heat pump for petrochemical process heat

hp_elec_refining:
  description: Electric heat pump used to provide process heat for refinery processes
  name: Electric heat pump for refining process heat

hp_elec_resins:
  description: Electric heat pump used to provide process heat for resin production
  name: Electric heat pump for resins production process heat

hp_elec_steel:
  description: Electric heat pump used to provide process heat for steel production
  name: Electric heat pump for steel process heat

hp_gas_aluminum:
  description: Gas powered heat pump used to provide process heat for aluminum production
  name: Gas powered heat pump for aluminum process heat

hp_gas_cement:
  description: Gas powered heat pump used to provide process heat for cement production
  name: Gas powered heat pump for cement process heat

hp_gas_petro:
  description: Gas powered heat pump used to provide process heat for petrochemical production
  name: Gas powered heat pump for petrochemical process heat

hp_gas_refining:
  description: Gas powered heat pump used to provide process heat for refineries
  name: Gas powered heat pump for refining process heat

hp_gas_resins:
  description: Gas powered heat pump used to provide process heat for resin production
  name: Gas powered heat pump for resin production process heat

hp_gas_steel:
  description: Gas powered heat pump used to provide process heat for steel production
  name: Gas powered heat pump for steel process heat

hydro_cracking_ref:
  description: Hydrocracking unit of a refinery converting gas oils with hydrogen to lighter petroleum products
  name: Hydrocracking

hydrotreating_ref:
  description: Hydrotreating unit of a refinery
  name: Hydrotreating refinery unit

import_NFert:
  description: Pseudo technology representing imports of nitrogen fertilizer from a global pool
  name: Nitrogen fertilizer imports

import_NH3:
  description: Pseudo technology representing imports of ammonia from a global pool
  name: Ammonia import

import_aluminum:
  description: Pseudo technology representing imports of aluminum from a global pool
  name: Aluminum imports

import_petro:
  description: Pseudo technology representing imports of HVCs from a global pool
  name: High Value Chemicals imports

import_steel:
  description: Pseudo technology representing imports of steel from a global pool
  name: Steel imports

manuf_aluminum:
  description: Technology representing the manufacturing steps from crude alu to alu products
  name: Aluminum manufacturing

manuf_steel:
  description: Technology representing the manufacturing steps from crude steel to steel products
  name: Steel products manufacturing

meth_bal:
  description: Pseudo technology moving methanol from primary(_material) to secondary(_material) level
  name: Methanol balance

meth_bio:
  description: Methanol production via biomass gasification
  name: Biomethanol production

meth_bio_ccs:
  description: Methanol production via biomass gasification with CCS
  name: Biomethanol production with CCS

meth_coal:
  description: Methanol production via coal gasification
  name: Methanol production from coal

meth_coal_ccs:
  description: Methanol production via coal gasification with CCS
  name: Methanol production from coal with CCS

meth_exp:
  description: Pseudo technology representing export of methanol to the global pool
  name: Methanol export

meth_h2:
  description: Methanol production from synthetic syngas (H2 and CO2)
  name: Methanol production from hydrogen

meth_imp:
  description: Pseudo technology representing imports of methanol from the global pool
  name: Methanol imports

meth_ng:
  description: Methanol production via steam reforming of natural gas
  name: Methanol production from natural gas

meth_ng_ccs:
  description: Methanol production via steam reforming of natural gas with CCS
  name: Methanol production from gas

meth_t_d:
  description: Pseudo technology moving methanol from secondary to final level
  name: Methanol fuel transport and distribution

meth_t_d_material:
  description: Pseudo technology moving methanol from secondary_material to final_material level
  name: Methanol feedstock transport and distribution

meth_trd:
  description: Pseudo technology representing methanol trade on global markets
  name: Methanol trade

other_EOL_aluminum:
  description: Pseudo technology representing the end-of-life aluminum as a share of production
  name: Aluminum end of life technology

other_EOL_cement:
  description: Pseudo technology representing the end-of-life cement as a share of production
  name: Cement end of life technology

other_EOL_steel:
  description: Pseudo technology representing the end-of-life steel as a share of production
  name: Steel end of life technology

pellet_steel:
  description: Technology to convert fine-grained iron ore concentrates or other iron-bearing materials into small, round pellets
  name: Iron pelletizing technology

prebake_aluminum:
  description: Aluminum production via Hall–Héroult process with prebaked electrodes
  name: Aluminum production with prebaked electrodes

prep_secondary_aluminum_1:
  description: Aluminum recycling preperation technology with lower costs and high quality scrap
  name: Aluminum Recycling Preperation with low cost

prep_secondary_aluminum_2:
  description: Aluminum recycling preperation technology with medium costs and medium quality scrap
  name: Aluminum Recycling Preperation with medium cost

prep_secondary_aluminum_3:
  description: Aluminum recycling preperation technology with high costs and low quality scrap
  name: Aluminum Recycling Preperation with high cost

prep_secondary_steel_1:
  description: Steel recycling preperation technology with lower costs and high quality scrap
  name: Steel Recycling Preperation with low cost

prep_secondary_steel_2:
  description: Steel recycling preperation technology with medium costs and medium quality scrap
  name: Steel Recycling Preperation with medium cost

prep_secondary_steel_3:
  description: Steel recycling preperation technology with high costs and low quality scrap
  name: Steel Recycling Preperation with high cost

production_HVC:
  description: Pseudo technology aggregating all chemicals belong to HVC group to HVC commodity
  name: High Value Chemicals production

raw_meal_prep_cement:
  description: Mixing raw materials to create the homogenous raw meal mixture which serves as the feedstock for the production of cement clinker.
  name: Raw meal preperation

residual_NH3:
  description: Pseudo technology that moves ammonia from level x to level y #TODO: look up levels
  name: Non-fertilizer ammonia production

scrap_recovery_aluminum:
  description: Pseudo technology that represents the collected amount of scrap that goes to recycling
  name: Aluminum scrap collection

scrap_recovery_cement:
  description: Pseudo technology that represents the collected amount of cement waste that goes to recycling
  name: Cement waste collection

scrap_recovery_steel:
  description: Pseudo technology that represents the collected amount of scrap that goes to recycling
  name: Steel scrap collection

secondary_aluminum:
  description: Recycling of aluminum via melting the scrap
  name: Aluminum Recycling

sinter_steel:
  description: Recycling of steel via melting the scrap
  name: Steel Recycling

soderberg_aluminum:
  description: Aluminum production via Hall–Héroult process with Söderberg electrodes
  name: Aluminum production with Söderberg electrodes

solar_aluminum:
  description: Low temperature heat form solar collector collected with ? for aluminum production
  name: Solar heat for aluminum

solar_cement:
  description: Low temperature heat form solar collector used for cement production
  name: Solar heat for cement

solar_petro:
  description: Low temperature heat form solar collector used for petrochemical production
  name: Solar heat for chemicals

solar_refining:
  description: Low temperature heat form solar collector used for refining production
  name: Solar heat for refining

solar_resins:
  description: Low temperature heat form solar collector used for resin production
  name: Solar heat for resins

solar_steel:
  description: Low temperature heat form solar collector used for steel production
  name: Solar heat for steel

steam_cracker_petro:
  description: Most important conventional technology for primary petrochemicals
  name: Steam cracker

total_EOL_aluminum:
  description: Pseudo technology aggregating aluminum scrap after end-of-life
  name: empty

total_EOL_cement:
  description: Pseudo technology collecting cement scrap after end-of-life
  name: empty

total_EOL_steel:
  description: Pseudo technology aggregating steel scrap after end-of-life
  name: empty

trade_NFert:
  description: Pseudo technology representing nitrogen fertilizer trade on global markets
  name: Nitrogen fertilizer trade

trade_NH3:
  description: Pseudo technology representing NH3 trade on global markets
  name: Ammonia trade

trade_aluminum:
  description: Pseudo technology representing aluminum trade on global markets
  name: Aluminum trade

trade_petro:
  description: Pseudo technology representing HVC trade on global markets
  name: High Value Chemicals trade

trade_steel:
  description: Pseudo technology representing steel trade on global markets
  name: Steel trade

vacuum_distillation_ref:
  description: Refinery process distilling heavy residue from atmospheric distillation
  name: Vacuum distillation unit

visbreaker_ref:
  description: Visbreaker unit of a refinery
  name: Visbreaker unit

Commodities (material/commodity.yaml)

# Collection of all material/industry commodities of MESSAGEix-Materials
BTX:
  description: BTX chemcials group consisting of benzene, toluene and xylenes
  name: Aromatics
  report: string
  units: Mt

Fertilizer Use|Nitrogen:
  description: ''
  name: empty
  report: string
  units: Mt

HVC:
  description: High Value Chemicals consisting of ethylene, propylene, butylene and BTX
  name: High Value Chemicals
  report: string
  units: Mt

NH3:
  description: Ammonia
  name: Ammonia
  report: string
  units: Mt

aluminum:
  description: ''
  name: Aluminum
  report: string
  units: Mt

atm_gasoil:
  description: Gas oil yielded from atmospheric distillation
  name: Atmospheric gas oil
  report: string
  units: GWa

atm_residue:
  description: Residue yield from atmospheric distillation
  name: Atmospheric residue
  report: string
  units: GWa

bf_gas:
  description: Gas produced by blast furnace during iron making process
  name: Blast furnace gas
  report: string
  units: GWa

cement:
  description: Cement produced by mixing clinker with ... # TODO: look up process
  name: Cement
  report: string
  units: Mt

clinker_cement:
  description: Clinker required for cement production
  name: Clinker
  report: string
  units: Mt

co_gas:
  description: Gaseous by-product of coke production in coke oven
  name: Coke oven gas
  report: string
  units: GWa

coke_iron:
  description: Coke used for iron production
  name: Coke for iron production
  report: string
  units: GWa

diesel:
  description: Petroleum product mainly used in internal combustion engines
  name: Diesel
  report: string
  units: GWa

ethane:
  description: Alkane with two C atoms mainly used as petrochemical feedstock
  name: Ethane
  report: string
  units: Mt

ethylene:
  description: Most produced petrochemical commodity used as a building block for hundreds of chemicals
  name: Ethylene
  report: string
  units: Mt

fcoh_resin:
  description: Resin type produced by combining formaldehyde and urea (UF), phenol (PF) or melamin (MF)
  name: Formaldehyde resin
  report: string
  units: Mt

floor_area:
  description: ''
  name: empty
  report: string
  units: GWa
 #TODO: check unit

formaldehyde:
  description: Important base chemical used for resins, solvents and other chemicals
  name: Formaldehyde
  report: string
  units: Mt

fresh_water:
  description: ''
  name: empty
  report: string
  units: GWa
 #TODO: check unit

gasoline:
  description: Refined petroleum product mainly used in internal combustion engines
  name: Gasoline
  report: string
  units: GWa

heavy_foil:
  description: Refined petroleum product mainly used as shipping fuel
  name: Heavy fuel oil
  report: string
  units: GWa

ht_heat:
  description: Heat for industrial processes above x°C # TODO: define temperature range for ht_heat and document
  name: High temperature heat
  report: string
  units: GWa

kerosene:
  description: Refined petroleum product mainly used as aviation fuel
  name: Kerosene
  report: string
  units: GWa

light_foil:
  description: '' # TODO: figure out how this product maps to PRELIM/McKinsey Energy Insights/IEA/etc.
  name: empty
  report: string
  units: GWa

limestone_cement:
  description: ''
  name: empty
  report: string
  units: Mt

limestone_iron:
  description: ''
  name: empty
  report: string
  units: Mt

lt_heat:
  description: Heat for industrial processes below x°C # TODO: define temperature range in MESSAGEix-Materials
  name: Low-temperature heat
  report: string
  units: GWa

methanol:
  description: Simplest alcoholic molecule used as fuel and base chemical
  name: Methanol
  report: string
  units: GWa

naphtha:
  description: Distillation fractions and other intermediates in the gasoline boiling range used for gasoline production and petrochemical feedstock
  name: Naphtha
  report: string
  units: GWa

ore_iron:
  description: ''
  name: empty
  report: string
  units: Mt

pellet_iron:
  description: ''
  name: empty
  report: string
  units: Mt

pet_coke:
  description: Coke mainly produced by coking unit process in a refinery
  name: Petroleum coke
  report: string
  units: GWa

pig_iron:
  description: ''
  name: empty
  report: string
  units: Mt

propane:
  description: Alkane with three C atoms mainly used in LPG and as petrochemical feedstock
  name: empty
  report: string
  units: Mt

propylene:
  description: Petrochemical base chemical mainly used for polymer production
  name: Propylene
  report: string
  units: Mt

raw_meal_cement:
  description: ''
  name: empty
  report: string
  units: Mt

refinery_gas:
  description: Off gas yield from various refinery processes consisting mainly of methane and hydrogen
  name: Refinery gas
  report: string
  units: GWa

sinter_iron:
  description: ''
  name: empty
  report: string
  units: Mt

slag_iron:
  description: ''
  name: empty
  report: string
  units: Mt

sponge_iron:
  description: ''
  name: empty
  report: string
  units: Mt

steel:
  description: Steel commodities with varying degree of processing depending on the "level"
  name: Steel
  report: string
  units: Mt

vacuum_gasoil:
  description: Lighter fraction yielded from vacuum distillation
  name: Vacuum Gas Oil (VGO)
  report: string
  units: GWa

vacuum_residue:
  description: Heavy fraction yield from vacuum distillation
  name: Vacuum Residue (VR)
  report: string
  units: GWa

wastewater:
  description: ''
  name: empty
  report: string
  units: GWa
 #TODO: check unit

water:
  description: ''
  name: empty
  report: string
  units: GWa
 #TODO: check unit