Terms from the IAMC template to be implemented by the LOD-GEOSS project

[0UmfHxcvx5J7JoaOhFSs5mncnisTJJ6q]

Description

This originated from the OEO Dev Meeting 11 and inteded to provide an overview of the variables from the "IAMC-Template" (which isn't concretely defined) that should be implemented in the ontology for use with Integrated Assessment Models. As a basis I used the submission template to the scenario data base underlying the IPCC Special Report on Global Warming of 1.5°C. This might be extended with variables from the submission template of the Sixth Assessment Report once it is finalised, but I do not expect much development of the variables in the energy domain.
The submission template covers 540 variables which are subdivided in four tiers (mandatory, high priority, medium priority, other). Variables of the first two tiers (mandatory and a sizeable share of high priority) should be included in the ontology for use within the LOD-GEOSS project.

Tier	Number of Variables
Mandatory	29
High Priority	173
Medium Priority	235
Other	103

Variable definitions are quite orthogonal, with different subdivisions repeating over many top-level variables within specific groups.

---

Mandatory Variables (29 Variables)

Variable	Definition
Final Energy	total final energy consumption by all end-use sectors and all fuels, excluding transmission/distribution losses
Primary Energy	total primary energy consumption (direct equivalent)
Primary Energy|Biomass	primary energy consumption of purpose-grown bioenergy crops, crop and forestry residue bioenergy, municipal solid waste bioenergy, traditional biomass
Primary Energy|Fossil	coal, gas, conventional and unconventional oil primary energy consumption
Primary Energy|Fossil|w/ CCS	coal, gas, conventional and unconventional oil primary energy consumption used in combination with CCS
Primary Energy|Fossil|w/o CCS	coal, gas, conventional and unconventional oil primary energy consumption without CCS
Primary Energy|Coal	coal primary energy consumption
Primary Energy|Gas	gas primary energy consumption
Primary Energy|Nuclear	nuclear primary energy consumption (direct equivalent, includes electricity, heat and hydrogen production from nuclear energy)
Primary Energy|Oil	conventional & unconventional oil primary energy consumption
Primary Energy|Non-Biomass Renewables	non-biomass renewable primary energy consumption (direct equivalent, includes hydro electricity, wind electricity, geothermal electricity and heat, solar electricity and heat and hydrogen, ocean energy)
Secondary Energy|Electricity	total net electricity production
Secondary Energy|Electricity|Biomass	net electricity production from municipal solid waste, purpose-grown biomass, crop residues, forest industry waste, biogas
Secondary Energy|Electricity|Coal	net electricity production from coal
Secondary Energy|Electricity|Gas	net electricity production from natural gas
Secondary Energy|Electricity|Oil	net electricity production from refined liquid oil products
Secondary Energy|Electricity|Nuclear	net electricity production from nuclear energy
Secondary Energy|Electricity|Non-Biomass Renewables	net electricity production from hydro, wind, solar, geothermal, ocean, and other renewable sources (excluding bioenergy). This is a summary category for all the non-biomass renewables.
Secondary Energy|Liquids	total production of refined liquid fuels from all energy sources (incl. oil products, synthetic fossil fuels from gas and coal, biofuels)
Emissions|CO2	total CO2 emissions (not including CCS)
Emissions|CO2|Energy and Industrial Processes	CO2 emissions from energy use on supply and demand side (IPCC category 1A, 1B) and from industrial processes (IPCC categories 2A, B, C, E)
Emissions|CO2|Industrial Processes	CO2 emissions from industrial processes (IPCC categories 2A, B, C, E)
Emissions|CO2|Energy	CO2 emissions from energy use on supply and demand side (IPCC category 1A, 1B)
Carbon Sequestration|CCS	total carbon dioxide emissions captured and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Biomass	total carbon dioxide emissions captured from bioenergy use and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Fossil	total carbon dioxide emissions captured from fossil fuel use and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
GDP|PPP	GDP at purchasing power parity
Price|Carbon	price of carbon (for regional aggregrates the weighted price of carbon by subregion should be used)
Population	total population

HIgh Priority Variables (173 Variables)

Variable	Definition
Final Energy|Electricity	final energy consumption of electricity (including on-site solar PV), excluding transmission/distribution losses
Final Energy|Gases	final energy consumption of gases (natural gas, biogas, coal-gas), excluding transmission/distribution losses
Final Energy|Geothermal	final energy consumption of geothermal energy (e.g., from decentralized or small-scale geothermal heating systems) EXCLUDING geothermal heat pumps
Final Energy|Heat	final energy consumption of heat (e.g., district heat, process heat, warm water), excluding transmission/distribution losses, excluding direct geothermal and solar heating
Final Energy|Hydrogen	final energy consumption of hydrogen, excluding transmission/distribution losses
Final Energy|Liquids	final energy consumption of refined liquids (conventional & unconventional oil, biofuels, coal-to-liquids, gas-to-liquids)
Final Energy|Solar	final energy consumption of solar energy (e.g., from roof-top solar hot water collector systems)
Final Energy|Solids	final energy solid fuel consumption (including coal and solid biomass)
Final Energy|Solids|Biomass	final energy consumption of solid biomass (modern and traditional), excluding final energy consumption of bioliquids which are reported in the liquids category
Final Energy|Solids|Biomass|Traditional	final energy consumption of traditional biomass
Final Energy|Solids|Coal	final energy coal consumption
Final Energy|Industry	final energy consumed by the industrial sector, including feedstocks, including agriculture and fishing
Final Energy|Industry|Electricity	final energy consumption by the industrial sector of electricity (including on-site solar PV), excluding transmission/distribution losses
Final Energy|Industry|Gases	final energy consumption by the industrial sector of gases (natural gas, biogas, coal-gas), excluding transmission/distribution losses
Final Energy|Industry|Heat	final energy consumption by the industrial sector of heat (e.g., district heat, process heat, solar heating and warm water), excluding transmission/distribution losses
Final Energy|Industry|Hydrogen	final energy consumption by the industrial sector of hydrogen
Final Energy|Industry|Liquids	final energy consumption by the industrial sector of refined liquids (conventional & unconventional oil, biofuels, coal-to-liquids, gas-to-liquids)
Final Energy|Industry|Solids	final energy solid fuel consumption by the industrial sector (including coal and solid biomass)
Final Energy|Industry|Other	final energy consumption by the industrial sector of other sources that do not fit to any other category (please provide a definition of the sources in this category in the 'comments' tab)
Final Energy|Residential and Commercial	final energy consumed in the residential & commercial sector
Final Energy|Residential and Commercial|Electricity	final energy consumption by the residential & commercial sector of electricity (including on-site solar PV), excluding transmission/distribution losses
Final Energy|Residential and Commercial|Gases	final energy consumption by the residential & commercial sector of gases (natural gas, biogas, coal-gas), excluding transmission/distribution losses
Final Energy|Residential and Commercial|Heat	final energy consumption by the residential & commercial sector of heat (e.g., district heat, process heat, solar heating and warm water), excluding transmission/distribution losses
Final Energy|Residential and Commercial|Hydrogen	final energy consumption by the residential & commercial sector of hydrogen
Final Energy|Residential and Commercial|Liquids	final energy consumption by the residential & commercial sector of refined liquids (conventional & unconventional oil, biofuels, coal-to-liquids, gas-to-liquids)
Final Energy|Residential and Commercial|Solids	final energy solid fuel consumption by the residential & commercial sector (including coal and solid biomass)
Final Energy|Residential and Commercial|Other	final energy consumption by the residential & commercial sector of other sources that do not fit to any other category (please provide a definition of the sources in this category in the 'comments' tab)
Final Energy|Transportation	final energy consumed in the transportation sector, including bunker fuels, excluding pipelines
Final Energy|Transportation|Electricity	final energy consumption by the transportation sector of electricity (including on-site solar PV), excluding transmission/distribution losses
Final Energy|Transportation|Freight	final energy consumed for freight transportation
Final Energy|Transportation|Gases	final energy consumption by the transportation sector of gases (natural gas, biogas, coal-gas), excluding transmission/distribution losses
Final Energy|Transportation|Hydrogen	final energy consumption by the transportation sector of hydrogen
Final Energy|Transportation|Liquids	final energy consumption by the transportation sector of refined liquids (conventional & unconventional oil, biofuels, coal-to-liquids, gas-to-liquids)
Final Energy|Transportation|Liquids|Biomass	final energy consumption by the transportation sector of liquid biofuels
Final Energy|Transportation|Liquids|Oil	final energy consumption by the transportation sector of liquid oil products (from conventional & unconventional oil)
Final Energy|Non-Energy Use	final energy consumption by the non-combustion processes
Primary Energy|Biomass|Traditional	traditional biomass primary energy consumption
Primary Energy|Biomass|Modern	modern biomass primary energy consumption, including purpose-grown bioenergy crops, crop and forestry residue bioenergy and municipal solid waste bioenergy
Primary Energy|Biomass|Modern|w/ CCS	purpose-grown bioenergy crops, crop and forestry residue bioenergy, municipal solid waste bioenergy, traditional biomass primary energy consumption used in combination with CCS
Primary Energy|Biomass|Modern|w/o CCS	purpose-grown bioenergy crops, crop and forestry residue bioenergy, municipal solid waste bioenergy, traditional biomass primary energy consumption without CCS
Primary Energy|Biomass|Electricity	primary energy input to electricity generation of purpose-grown bioenergy crops, crop and forestry residue bioenergy, municipal solid waste bioenergy, traditional biomass
Primary Energy|Biomass|Electricity|w/ CCS	purpose-grown bioenergy crops, crop and forestry residue bioenergy, municipal solid waste bioenergy, traditional biomass primary energy input to electricity generation used in combination with CCS
Primary Energy|Biomass|Electricity|w/o CCS	purpose-grown bioenergy crops, crop and forestry residue bioenergy, municipal solid waste bioenergy, traditional biomass primary energy input to electricity generation without CCS
Primary Energy|Coal|w/ CCS	coal primary energy consumption used in combination with CCS
Primary Energy|Coal|w/o CCS	coal primary energy consumption without CCS
Primary Energy|Coal|Electricity	coal primary energy input to electricity generation
Primary Energy|Coal|Electricity|w/ CCS	coal primary energy input to electricity generation used in combination with CCS
Primary Energy|Coal|Electricity|w/o CCS	coal primary energy input to electricity generation without CCS
Primary Energy|Gas|w/ CCS	gas primary energy consumption used in combination with CCS
Primary Energy|Gas|w/o CCS	gas primary energy consumption without CCS
Primary Energy|Gas|Electricity	gas primary energy input to electricity generation
Primary Energy|Gas|Electricity|w/ CCS	gas primary energy input to electricity generation used in combination with CCS
Primary Energy|Gas|Electricity|w/o CCS	gas primary energy input to electricity generation without CCS
Primary Energy|Oil|w/ CCS	conventional & unconventional oil primary energy consumption used in combination with CCS
Primary Energy|Oil|w/o CCS	conventional & unconventional oil primary energy consumption without CCS
Primary Energy|Non-Biomass Renewables|Hydro	total hydro primary energy consumption
Primary Energy|Non-Biomass Renewables|Solar	total solar primary energy consumption
Primary Energy|Non-Biomass Renewables|Wind	total wind primary energy consumption
Primary Energy|Non-Biomass Renewables|Geothermal	total geothermal primary energy consumption
Primary Energy|Non-Biomass Renewables|Ocean	total ocean primary energy consumption
Primary Energy|Secondary Energy Trade	trade in secondary energy carriers that cannot be unambiguoulsy mapped to one of the existing primary energy categories (e.g. electricity, hydrogen, fossil synfuels, negative means net exports)
Secondary Energy|Electricity|Biomass|w/ CCS	net electricity production from municipal solid waste, purpose-grown biomass, crop residues, forest industry waste with a CO2 capture component
Secondary Energy|Electricity|Biomass|w/o CCS	net electricity production from municipal solid waste, purpose-grown biomass, crop residues, forest industry waste with freely vented CO2 emissions
Secondary Energy|Electricity|Coal|w/ CCS	net electricity production from coal with a CO2 capture component
Secondary Energy|Electricity|Coal|w/o CCS	net electricity production from coal with freely vented CO2 emissions
Secondary Energy|Electricity|Gas|w/ CCS	net electricity production from natural gas with a CO2 capture component
Secondary Energy|Electricity|Gas|w/o CCS	net electricity production from natural gas with freely vented CO2 emissions
Secondary Energy|Electricity|Oil|w/ CCS	net electricity production from refined liquids with a CO2 capture component
Secondary Energy|Electricity|Oil|w/o CCS	net electricity production from refined liquids with freely vented CO2 emissions
Secondary Energy|Electricity|Hydro	net hydroelectric production
Secondary Energy|Electricity|Solar	net electricity production from all sources of solar energy (e.g., PV and concentrating solar power)
Secondary Energy|Electricity|Wind	net electricity production from wind energy (on- and offshore)
Secondary Energy|Electricity|Geothermal	net electricity production from all sources of geothermal energy (e.g., hydrothermal, enhanced geothermal systems)
Secondary Energy|Electricity|Ocean	net electricity production from ocean energy
Secondary Energy|Liquids|Biomass	total liquid biofuels production
Secondary Energy|Liquids|Biomass|w/ CCS	total liquid biofuels production with CCS
Secondary Energy|Liquids|Biomass|w/o CCS	total liquid biofuels production without CCS
Secondary Energy|Liquids|Coal	total production of fossil liquid synfuels from coal-to-liquids (CTL) technologies
Secondary Energy|Liquids|Coal|w/ CCS	total production of fossil liquid synfuels from coal-to-liquids (CTL) technologies with CCS
Secondary Energy|Liquids|Coal|w/o CCS	total production of fossil liquid synfuels from coal-to-liquids (CTL) technologies without CCS
Secondary Energy|Liquids|Gas	total production of fossil liquid synfuels from gas-to-liquids (GTL) technologies
Secondary Energy|Liquids|Gas|w/ CCS	total production of fossil liquid synfuels from gas-to-liquids (GTL) technologies with CCS
Secondary Energy|Liquids|Gas|w/o CCS	total production of fossil liquid synfuels from gas-to-liquids (GTL) technologies without CCS
Secondary Energy|Liquids|Oil	total production of liquid fuels from petroleum, including both conventional and unconventional sources
Secondary Energy|Solids	solid secondary energy carriers (e.g., briquettes, coke, wood chips, wood pellets)
Secondary Energy|Gases	total production of gaseous fuels, including natural gas
Secondary Energy|Heat	total centralized heat generation
Secondary Energy|Hydrogen	total hydrogen production
Energy Service|Residential and Commercial|Floor Space	annual demand for floor space (and associated energy servide demand for heating and lighting) in residential and commerical buildings
Energy Service|Transportation|Freight	annual demand for energy services related to freight transportation
Energy Service|Transportation|Passenger	annual demand for energy services related to passenger transportation
Emissions|CO2|Energy|Demand	CO2 emissions from fuel combustion in industry (IPCC category 1A2), residential, commercial, institutional sectors and agriculture, forestry, fishing (AFOFI) (IPCC category 1A4a, 1A4b, 1A4c), and transportation sector (IPCC category 1A3), excluding pipeline emissions (IPCC category 1A3ei)
Emissions|CO2|Energy|Demand|Industry	CO2 emissions from fuel combustion in industry (IPCC category 1A2)
Emissions|CO2|Energy|Demand|Residential and Commercial	CO2 emissions from fuel combustion in residential, commercial, institutional sectors (IPCC category 1A4a, 1A4b)
Emissions|CO2|Energy|Demand|Transportation	CO2 emissions from fuel combustion in transportation sector (IPCC category 1A3), excluding pipeline emissions (IPCC category 1A3ei)
Emissions|CO2|Energy|Demand|AFOFI	CO2 emissions from fuel combustion in agriculture, forestry, fishing (AFOFI) (IPCC category 1A4c)
Emissions|CO2|Energy|Supply	CO2 emissions from fuel combustion and fugitive emissions from fuels: electricity and heat production and distribution (IPCC category 1A1a), other energy conversion (e.g. refineries, synfuel production, solid fuel processing, IPCC category 1Ab, 1Ac), incl. pipeline transportation (IPCC category 1A3ei), fugitive emissions from fuels (IPCC category 1B) and emissions from carbon dioxide transport and storage (IPCC category 1C)
Emissions|CO2|Energy|Supply|Electricity	CO2 emissions from electricity and CHP production and distribution (IPCC category 1A1ai and 1A1aii)
Emissions|CO2|AFOLU	CO2 emissions from agriculture, forestry and other land use (IPCC category 3)
Emissions|CH4	total CH4 emissions
Emissions|F-Gases	total F-gas emissions, including sulfur hexafluoride (SF6), hydrofluorocarbons (HFCs), perfluorocarbons (PFCs) (preferably use 100-year GWPs from AR4 for aggregation of different F-gases; in case other GWPs have been used, please document this on the 'comments' tab)
Emissions|N2O	total N2O emissions
Emissions|CO	total CO emissions
Emissions|BC	total black carbon emissions
Emissions|NOx	total NOx emissions
Emissions|OC	total organic carbon emissions
Emissions|Sulfur	total sulfur (SO2) emissions
Emissions|NH3	total ammonium (NH3) emissions
Emissions|VOC	total volatile organic compound (VOC) emissions
Emissions|Kyoto Gases	total Kyoto GHG emissions, including CO2, CH4, N2O and F-gases (preferably use 100-year GWPs from AR4 for aggregation of different gases; in case other GWPs have been used, please document this on the 'comments' tab)
Forcing	radiative forcing from all greenhouse gases and forcing agents, including contributions from albedo change, nitrate, and mineral dust
Forcing|Aerosol	total radiative forcing from aerosols
Forcing|CH4	total radiative forcing from CH4
Forcing|CO2	total radiative forcing from CO2
Forcing|F-Gases	total radiative forcing from F-gases
Forcing|Kyoto Gases	radiative forcing of the six Kyoto gases (CO2, CH4, N2O, SF6, HFCs, PFCs)
Forcing|N2O	total radiative forcing from N2O
Temperature|Global Mean	change in global mean temperature relative to pre-industrial
Concentration|CH4	atmospheric concentration of methane
Concentration|CO2	atmospheric concentration of carbon dioxide
Concentration|N2O	atmospheric concentration of nitrous oxide
Carbon Sequestration|CCS|Biomass|Industrial Processes	total carbon dioxide emissions captured from industrial processes from biomass (e.g., cement production, but not from fossil fuel burning) use and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Biomass|Energy	total carbon dioxide emissions captured from bioenergy use and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Fossil|Industrial Processes	total carbon dioxide emissions captured from industrial processes from fossil fuels (e.g., cement production, but not from fossil fuel burning) use and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Fossil|Energy	total carbon dioxide emissions captured from fossil fuel use and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|Land Use	total carbon dioxide sequestered through land-based sinks (e.g., afforestation, soil carbon enhancement, biochar)
Carbon Sequestration|Land Use|Afforestation	total carbon dioxide sequestered through afforestation
Carbon Sequestration|Feedstocks	total carbon dioxide sequestered in feedstocks (e.g., lubricants, asphalt, plastics)
Carbon Sequestration|Direct Air Capture	total carbon dioxide sequestered through direct air capture
Carbon Sequestration|Enhanced Weathering	total carbon dioxide sequestered through enhanced weathering
Carbon Sequestration|Other	total carbon dioxide sequestered through other techniques (please provide a definition of other sources in this category in the 'comments' tab)
GDP|MER	GDP at market exchange rate
Consumption	total consumption of all goods, by all consumers in a region
Discount rate|Economy	Economy wide discount rate: real interest rate of capital
Discount rate|Social	Social discount rate (should be reported if different from capital interest rate and used in the model to discount future costs and revenues)
Discount rate|Energy Supply	Discount rate for investments in energy supply sector
Discount rate|Electricity	Discount rate for investments in electricity sector
Policy Cost|Additional Total Energy System Cost	additional energy system cost associated with the policy
Policy Cost|Area under MAC Curve	total costs of the policy, i.e. the area under the Marginal Abatement Cost (MAC) curve
Policy Cost|Consumption Loss	consumption loss in a policy scenario compared to the corresponding baseline (losses should be reported as negative numbers)
Policy Cost|Equivalent Variation	equivalent variation associated with the given policy
Policy Cost|GDP Loss	GDP loss in a policy scenario compared to the corresponding baseline (losses should be reported as negative numbers)
Policy Cost|Other	any other indicator of policy cost (e.g., compensated variation). (please indicate what type of policy cost is measured on the 'comments' tab)
Value Added|Industry	value added by industry
Value Added|Commercial	value added by commercial activity
Value Added|Agriculture	value added by agriculture
Population|Rural	total population living in rural areas
Population|Urban	total population living in urban areas
Population|Urban|Share	share of population living in urban areas
Population|Male	total male population
Population|Female	total female population
Food Demand	all food demand in calories (conversion factor: 1 kcal = 4,1868 kJ)
Food Demand|Crops	crop related food demand in calories
Food Demand|Livestock	livestock related food demand in calories
Population|Risk of Hunger	population at risk of hunger, calculated by multipling total population and prevalence of undernourishment which is computed from a probability distribution of daily dietary energy consumption and minimum dietary energy requirement.
Land Cover	total land cover
Land Cover|Cropland	total arable land, i.e. land in non-forest bioenergy crop, food, and feed/fodder crops, as well as other arable land (cultivated area)
Land Cover|Cropland|Energy Crops	land dedicated to 2nd generation energy crops. (e.g., switchgrass, miscanthus, fast-growing wood species)
Land Cover|Forest	managed and unmanaged forest area
Land Cover|Pasture	pasture land. All categories of pasture land - not only high quality rangeland. Based on FAO definition of "permanent meadows and pastures"
Land Cover|Other Arable Land	other arable land that is unmanaged (e.g., grassland, savannah, shrubland), excluding unmanaged forests that are arable
Land Cover|Built-up Area	total built-up land associated with human settlement
Agricultural Demand	total demand for food, non-food and feed products (crops and livestock) and bioenergy crops (1st & 2nd generation)
Agricultural Demand|Crops	total demand for food, non-food and feed crops and bioenergy crops (1st & 2nd generation)
Agricultural Demand|Crops|Energy	demand for modern primary energy crops (1st and 2nd generation)
Agricultural Demand|Livestock	total demand for livestock
Agricultural Production	total production of food, non-food and feed products (crops and livestock) and bioenergy crops (1st & 2nd generation)
Agricultural Production|Non-Energy	total production for food, non-food and feed products (crops and livestock)
Agricultural Production|Energy	total bioenergy-related agricultural production (including waste and residues)
Investment|Energy Supply	investments into the energy supply system
Investment|Energy Supply|Electricity	investments into electricity generation and supply (including electricity storage and transmission & distribution)
Investment|Energy Supply|Electricity|Fossil	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Non-Biomass Renewables	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.

Medium Priority (235 Variables)

Variable	Definition
Final Energy|Industry|Solids|Biomass	final energy consumption by the industry sector of solid biomass
Final Energy|Industry|Solids|Coal	final energy consumption by the industry sector of coal
Final Energy|Residential and Commercial|Solids|Biomass	final energy consumption by the residential & commercial sector of solid biomass (modern and traditional)
Final Energy|Residential and Commercial|Solids|Coal	final energy coal consumption by the residential & commercial sector
Final Energy|Non-Energy Use|Coal	final energy consumption of coal by the non-combustion processes
Final Energy|Non-Energy Use|Oil	final energy consumption of oil by the non-combustion processes
Final Energy|Non-Energy Use|Gas	final energy consumption of gas by the non-combustion processes
Final Energy|Non-Energy Use|Biomass	final energy consumption of biomass by the non-combustion processes
Primary Energy|Other	total other primary energy consumption
Secondary Energy|Electricity|Solar|CSP	net electricity production from concentrating solar power (CSP)
Secondary Energy|Electricity|Solar|PV	net electricity production from solar photovoltaics (PV)
Secondary Energy|Electricity|Wind|Offshore	net electricity production from offshore wind energy
Secondary Energy|Electricity|Wind|Onshore	net electricity production from onshore wind energy
Secondary Energy|Liquids|Other	total production of liquid synfuels from non-fossil and non-biomass sources, e.g. renewable power to liquids technologies
Secondary Energy|Gases|Biomass	total production of biogas
Secondary Energy|Gases|Coal	total production of coal gas from coal gasification
Secondary Energy|Gases|Natural Gas	total production of natural gas
Secondary Energy|Heat|Geothermal	centralized heat generation from geothermal energy EXCLUDING geothermal heat pumps
Secondary Energy|Hydrogen|Biomass	hydrogen production from biomass
Secondary Energy|Hydrogen|Biomass|w/ CCS	hydrogen production from biomass with a CO2 capture component
Secondary Energy|Hydrogen|Biomass|w/o CCS	hydrogen production from biomass with freely vented CO2 emissions
Secondary Energy|Hydrogen|Electricity	hydrogen production from electricity via electrolysis
Secondary Energy|Hydrogen|Fossil	hydrogen production from fossil fuels
Secondary Energy|Hydrogen|Fossil|w/ CCS	hydrogen production from fossil fuels with a CO2 capture component
Secondary Energy|Hydrogen|Fossil|w/o CCS	hydrogen production from fossil fuels with freely vented CO2 emissions
Capacity|Electricity	total installed electricity generation capacity
Capacity|Electricity|Coal	total installed electricity generation capacity of coal power plants
Capacity|Electricity|Gas	total installed electricity generation capacity of gas power plants
Capacity|Electricity|Oil	total installed electricity generation capacity of oil power plants
Capacity|Electricity|Nuclear	total installed electricity generation capacity of nuclear power plants
Capacity|Electricity|Hydro	total installed electricity generation capacity of hydro power plants
Capacity|Electricity|Biomass	total installed electricity generation capacity of biomass power plants
Capacity|Electricity|Wind	total installed electricity generation capacity of wind power installations
Capacity|Electricity|Wind|Onshore	total installed electricity generation capacity of onshore wind power installations
Capacity|Electricity|Wind|Offshore	total installed electricity generation capacity of offshore wind power installations
Capacity|Electricity|Solar	total installed electricity generation capacity of solar power installations
Capacity|Electricity|Solar|PV	total installed electricity generation capacity of PV installations
Capacity|Electricity|Solar|CSP	total installed electricity generation capacity of CSP plants
Capacity|Electricity|Ocean	total installed electricity generation capacity of ocean power plants
Capacity|Electricity|Geothermal	total installed electricity generation capacity of geothermal power plants
Capacity|Electricity|Other	total installed electricity generation capacity of other power plants
Cumulative Capacity|Electricity|Biomass	cumulative installed capacity (since 2005) of biomass power plants
Cumulative Capacity|Electricity|Biomass|w/ CCS	cumulative installed capacity (since 2005) of biomass power plants with CCS.
Cumulative Capacity|Electricity|Biomass|w/o CCS	cumulative installed capacity (since 2005) of biomass power plants without CCS.
Cumulative Capacity|Electricity|Coal	cumulative installed capacity (since 2005) of coal power plants
Cumulative Capacity|Electricity|Coal|w/ CCS	cumulative installed capacity (since 2005) of coal power plants with CCS.
Cumulative Capacity|Electricity|Coal|w/o CCS	cumulative installed capacity (since 2005) of coal power plants without CCS.
Cumulative Capacity|Electricity|Gas	cumulative installed capacity (since 2005) of gas power plants
Cumulative Capacity|Electricity|Gas|w/ CCS	cumulative installed capacity (since 2005) of gas power plants without CCS.
Cumulative Capacity|Electricity|Gas|w/o CCS	cumulative installed capacity (since 2005) of gas power plants with CCS.
Cumulative Capacity|Electricity|Geothermal	cumulative installed capacity (since 2005) of geothermal power plants
Cumulative Capacity|Electricity|Hydro	cumulative installed capacity (since 2005) of hydro power plants
Cumulative Capacity|Electricity|Nuclear	cumulative installed capacity (since 2005) of nuclear power plants
Cumulative Capacity|Electricity|Ocean	cumulative installed capacity (since 2005) of ocean power plants
Cumulative Capacity|Electricity|Oil	cumulative installed capacity (since 2005) of oil power plants
Cumulative Capacity|Electricity|Other	cumulative installed capacity (since 2005) of other power plants
Cumulative Capacity|Electricity|Solar	cumulative installed capacity (since 2005) of solar power installations
Cumulative Capacity|Electricity|Solar|CSP	cumulative installed capacity (since 2005) of CSP plants
Cumulative Capacity|Electricity|Solar|PV	cumulative installed capacity (since 2005) of PV installations
Cumulative Capacity|Electricity|Wind	cumulative installed capacity (since 2005) of wind power installations
Cumulative Capacity|Electricity|Wind|Offshore	cumulative installed capacity (since 2005) of offshore wind power installations
Cumulative Capacity|Electricity|Wind|Onshore	cumulative installed capacity (since 2005) of onshore wind power installations
Energy Service|Transportation|Freight|Aviation	annual demand for energy services related to freight transportation in aviation
Energy Service|Transportation|Freight|Navigation	annual demand for energy services related to freight transportation in navigation
Energy Service|Transportation|Freight|Other	annual demand for energy services related to freight transportation (other)
Energy Service|Transportation|Freight|Railways	annual demand for energy services related to freight transportation in railways
Energy Service|Transportation|Freight|Road	annual demand for energy services related to freight transportation on roads
Energy Service|Transportation|Freight|International Shipping	annual demand for energy services related to freight transportation in international shipping
Energy Service|Transportation|Passenger|Aviation	annual demand for energy services related to passenger transportation in aviation
Energy Service|Transportation|Passenger|Navigation	annual demand for energy services related to passenger transportation in navigation
Energy Service|Transportation|Passenger|Other	annual demand for energy services related to passenger transportation (other)
Energy Service|Transportation|Passenger|Railways	annual demand for energy services related to passenger transportation in railways
Energy Service|Transportation|Passenger|Road	annual demand for energy services related to passenger transportation on roads
Trade|Primary Energy|Biomass|Volume	net exports of solid, unprocessed biomass, at the global level these should add up to the trade losses only
Trade|Primary Energy|Coal|Volume	net exports of coal, at the global level these should add up to the trade losses only
Trade|Primary Energy|Gas|Volume	net exports of natural gas, at the global level these should add up to the trade losses only
Trade|Primary Energy|Oil|Volume	net exports of crude oil, at the global level these should add up to the trade losses only
Trade|Secondary Energy|Electricity|Volume	net exports of electricity, at the global level these should add up to the trade losses only
Trade|Secondary Energy|Hydrogen|Volume	net exports of hydrogen, at the global level these should add up to the trade losses only
Trade|Secondary Energy|Liquids|Biomass|Volume	net exports of liquid biofuels, at the global level these should add up to the trade losses only (for those models that are able to split solid and liquid bioenergy)
Trade|Secondary Energy|Liquids|Coal|Volume	net exports of fossil liquid synfuels from coal-to-liquids (CTL) technologies, at the global level these should add up to the trade losses only
Trade|Secondary Energy|Liquids|Gas|Volume	net exports of fossil liquid synfuels from gas-to-liquids (GTL) technologies, at the global level these should add up to the trade losses only
Trade|Secondary Energy|Liquids|Oil|Volume	net exports of liquid fuels from petroleum including both conventional and unconventional sources, at the global level these should add up to the trade losses only
Emissions|CO2|Energy|Demand|Other Sector	CO2 emissions from fuel combustion in other energy supply sectors (please provide a definition of other sources in this category in the 'comments' tab)
Emissions|CO2|Energy|Supply|Gases	CO2 emissions from fuel combustion and fugitive emissions from fuels: gaseous fuel extraction and processing (e.g. natural gas extraction production, IPCC category 1B2b, parts of 1A1cii)
Emissions|CO2|Energy|Supply|Heat	CO2 emissions from heat production and distribution (IPCC category 1A1aiii)
Emissions|CO2|Energy|Supply|Liquids	CO2 emissions from fuel combustion and fugitive emissions from fuels: liquid fuel extraction and processing (e.g. oil production, refineries, synfuel production, IPCC category 1A1b, parts of 1A1cii, 1B2a)
Emissions|CO2|Energy|Supply|Other Sector	CO2 emissions from fuel combustion in other energy supply sectors (please provide a definition of other sources in this category in the 'comments' tab)
Emissions|CO2|Energy|Supply|Solids	CO2 emissions from fuel combustion and fugitive emissions from fuels: solid fuel extraction and processing (IPCC category 1A1ci, parts of 1A1cii, 1B1)
Emissions|CO2|Other	CO2 emissions from other sources (please provide a definition of other sources in this category in the 'comments' tab)
Emissions|CH4|Energy	CH4 emissions from energy use on supply and demand side, including fugitive emissions from fuels (IPCC category 1A, 1B)
Emissions|CH4|Energy|Demand|Industry	CH4 emissions from fuel combustion in industry (IPCC category 1A2)
Emissions|CH4|Energy|Demand|Residential and Commercial	CH4 emissions from fuel combustion in residential, commercial, institutional sectors (IPCC category 1A4a, 1A4b)
Emissions|CH4|Energy|Demand|Transportation	CH4 emissions from fuel combustion in transportation sector (IPCC category 1A3), excluding pipeline emissions (IPCC category 1A3ei)
Emissions|CH4|Energy|Supply	CH4 emissions from fuel combustion and fugitive emissions from fuels: electricity and heat production and distribution (IPCC category 1A1a), other energy conversion (e.g. refineries, synfuel production, solid fuel processing, IPCC category 1Ab, 1Ac), incl. pipeline transportation (IPCC category 1A3ei), fugitive emissions from fuels (IPCC category 1B) and emissions from carbon dioxide transport and storage (IPCC category 1C)
Emissions|CH4|AFOLU	CH4 emissions from agriculture, forestry and other land use (IPCC category 3)
Emissions|CH4|Other	CH4 emissions from other sources (please provide a definition of other sources in this category in the 'comments' tab)
Emissions|N2O|Energy	N2O emissions from energy use on supply and demand side, including fugitive emissions from fuels (IPCC category 1A, 1B)
Emissions|N2O|AFOLU	N2O emissions from agriculture, forestry and other land use (IPCC category 3)
Emissions|N2O|Other	N2O emissions from other sources (please provide a definition of other sources in this category in the 'comments' tab)
Emissions|CO|Energy	carbon monoxide emissions from energy use on supply and demand side, including fugitive emissions from fuels (IPCC category 1A, 1B)
Emissions|CO|Energy|Demand|Industry	carbon monoxide emissions from Combustion in industry (IPCC 1A2) and industrial processes (IPCC 2C1-2C5)
Emissions|CO|Energy|Demand|Residential and Commercial	carbon monoxide emissions from Combustion in Residential and Commercial/Institutional Sectors (IPCC 1A4A, 1A4B)
Emissions|CO|Energy|Demand|Transportation	carbon monoxide emissions from Combustion in Transportation Sector (IPCC category 1A3)
Emissions|CO|Energy|Supply	carbon monoxide emissions from Extraction and Distribution of Fossil Fuels (including fugitive emissions, IPCC category 1B); Electricity production and distribution, district heating and other energy conversion (e.g. refineries, synfuel production)
Emissions|CO|AFOLU	Land Use based carbon monoxide emissions
Emissions|CO|Other	carbon monoxide emissions from other energy end-use sectors that do not fit to any other category (please provide a definition of the sectors in this category in the 'comments' tab)
Emissions|BC|Energy	black carbon emissions from energy use on supply and demand side, including fugitive emissions from fuels (IPCC category 1A, 1B)
Emissions|BC|Energy|Demand|Industry	black carbon emissions from fuel combustion in industry (IPCC category 1A2)
Emissions|BC|Energy|Demand|Residential and Commercial	black carbon emissions from fuel combustion in residential, commercial, institutional sectors and agriculture (IPCC category 1A4a, 1A4b)
Emissions|BC|Energy|Demand|Transportation	black carbon emissions from fuel combustion in transportation sector (IPCC category 1A3), excluding pipeline emissions (IPCC category 1A3ei)
Emissions|BC|Energy|Supply	black carbon emissions from fuel combustion and fugitive emissions from fuels: electricity and heat production and distribution (IPCC category 1A1a), other energy conversion (e.g. refineries, synfuel production, solid fuel processing, IPCC category 1Ab, 1Ac), incl. pipeline transportation (IPCC category 1A3ei), fugitive emissions from fuels (IPCC category 1B) and emissions from carbon dioxide transport and storage (IPCC category 1C)
Emissions|BC|AFOLU	black carbon emissions from agriculture, forestry and other land use (IPCC category 3)
Emissions|BC|Other	black carbon emissions from other sources (please provide a definition of other sources in this category in the 'comments' tab)
Emissions|NOx|Energy	NOx emissions from energy use on supply and demand side, including fugitive emissions from fuels (IPCC category 1A, 1B)
Emissions|NOx|Energy|Demand|Industry	NOx emissions from fuel combustion in industry (IPCC category 1A2)
Emissions|NOx|Energy|Demand|Residential and Commercial	NOx emissions from fuel combustion in residential, commercial, institutional sectors (IPCC category 1A4a, 1A4b)
Emissions|NOx|Energy|Demand|Transportation	NOx emissions from fuel combustion in transportation sector (IPCC category 1A3), excluding pipeline emissions (IPCC category 1A3ei)
Emissions|NOx|Energy|Supply	NOx emissions from fuel combustion and fugitive emissions from fuels: electricity and heat production and distribution (IPCC category 1A1a), other energy conversion (e.g. refineries, synfuel production, solid fuel processing, IPCC category 1Ab, 1Ac), incl. pipeline transportation (IPCC category 1A3ei), fugitive emissions from fuels (IPCC category 1B) and emissions from carbon dioxide transport and storage (IPCC category 1C)
Emissions|NOx|AFOLU	NOx emissions from agriculture, forestry and other land use (IPCC category 3)
Emissions|NOx|Other	NOx emissions from other sources (please provide a definition of other sources in this category in the 'comments' tab)
Emissions|OC|Energy	organic carbon emissions from energy use on supply and demand side, including fugitive emissions from fuels (IPCC category 1A, 1B)
Emissions|OC|Energy|Demand|Industry	organic carbon emissions from fuel combustion in industry (IPCC category 1A2)
Emissions|OC|Energy|Demand|Residential and Commercial	organic carbon emissions from fuel combustion in residential, commercial, institutional sectors (IPCC category 1A4a, 1A4b)
Emissions|OC|Energy|Demand|Transportation	organic carbon emissions from fuel combustion in transportation sector (IPCC category 1A3), excluding pipeline emissions (IPCC category 1A3ei)
Emissions|OC|Energy|Supply	organic carbon emissions from fuel combustion and fugitive emissions from fuels: electricity and heat production and distribution (IPCC category 1A1a), other energy conversion (e.g. refineries, synfuel production, solid fuel prorganic carbonessing, IPCC category 1Ab, 1Ac), incl. pipeline transportation (IPCC category 1A3ei), fugitive emissions from fuels (IPCC category 1B) and emissions from carbon dioxide transport and storage (IPCC category 1C)
Emissions|OC|AFOLU	organic carbon emissions from agriculture, forestry and other land use (IPCC category 3)
Emissions|OC|Other	organic carbon emissions from other sources (please provide a definition of other sources in this category in the 'comments' tab)
Emissions|Sulfur|Energy	sulfur emissions from energy use on supply and demand side, including fugitive emissions from fuels (IPCC category 1A, 1B)
Emissions|Sulfur|Energy|Demand|Industry	sulfur emissions from fuel combustion in industry (IPCC category 1A2)
Emissions|Sulfur|Energy|Demand|Residential and Commercial	sulfur emissions from fuel combustion in residential, commercial, institutional sectors (IPCC category 1A4a, 1A4b)
Emissions|Sulfur|Energy|Demand|Transportation	sulfur emissions from fuel combustion in transportation sector (IPCC category 1A3), excluding pipeline emissions (IPCC category 1A3ei)
Emissions|Sulfur|Energy|Supply	sulfur emissions from fuel combustion and fugitive emissions from fuels: electricity and heat production and distribution (IPCC category 1A1a), other energy conversion (e.g. refineries, synfuel production, solid fuel processing, IPCC category 1Ab, 1Ac), incl. pipeline transportation (IPCC category 1A3ei), fugitive emissions from fuels (IPCC category 1B) and emissions from carbon dioxide transport and storage (IPCC category 1C)
Emissions|Sulfur|AFOLU	sulfur emissions from agriculture, forestry and other land use (IPCC category 3)
Emissions|Sulfur|Other	sulfur emissions from other sources (please provide a definition of other sources in this category in the 'comments' tab)
Emissions|SF6	total emissions of sulfur hexafluoride (SF6)
Emissions|PFC	total emissions of perfluorocarbons (PFCs), provided as aggregate CF4-equivalents
Emissions|HFC	total emissions of hydrofluorocarbons (HFCs), provided as aggregate HFC134a-equivalents
Forcing|Tropospheric Ozone	total radiative forcing from tropospheric ozone
Forcing|Montreal Gases	total radiative forcing from Montreal gases
Carbon Sequestration|CCS|Biomass|Energy|Demand|Industry	total carbon dioxide emissions captured from bioenergy use in industry (IPCC category 1A2) and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Biomass|Energy|Supply	total carbon dioxide emissions captured from bioenergy use and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Biomass|Energy|Supply|Electricity	total carbon dioxide emissions captured from bioenergy use in electricity production (part of IPCC category 1A1a) and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Fossil|Energy|Demand|Industry	total carbon dioxide emissions captured from fossil fuel use in industry (IPCC category 1A2) and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Fossil|Energy|Supply	total carbon dioxide emissions captured from fossil fuel use in energy supply (IPCC category 1A) and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Fossil|Energy|Supply|Electricity	total carbon dioxide emissions captured from fossil fuel use in electricity production (part of IPCC category 1A1a) and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|Land Use|Biochar	total carbon dioxide sequestered through biochar
Carbon Sequestration|Land Use|Soil Carbon Management	total carbon dioxide sequestered through soil carbon management techniques
Carbon Sequestration|Land Use|Other	total carbon dioxide sequestered through other land-based mitigation techniques
Carbon Sequestration|Feedstocks|Biomass	total carbon dioxide sequestered in feedstocks from biomass (e.g., lubricants, asphalt, plastics)
Carbon Sequestration|Feedstocks|Fossil	total carbon dioxide sequestered in feedstocks from fossil (e.g., lubricants, asphalt, plastics)
Discount rate|Mobility	Discount rate for investments into mobility (e.g. vehicles; not including transport infrastructure)
Discount rate|Transport Infrastructure	Discount rate for investments into transport infrastructure (roads, railways, ports, airports, waterways etc.)
Discount rate|Industry	Discount rate for investments into industrial installations in industry sector
Discount rate|Buildings	Discount rate for investments into residential and commercial buildings
Price|Primary Energy|Biomass	biomass producer price
Price|Primary Energy|Coal	coal price at the primary level (i.e. the spot price at the global or regional market)
Price|Primary Energy|Gas	natural gas price at the primary level (i.e. the spot price at the global or regional market)
Price|Primary Energy|Oil	crude oil price at the primary level (i.e. the spot price at the global or regional market)
Price|Secondary Energy|Electricity	electricity price at the secondary level, i.e. for large scale consumers (e.g. aluminum production). Prices should include the effect of carbon prices.
Price|Secondary Energy|Gases|Natural Gas	natural gas price at the secondary level, i.e. for large scale consumers (e.g. gas power plant). Prices should include the effect of carbon prices.
Price|Secondary Energy|Hydrogen	hydrogen price at the secondary level. Prices should include the effect of carbon prices
Price|Secondary Energy|Liquids	liquid fuel price at the secondary level, i.e. petrol, diesel, or weighted average
Price|Secondary Energy|Liquids|Biomass	biofuel price at the secondary level, i.e. for biofuel consumers
Price|Secondary Energy|Liquids|Oil	light fuel oil price at the secondary level, i.e. for large scale consumers (e.g. oil power plant). Prices should include the effect of carbon prices.
Price|Secondary Energy|Solids|Biomass	biomass price at the secondary level, i.e. for large scale consumers (e.g. biomass power plant). Prices should include the effect of carbon prices.
Price|Secondary Energy|Solids|Coal	coal price at the secondary level, i.e. for large scale consumers (e.g. coal power plant). Prices should include the effect of carbon prices.
Price|Final Energy|Residential|Electricity	electricity price at the final level in the residential sector. Prices should include the effect of carbon prices.
Price|Final Energy|Residential|Gases|Natural Gas	natural gas price at the final level in the residential sector. Prices should include the effect of carbon prices.
Price|Final Energy|Residential|Liquids|Biomass	biofuel price at the final level in the residential sector. Prices should include the effect of carbon prices.
Price|Final Energy|Residential|Liquids|Oil	light fuel oil price at the final level in the residential sector. Prices should include the effect of carbon prices.
Price|Final Energy|Residential|Solids|Biomass	biomass price at the final level in the residential sector. Prices should include the effect of carbon prices.
Price|Final Energy|Residential|Solids|Coal	coal price at the final level in the residential sector. Prices should include the effect of carbon prices.
Price|Agriculture|Non-Energy Crops and Livestock|Index	weighted average price index of non-energy crops and livestock products
Price|Agriculture|Non-Energy Crops|Index	weighted average price index of non-energy crops
Price|Agriculture|Livestock|Index	weighted average price index of livestock
Employment	number of employed inhabitants (based on ILO classification)
Unemployment	number of unemployed inhabitants (based on ILO classification)
Unemployment|Rate	fraction of unemployed inhabitants (based on ILO classification)
Employment|Agriculture	number of employed inhabitants (payrolls) in agriculture (based on ILO classification)
Employment|Industry	number of employed inhabitants (payrolls) in industry (based on ILO classification)
Employment|Service	number of employed inhabitants (payrolls) in the service sector (based on ILO classification)
Food Energy Supply	total calory food demand
Food Energy Supply|Livestock	calory food demand from livestock products
Subsidies|Energy	total energy-related subsidies
Subsidies|Energy|Fossil	fossil fuel subsidies
Subsidies|Food	food subsidies (both to producers and consumers)
Land Cover|Cropland|Cereals	land dedicated to cereal crops: wheat, rice and coarse grains (maize, corn, millet, sorghum, barley, oats, rye)
Land Cover|Cropland|Irrigated	irrigated arable land, i.e. land in non-forest bioenergy crop, food, and feed/fodder crops, as well as other arable land (cultivated area)
Land Cover|Forest|Afforestation and Reforestation	area with afforestation and reforestation
Land Cover|Forest|Managed	managed forests producing commercial wood supply for timber or energy (note: woody energy crops reported under "energy crops")
Land Cover|Forest|Natural Forest	undisturbed natural forests, modified natural forests and regrown secondary forests
Agricultural Demand|Crops|Feed	total demand for feed crops
Agricultural Demand|Crops|Food	total demand for food crops
Agricultural Demand|Crops|Other	total demand for other crops
Agricultural Demand|Livestock|Food	total demand for food livestock
Agricultural Demand|Livestock|Other	total demand for other livestock
Water Consumption	total water consumption
Water Consumption|Industrial Water	water consumption for the industrial sector
Water Consumption|Municipal Water	water consumption for the municipal sector (e.g., houses, offices, municipal irrigation)
Water Consumption|Irrigation	water consumption for the irrigation
Water Consumption|Livestock	water consumption for livestock
Water Consumption|Electricity	total water consumption for net electricity production
Water Consumption|Extraction	total water consumption for extraction
Water Withdrawal	total water withdrawal
Water Withdrawal|Industrial Water	water withdrawals for the industrial sector (manufacturing sector if also reporting energy sector water use)
Water Withdrawal|Municipal Water	water withdrawals for the municial sector (e.g., houses, offices, municipal irrigation)
Water Withdrawal|Livestock	water withdrawals for livestock
Water Withdrawal|Electricity	total water withdrawals for net electricity production
Water Withdrawal|Extraction	total water withdrawal for extraction
Freshwater|Environmental Flow	water allocated to environmental flow in rivers and groundwater systems
Population|Drinking Water Access	population with access to improved drinking water sources (by income level)
Population|Sanitation Access	population with access to improved sanitation (by income level)
Investment|Energy Supply|Extraction|Fossil	investments for all types of fossil extraction
Investment|Energy Supply|Electricity|Coal	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Coal|w/ CCS	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Coal|w/o CCS	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Gas	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Gas|w/ CCS	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Gas|w/o CCS	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Non-fossil	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Biomass	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Biomass|w/ CCS	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Biomass|w/o CCS	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Nuclear	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Hydro	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Solar	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Wind	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Hydrogen	investments for the production of hydrogen
Investment|Energy Supply|Liquids	investments for the production of liquid fuels. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Liquids|Oil	investments for the production of fossil fuels from oil refineries For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Liquids|Coal and Gas	investments for the production of fossil-based synfuels (coal and gas). For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Liquids|Biomass	investments for the production of biofuels. These should not include the costs of the feedstock. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|CO2 Transport and Storage	investment in CO2 transport and storage (note that investment in the capturing equipment should be included along with the power plant technology)
Investment|Energy Efficiency	investments into the efficiency-increasing components of energy demand technologies

Other (103 Variables)

Variable	Definition
Emissions|NH3|Energy	ammonia emissions from energy use on supply and demand side, including fugitive emissions from fuels (IPCC category 1A, 1B)
Emissions|NH3|Energy|Demand|Industry	ammonia Emissions from Combustion in industry (IPCC 1A2) and industrial processes (IPCC 2C1-2C5)
Emissions|NH3|Energy|Demand|Residential and Commercial	ammonia Emissions from Combustion in Residential and Commercial/Institutional Sectors (IPCC 1A4A, 1A4B)
Emissions|NH3|Energy|Demand|Transportation	ammonia Emissions from Combustion in Transportation Sector (IPCC category 1A3)
Emissions|NH3|Energy|Supply	ammonia Emissions from Extraction and Distribution of Fossil Fuels (including fugitive Emissions, IPCC category 1B); Electricity production and distribution, district heating and other energy conversion (e.g. refineries, synfuel production)
Emissions|NH3|AFOLU	land use based ammonia Emissions
Emissions|NH3|Other	ammonia Emissions from other energy end-use sectors that do not fit to any other category (please provide a definition of the sectors in this category in the 'comments' tab)
Emissions|VOC|Energy	volatile organic compounds emissions from energy use on supply and demand side, including fugitive emissions from fuels (IPCC category 1A, 1B)
Emissions|VOC|Energy|Demand|Industry	volatile organic compounds Emissions from Combustion in industry (IPCC 1A2) and industrial processes (IPCC 2C1-2C5)
Emissions|VOC|Energy|Demand|Residential and Commercial	volatile organic compounds Emissions from Combustion in Residential and Commercial/Institutional Sectors (IPCC 1A4A, 1A4B)
Emissions|VOC|Energy|Demand|Transportation	volatile organic compounds Emissions from Combustion in Transportation Sector (IPCC category 1A3)
Emissions|VOC|Energy|Supply	volatile organic compounds Emissions from Extraction and Distribution of Fossil Fuels (including fugitive Emissions, IPCC category 1B); Electricity production and distribution, district heating and other energy conversion (e.g. refineries, synfuel production)
Emissions|VOC|AFOLU	land use based volatile organic compounds Emissions
Emissions|VOC|Other	volatile organic compounds Emissions from other energy end-use sectors that do not fit to any other category (please provide a definition of the sectors in this category in the 'comments' tab)
Emissions|PFC|C2F6	total emissions of C2F6
Emissions|PFC|C6F14	total emissions of CF6F14
Emissions|PFC|CF4	total emissions of CF4
Emissions|HFC|HFC125	total emissions of HFC125
Emissions|HFC|HFC134a	total emissions of HFC134a
Emissions|HFC|HFC143a	total emissions of HFC143a
Emissions|HFC|HFC227ea	total emissions of HFC227ea
Emissions|HFC|HFC23	total emissions of HFC23
Emissions|HFC|HFC245fa	total emissions of HFC245fa
Emissions|HFC|HFC32	total emissions of HFC32
Emissions|HFC|HFC43-10	total emissions of HFC343-10
Forcing|Aerosol|BC	total radiative forcing from black carbon
Forcing|Aerosol|Black and Organic Carbon	total radiative forcing from black and organic carbon
Forcing|Aerosol|Cloud Indirect	total radiative forcing from indirect effects of aerosols on clouds
Forcing|Aerosol|OC	total radiative forcing from organic carbon
Forcing|Aerosol|Other	total radiative forcing from aerosols not covered in the other categories (including aerosols from biomass burning)
Forcing|Aerosol|Sulfate Direct	total radiative forcing from direct sufate effects
Forcing|Albedo Change and Mineral Dust	total radiative forcing from albedo change and mineral dust
Forcing|Other	total radiative forcing from factors not covered in other categories (including stratospheric ozone and stratospheric water vapor)
Carbon Sequestration|CCS|Biomass|Energy|Supply|Gases	total carbon dioxide emissions captured from bioenergy use in gaseous fuel production, excl. hydrogen (part of IPCC category 1A) and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Biomass|Energy|Supply|Hydrogen	total carbon dioxide emissions captured from bioenergy use in hydrogen production (part of IPCC category 1A) and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Biomass|Energy|Supply|Liquids	total carbon dioxide emissions captured from bioenergy use in liquid fuel production (part of IPCC category 1A) and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Biomass|Energy|Supply|Other	total carbon dioxide emissions captured from bioenergy use in other energy supply (part of IPCC category 1A) and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Fossil|Energy|Supply|Gases	total carbon dioxide emissions captured from fossil fuel use in gaseous fuel production, excl. hydrogen (part of IPCC category 1A) and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Fossil|Energy|Supply|Hydrogen	total carbon dioxide emissions captured from fossil fuel use in hydrogen production (part of IPCC category 1A) and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Fossil|Energy|Supply|Liquids	total carbon dioxide emissions captured from fossil fuel use in liquid fuel production (part of IPCC category 1A) and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Carbon Sequestration|CCS|Fossil|Energy|Supply|Other	total carbon dioxide emissions captured from fossil fuel use in other energy supply (part of IPCC category 1A) and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers
Value Added|Industry|Energy	value added by industry related to the energy sector
Value Added|Industry|Manufacturing	value added by industry related to maunfacturing
Value Added|Industry|Energy Intensive	value added by industry related to the energy-intensive industries
Price|Agriculture|Soybean|Index	price index of soybean
Price|Agriculture|Corn|Index	price index of corn
Price|Agriculture|Wheat|Index	price index of wheat
Price|Agriculture|Rice|Index	price index of rice
Population|Working Age	total working age population (age 15-65 years)
Land Cover|Other Land	other land cover that does not fit into any other category (e.g., rock, ice, desert, water, please provide a definition of the sources in this category in the 'comments' tab)
Agricultural Production|Non-Energy|Crops	total production for food, non-food and feed products (crops)
Agricultural Production|Non-Energy|Livestock	total production for livestock products
Agricultural Production|Energy|Crops	production for modern primary energy crops (1st and 2nd generation)
Agricultural Production|Energy|Residues	production of agricultural residues for modern bioenergy production
Water Desalination	amount of water desalination
Investment|Energy Supply|Extraction|Coal	investments for extraction and conversion of coal. These should include mining, shipping and ports
Investment|Energy Supply|Extraction|Gas	investments for extraction and conversion of natural gas. These should include upstream, LNG chain and transmission and distribution
Investment|Energy Supply|Extraction|Oil	investments for extraction and conversion of oil. These should include upstream, transport and refining
Investment|Energy Supply|Electricity|Oil	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Oil|w/ CCS	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Oil|w/o CCS	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Geothermal	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Ocean	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Other	investments in new power generation for the specified power plant category. If the model features several sub-categories, the total investments should be reported. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Electricity|Transmission and Distribution	investments in transmission and distribution of power generation
Investment|Energy Supply|Electricity|Electricity Storage	investments in electricity storage technologies (e.g., batteries, compressed air storage reservoirs, etc.)
Investment|Energy Supply|Hydrogen|Fossil	investments for the production of hydrogen from fossil fuels. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Hydrogen|Biomass	investments for the production of hydrogen from the specified source.
Investment|Energy Supply|Hydrogen|Electricity	investments for the production of hydrogen by electrolysis
Investment|Energy Supply|Hydrogen|Other	investments for the production of hydrogen from biomass. For plants equipped with CCS, the investment in the capturing equipment should be included but not the one on transport and storage.
Investment|Energy Supply|Heat	investments in heat generation facilities
Investment|Energy Supply|Other	investments in other types of energy conversion facilities
Capital Cost|Electricity|Biomass|w/ CCS	capital cost of a new biomass power plant with CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Electricity|Biomass|w/o CCS	capital cost of a new biomass power plant w/o CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Electricity|Coal|w/ CCS	capital cost of a new coal power plant with CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Electricity|Coal|w/o CCS	capital cost of a new coal power plant w/o CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Electricity|Gas|w/ CCS	capital cost of a new gas power plant with CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Electricity|Gas|w/o CCS	capital cost of a new gas power plant w/o CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Electricity|Geothermal	capital cost of a new geothermal power plant. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Electricity|Hydro	capital cost of a new hydropower plant. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Electricity|Nuclear	capital cost of a new nuclear power plants. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Electricity|Solar|CSP	capital cost of a new concentrated solar power plant. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Electricity|Solar|PV	capital cost of a new solar PV units. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Electricity|Wind|Offshore	capital cost of a new offshore wind power plants. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Electricity|Wind|Onshore	capital cost of a new onshore wind power plants. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Gases|Biomass|w/ CCS	capital cost of a new biomass to gas plant with CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Gases|Biomass|w/o CCS	capital cost of a new biomass to gas plant w/o CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Gases|Coal|w/ CCS	capital cost of a new coal to gas plant with CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Gases|Coal|w/o CCS	capital cost of a new coal to gas plant w/o CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Hydrogen|Biomass|w/ CCS	capital cost of a new biomass to hydrogen plant with CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Hydrogen|Biomass|w/o CCS	capital cost of a new biomass to hydrogen plant w/o CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Hydrogen|Coal|w/ CCS	capital cost of a new coal to hydrogen plant with CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Hydrogen|Coal|w/o CCS	capital cost of a new coal to hydrogen plant w/o CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Hydrogen|Electricity	capital cost of a new hydrogen-by-electrolysis plant. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Hydrogen|Gas|w/ CCS	capital cost of a new gas to hydrogen plant with CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Hydrogen|Gas|w/o CCS	capital cost of a new gas to hydrogen plant w/o CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Liquids|Biomass|w/ CCS	capital cost of a new biomass to liquids plant with CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Liquids|Biomass|w/o CCS	capital cost of a new biomass to liquids plant w/o CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Liquids|Coal|w/ CCS	capital cost of a new coal to liquids plant with CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Liquids|Coal|w/o CCS	capital cost of a new coal to liquids plant w/o CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Liquids|Gas|w/ CCS	capital cost of a new gas to liquids plant with CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Liquids|Gas|w/o CCS	capital cost of a new gas to liquids plant w/o CCS. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.
Capital Cost|Liquids|Oil	capital cost of a new oil refining plant. If more than technology in this category is modelled, modellers should report capital costs for the technology that is used most; please specify the technology name/characteristics in the comments.

[Vera-IER]

We also just converted some of our model output data in this IAMC format for another project. So for the LOD GEOSS prototyp I can also give the intended output data in this format (but we added some variables).

I think all these variables don't need to be implemented in the ontology individually. For exapmle for "Primary energy|coal/gas/oil" I would use the term primary energy (which is not included yet) and assemble it with the term coal ,gas or oil, which is implemented under portion of matter.

[0UmfHxcvx5J7JoaOhFSs5mncnisTJJ6q]

We also just converted some of our model output data in this IAMC format for another project. So for the LOD GEOSS prototyp I can also give the intended output data in this format (but we added some variables).

So you have seen the light :) What data did you report?

I think all these variables don't need to be implemented in the ontology individually.

Gosh, I hope this is true. The potentials OpenEnergyPlatform/ontology#481 didn't raise my hopes in this regards …

For exapmle for "Primary energy|coal/gas/oil" I would use the term primary energy (which is not included yet) and assemble it with the term coal ,gas or oil, which is implemented under portion of matter.

Do you know how this ("assembling") works? So far I haven't been able to get any answers regarding the use of the ontology.

I wonder how unambiguous primary energy ∩ coal is. I think it would be contrary to the idea of an ontology if it were just an undocumented convention for that to mean "coal primary energy consumption". So in my view there has to be some "ontological" mechanism to achieve this, else it's lots of new classes – an probably a script to spell them out.

[Vera-IER]

What data did you report?

We will report the final energy consumptions, the capacities, the secondary energy|electricity|..., and the emissions.

Do you know how this ("assembling") works?

I think this is done with the relations between classes of the ontology. I understood that a user of the ontology can add relations for their specific needs in between classes, even if they aren't implemented yet. But someone from @OpenEnergyPlatform/oeo-general-expert-formal-ontology can propably answer this question better than me.

[jannahastings]

I wonder how unambiguous primary energy ∩ coal is.

You would not use an intersection for this -- logically, the intersection of primary energy and coal is empty since nothing is an instance of both of these classes. Rather, you would model an explicit relationship or other logical axiom that formally captured the meaning of the "defined class" (what Vera calls assembled). Assuming that you want to define a class primary energy consumption from coal, then I would imagine that has input might be a good candidate relationship, in which case the formal definition for primary energy consumption from coal, a subclass of primary energy consumption, would be 'primary energy consumption' and 'has input' some coal

[0UmfHxcvx5J7JoaOhFSs5mncnisTJJ6q]

So you are describing adding a new class to the ontology. As I understood Vera, her approach was to link data items (e.g. our variable Primary Energy|Coal) to more than one class from the ontology (what she called "assembling").

I understood that a user of the ontology can add relations for their specific needs in between classes

I read that as

• "a user of the ontology" : which is not an ontology developer and therefore does not change the ontology, e.g. by adding classes
• "can add relations […] between classes": again, not within the ontology, but within the metadata that is generated to annotate data with the ontology
• "for their specific needs": e.g. my need to tag the SR15 data with OEO

but maybe I got that wrong.
In any case these are two different approaches as to how the ontology is used. Are both viable?

And again, a real-world example of some data (any data, really) that is annotated by an ontology (any ontology, really) would be very handy.

[jannahastings]

Yes, there are two approaches. Technically these two approaches are called "pre-composition" (adding new classes to the ontology for combinations of existing classes) and "post-composition" (using combinations of ontology classes on-the-fly in annotations). You can read a nice description of the difference in this paper: https://www.ncbi.nlm.nih.gov/pmc/articles/PMC2847714/.

At the stage where the OEO is currently at in its development (it is not so large an ontology) and tool support available for our users (we do not have a budget to develop custom tools to support all use cases), I would recommend that we add classes to the OEO for all the terms needed for annotations (i.e. using the pre-composed approach) because this reduces the burden on the users for adoption.

[Vera-IER]

Thank you for the clarification! I thought both options can be easily realised.

So in this example we would have the class primary energy consumption and some relationships like
primary energy consumption has input some coal
primary energy consumption has input some gas
and so on. So I understand that these relationships are subclasses of primary enery consumption and I can choose if I want to use a relation at all or I can choose just one of the existing relations as a user of the ontology? Is this correct?

[stap-m]

Thank you for the clarification! I thought both options can be easily realised.

Me too. I always thought we should better not flush the OEO with all these subclasses if users can use relations. But I understand that for users it might be more comfortable with the pre-composed approach at this state...

primary energy consumption has input some coal

we have the brand new has physical input now ;) The generic relation primary energy consumption has physical input some primary energy carrier should be implemented. Own issue for that?

@0UmfHxcvx5J7JoaOhFSs5mncnisTJJ6q the first two mandatory entries are "Final Energy" and "Primary Energy". According to the def it is similar to final energy consumption and primary energy consumption respectively. From your point of view, what is needed to satisfy the IAMC template requirements?

• just leave it like that, maybe add synonyms final energy and primary energy?
• create subclasses e.g. final energy according to IAMC as subclass of final energy consumption, specifying the definition (see above)?
• ...?

[0UmfHxcvx5J7JoaOhFSs5mncnisTJJ6q]

final energy consumption: Final energy consumption is the consumption of energy delivered to and consumed by end users.
and
Final Energy: total final energy consumption by all end-use sectors and all fuels, excluding transmission/distribution losses
match up and can be used as is.

There's a material difference between the definitions of primary energy consumption in the ontology and Primary Energy, as used in the IAMC, in that the former excludes non-energy use and the latter includes it. So that is a no-go.
primary energy consumtion: Primary energy consumption is the total consumption of energy in a spatial region excluding the non-energetic use of fuels.
Primary Energy: total primary energy consumption (direct equivalent)

So maybe we should distinguish between PE excluding non-energy use (PE according to Eurostat) and PE including non-energy use (PE according to UNSTATS).
Provided that we know models that actually use the Eurostat definition @OpenEnergyPlatform/oeo-domain-expert-energy-modelling because to me that looks like a bookkeeper's definition, not like that of a modeller.

[Vera-IER]

We use Eurostat and AG Energiebilanzen to calibrate the TIMES PanEU model. These statistics report energy consumption excluding non-energy uses. So I would vote for distinguishing between those two reporting options.
The same problem can arise when defining Final energy|Industry. We define it excluding non-energy uses, some models define it including the non energetic fuel uses.

[l-emele]

How do we proceed with this long meta issue? I suggest adding an additional column in the long table indicating what is there and what is missing.

[0UmfHxcvx5J7JoaOhFSs5mncnisTJJ6q]

Out of the 29 mandatory variables I would judge two to be implemented in usable form.

	Variable	Definition	OEO IRI	Notes
✓	Final Energy	total final energy consumption by all end-use sectors and all fuels, excluding transmission/distribution losses	final energy consumption
✓	Population	total population	population
✗	Primary Energy	total primary energy consumption (direct equivalent)	gross inland energy consumption	OEO is ambiguous as to whether direct equivalent/physical energy content/partial substitution are used to compute primary energy of non-fuels. See https://www.iea.org/statistics-questionnaires-faq. It comes down to whether 1 EJ of electricity from e.g. wind is credited with 1 EJ primary energy wind, 1.7 EJ primary energy wind (using the 60 % efficiency of the wind turbine), or 2.5 EJ primary energy wind (using the 40 % efficiency of the conventional power plant fleet that would have to replace the wind turbines).
✗	Primary Energy|Biomass	primary energy consumption of purpose-grown bioenergy crops, crop and forestry residue bioenergy, municipal solid waste bioenergy, traditional biomass		ibid.
✗	Primary Energy|Fossil	coal, gas, conventional and unconventional oil primary energy consumption		ibid.
✗	Primary Energy|Fossil|w/ CCS	coal, gas, conventional and unconventional oil primary energy consumption used in combination with CCS		ibid.
✗	Primary Energy|Fossil|w/o CCS	coal, gas, conventional and unconventional oil primary energy consumption without CCS		ibid.
✗	Primary Energy|Coal	coal primary energy consumption		ibid.
✗	Primary Energy|Gas	gas primary energy consumption		ibid.
✗	Primary Energy|Nuclear	nuclear primary energy consumption (direct equivalent, includes electricity, heat and hydrogen production from nuclear energy)		ibid.
✗	Primary Energy|Oil	conventional & unconventional oil primary energy consumption		ibid.
✗	Primary Energy|Non-Biomass Renewables	non-biomass renewable primary energy consumption (direct equivalent, includes hydro electricity, wind electricity, geothermal electricity and heat, solar electricity and heat and hydrogen, ocean energy)		ibid.
✗	Secondary Energy|Electricity	total net electricity production		secondary energy production has no subdivision by energy carrier classes
✗	Secondary Energy|Electricity|Biomass	net electricity production from municipal solid waste, purpose-grown biomass, crop residues, forest industry waste, biogas		ibid.
✗	Secondary Energy|Electricity|Coal	net electricity production from coal		ibid.
✗	Secondary Energy|Electricity|Gas	net electricity production from natural gas		ibid.
✗	Secondary Energy|Electricity|Oil	net electricity production from refined liquid oil products		ibid.
✗	Secondary Energy|Electricity|Nuclear	net electricity production from nuclear energy		ibid.
✗	Secondary Energy|Electricity|Non-Biomass Renewables	net electricity production from hydro, wind, solar, geothermal, ocean, and other renewable sources (excluding bioenergy). This is a summary category for all the non-biomass renewables.		ibid.
✗	Secondary Energy|Liquids	total production of refined liquid fuels from all energy sources (incl. oil products, synthetic fossil fuels from gas and coal, biofuels)		ibid.
✗	Emissions|CO2	total CO2 emissions (not including CCS)		carbon dioxide equivalent quantity 'has quantity value' some 'emission quantity value' (as in “MtCO2eq”) but has no reference to time (as in “per year”) and is not specific to CO2 either
✗	Emissions|CO2|Energy and Industrial Processes	CO2 emissions from energy use on supply and demand side (IPCC category 1A, 1B) and from industrial processes (IPCC categories 2A, B, C, E)		ibid.
✗	Emissions|CO2|Industrial Processes	CO2 emissions from industrial processes (IPCC categories 2A, B, C, E)		ibid.
✗	Emissions|CO2|Energy	CO2 emissions from energy use on supply and demand side (IPCC category 1A, 1B)		ibid.
✗	Carbon Sequestration|CCS	total carbon dioxide emissions captured and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers	carbon capture and storage	a process without any attribute denoting magnitude (as in MtCO2/year)
✗	Carbon Sequestration|CCS|Biomass	total carbon dioxide emissions captured from bioenergy use and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers		ibid.
✗	Carbon Sequestration|CCS|Fossil	total carbon dioxide emissions captured from fossil fuel use and stored in geological deposits (e.g. in depleted oil and gas fields, unmined coal seams, saline aquifers) and the deep ocean, stored amounts should be reported as positive numbers		ibid.
✗	GDP|PPP	GDP at purchasing power parity	gross domestic product	both GDP and PPP are subclasses of economic value; not sure how to combine them
✗	Price|Carbon	price of carbon (for regional aggregrates the weighted price of carbon by subregion should be used)	emission certificate price	A carbon price might be implemented as a tax instead. There is carbon tax, but the IAMC template is agnostic towards the implementation of the carbon price.

[l-emele]

OEO is ambiguous as to whether direct equivalent/physical energy content/partial substitution are used to compute primary energy of non-fuels. See https://www.iea.org/statistics-questionnaires-faq. It comes down to whether 1 EJ of electricity from e.g. wind is credited with 1 EJ primary energy wind, 1.7 EJ primary energy wind (using the 60 % efficiency of the wind turbine), or 2.5 EJ primary energy wind (using the 40 % efficiency of the conventional power plant fleet that would have to replace the wind turbines).

Seems you need a special type of primary energy consumption. We can define a subclass for that.

Regarding the combined classes: We probably cannot include every combined concept, but there is also option of post composition. For example Emission|CO2 can be expressed as 'emission quantity value' 'quantity value of' some ('greenhouse gas emission value' 'process attribute of' some ('greenhouse gas emission' 'has participant' some 'carbon dioxide')). I know, that is not very nice, but at least it is possible.

[0UmfHxcvx5J7JoaOhFSs5mncnisTJJ6q]

I know of post composition, but not about it. Has its technical realisation been discussed in one of the OEO dev meetings?

[l-emele]

What is the state of this issue? Last comment is more than 1½ years. Is it still planned to align the IAMC template and the OEO? If not, I suggest to close this issue.

EDIT: If this the IAMC alignment is still on the agenda, the IAMC terms are a good candicates for the planned OEO composed module.

[chrwm]

A majority of the composed concepts can be implemented here. Thus, I transferred the issue.