Add primary-energy and final-energy variables based on ENGAGE & NAVIGATE

definitions/variable/energy/final-energy.yaml

@@ -0,0 +1,128 @@
+# Aggregate variables
+- Final Energy:
+    description: Final energy consumption by all end-use sectors and all fuels,
+      excluding transmission/distribution losses, including non-energy use
+    unit: EJ/yr
+- Final Energy (w/o bunkers):
+    description: Final energy consumption by all end-use sectors and all fuels,
+      excluding transmission/distribution losses, including non-energy use,
+      excluding international bunker fuels
+    unit: EJ/yr
+
+# Non-energy use
+- Final Energy|Non-Energy Use:
+    description: Final energy consumption in non-combustion processes
+    unit: EJ/yr
+- Final Energy|Non-Energy Use|{Secondary Fuel}:
+    description: Final energy consumption of {Secondary Fuel} in non-combustion processes
+    unit: EJ/yr
+- Final Energy|Non-Energy Use|Waste:
+    description: Final energy consumption of non-renewable waste in non-combustion processes
+    unit: EJ/yr
+- Final Energy|Non-Energy Use|Other:
+    description: Final energy consumption of other feedstocks in non-combustion processes
+    unit: EJ/yr
+- Final Energy|Non-Energy Use|{Non-Energy Sector}:
+    description: Final energy consumption by the {Non-Energy Sector} for non-combustion processes
+    unit: EJ/yr
+- Final Energy|Non-Energy Use|{Non-Energy Sector}|{Secondary Fuel}:
+    description: Final energy consumption of {Secondary Fuel} by the {Non-Energy Sector}
+      for non-combustion processes
+    unit: EJ/yr
+- Final Energy|Non-Energy Use|{Non-Energy Sector}|Waste:
+    description: Final energy consumption of non-renewable waste by the {Non-Energy Sector}
+      for non-combustion processes
+    unit: EJ/yr
+- Final Energy|Non-Energy Use|{Non-Energy Sector}|Other:
+    description: Final energy consumption of other feedstocks by the {Non-Energy Sector}
+      for non-combustion processes
+    unit: EJ/yr
+
+# Final energy by fuel
+- Final Energy|Electricity:
+    description: Final energy consumption of electricity (including on-site solar PV),
+      excluding transmission/distribution losses
+    unit: EJ/yr
+- Final Energy|{Secondary Fuel}:
+    description: Final energy fuel consumption of {Secondary Fuel}
+    unit: EJ/yr
+- Final Energy|Geothermal:
+    description: Final energy consumption of geothermal energy (e.g., from decentralized
+      or small-scale geothermal heating systems) excluding geothermal heat pumps
+    unit: EJ/yr
+- Final Energy|Waste:
+    description: Final energy consumption of non-renewable waste
+    unit: EJ/yr
+- Final Energy|Solar:
+    description: Final energy consumption of solar-thermal heat
+      (e.g., from roof-top solar hot water collector systems)
+    unit: EJ/yr
+- Final Energy|Other:
+    description: Final energy consumption of other energy sources
+    unit: EJ/yr
+
+# Final energy by sector and fuel
+- Final Energy|{Sector}:
+    description: Final energy consumption by the {Sector}
+    unit: EJ/yr
+- Final Energy|{Sector}|Electricity:
+    description: Final energy consumption by the agriculture sector of electricity
+    unit: EJ/yr
+- Final Energy|{Sector}|{Secondary Fuel}:
+    description: Final energy consumption by the agriculture sector of {Secondary Fuel}
+    unit: EJ/yr
+- Final Energy|{Sector}|Other:
+    description: Final energy consumption by the industrial sector of other energy sources
+    unit: EJ/yr
+
+# specific additional combinations of sector and energy-carriers
+- Final Energy|Industry|Geothermal:
+    description: Final energy consumption by the industrial sector of geothermal heat
+    unit: EJ/yr
+- Final Energy|Industry|Waste:
+    description: Final energy consumption of non-renewable waste by the industrial sector
+    unit: EJ/yr
+
+# additional variable for bunkers
+- Final Energy|Bunkers|International Shipping:
+    description: Final energy consumption of bunker fuels for international shipping
+    unit: EJ/yr
+- Final Energy|Bunkers|International Aviation:
+    description: Final energy consumption of bunker fuels for international aviation
+    unit: EJ/yr
+- Final Energy|Bunkers|Passenger:
+    description: Final energy consumption of bunker fuels for passenger transport
+    unit: EJ/yr
+- Final Energy|Bunkers|Passenger|International Shipping:
+    description: Final energy consumption of bunker fuels for passenger transport on
+      international shipping
+    unit: EJ/yr
+- Final Energy|Bunkers|Passenger|International Aviation:
+    description: Final energy consumption of bunker fuels for passenger transport on
+      international aviation
+    unit: EJ/yr
+- Final Energy|Bunkers|Freight:
+    description: Final energy consumption of bunker fuels for freight transport
+    unit: EJ/yr
+- Final Energy|Bunkers|Freight|International Shipping:
+    description: Final energy consumption of bunker fuels for freight transport on
+      international shipping
+    unit: EJ/yr
+- Final Energy|Bunkers|Freight|International Aviation:
+    description: Final energy consumption of bunker fuels for freight transport on
+      international aviation
+    unit: EJ/yr
+
+# additional variables for the water sector
+- Final Energy|Commercial|Water|Desalination:
+    description: Energy consumption for water desalination
+    unit: EJ/yr
+- Final Energy|Commercial|Water|Groundwater Extraction:
+    description: Energy consumption for groundwater extraction
+    unit: EJ/yr
+- Final Energy|Commercial|Water|Surface Water Extraction:
+    description: Energy consumption for surface water extraction
+    unit: EJ/yr
+- Final Energy|Commercial|Water|Transfer:
+    description: Energy consumption for water transfers
+    unit: EJ/yr

definitions/variable/energy/primary-energy.yaml

@@ -0,0 +1,100 @@
+- Primary Energy:
+    description: Total primary energy consumption (direct equivalent)
+    unit: EJ/yr
+
+- Primary Energy|Biomass:
+    description: Primary energy consumption of purpose-grown bioenergy crops, crop
+      and forestry residue, municipal solid waste bioenergy and traditional biomass
+    unit: EJ/yr
+- Primary Energy|Biomass|{CCS}:
+    description: Primary energy consumption of purpose-grown bioenergy crops, crop
+      and forestry residue, municipal solid waste bioenergy and traditional biomass {CCS}
+    unit: EJ/yr
+- Primary Energy|Biomass|Modern:
+    description: Primary energy consumption of modern biomass, including purpose-grown
+      bioenergy crops, crop and forestry residue and municipal solid waste bioenergy
+    unit: EJ/yr
+- Primary Energy|Biomass|Modern|{CCS}:
+    description: Primary energy consumption of modern biomass, including purpose-grown
+      bioenergy crops, crop and forestry residue and municipal solid waste bioenergy {CCS}
+    unit: EJ/yr
+- Primary Energy|Biomass|Traditional:
+    description: Primary energy consumption of traditional biomass
+    unit: EJ/yr
+- Primary Energy|Biomass|1st Generation:
+    description: Primary energy consumption from 1st generation biofuel crops
+      (e.g., sugar cane, rapeseed oil, maize, sugar beet)
+    unit: EJ/yr
+- Primary Energy|Biomass|Energy Crops:
+    description: Primary energy consumption from purpose-grown bioenergy crops
+    unit: EJ/yr
+- Primary Energy|Biomass|Residues:
+    description: Primary energy consumption from residues
+    unit: EJ/yr
+- Primary Energy|Biomass|Electricity:
+    description: Primary energy input of biomass for electricity generation
+    unit: EJ/yr
+- Primary Energy|Biomass|Electricity|{CCS}:
+    description: Primary energy input of biomass for electricity generation {CCS}
+    unit: EJ/yr
+- Primary Energy|Biomass|{Secondary Fuel}:
+    description: Primary energy input of biomass for conversion to {Secondary Fuel}
+    unit: EJ/yr
+- Primary Energy|Biomass|{Secondary Fuel}|{CCS}:
+    description: Primary energy input of biomass for conversion to {Secondary Fuel} {CCS}
+    unit: EJ/yr
+
+- Primary Energy|Non-Biomass Renewables:
+    description: Primary energy consumption of renewable energy exluding biomass
+    unit: EJ/yr
+- Primary Energy|{Non-Biomass Renewables}:
+    description: Primary energy consumption of {Non-Biomass Renewables}
+    unit: EJ/yr
+
+- Primary Energy|Nuclear:
+    description: Primary energy consumption of nuclear power (direct equivalent),
+      includes electricity, heat and hydrogen production from nuclear energy)
+    unit: EJ/yr
+
+- Primary Energy|Fossil:
+    description: Primary energy consumption of fossil fuels including coal, natural gas
+      and conventional/unconventional oil
+    unit: EJ/yr
+- Primary Energy|Fossil|{CCS}:
+    description: Primary energy consumption of fossil fuels including coal, natural gas
+      and conventional/unconventional oil {CCS}
+    unit: EJ/yr
+- Primary Energy|{Primary Fossil Fuel}:
+    description: Primary energy consumption of {Primary Fossil Fuel}
+    unit: EJ/yr
+- Primary Energy|{Primary Fossil Fuel}|{CCS}:
+    description: Primary energy consumption of {Primary Fossil Fuel} {CCS}
+    unit: EJ/yr
+- Primary Energy|{Primary Fossil Fuel}|Electricity:
+    description: Primary energy consumption of {Primary Fossil Fuel}
+      for electricity generation
+    unit: EJ/yr
+- Primary Energy|{Primary Fossil Fuel}|Electricity|{CCS}:
+    description: Primary energy consumption of {Primary Fossil Fuel}
+      for electricity generation {CCS}
+    unit: EJ/yr
+- Primary Energy|{Primary Fossil Fuel}|{Secondary Fuel}:
+    description: Primary energy consumption of {Primary Fossil Fuel}
+      for conversion to {Secondary Fuel}
+    unit: EJ/yr
+- Primary Energy|{Primary Fossil Fuel}|{Secondary Fuel}|{CCS}:
+    description: Primary energy consumption of {Primary Fossil Fuel} for
+      conversion to {Secondary Fuel} {CCS}
+    unit: EJ/yr
+
+- Primary Energy|Secondary Energy Trade:
+    description: Primary energy consumption from trade in secondary energy carriers that
+      cannot be unambiguoulsy mapped to one of the existing primary energy categories,
+      e.g. electricity, hydrogen
+    note: Negative values indicate net exports of an energy carrier
+    unit: EJ/yr
+
+- Primary Energy|Other:
+    description: Primary energy consumption from sources that do not fit any other
+      category (direct equivalent)
+    unit: EJ/yr

definitions/variable/energy/tag_all_sectors.yaml

@@ -0,0 +1,63 @@
+- Sector:
+    - Agriculture:
+        description: agriculture sector including fishing
+    - Industry:
+        description: industrial sector excluding non-energy use (e.g.feedstocks)
+    - Industry|Iron and Steel:
+        description: iron and steel sector excluding feedstocks
+    - Industry|Non-Ferrous Metals:
+        description: non-ferrous metals sector
+    - Industry|Non-Metallic Minerals:
+        description: non-metallic minerals sector
+    - Industry|Chemicals:
+        description: chemicals sector excluding feedstocks
+    - Industry|Chemicals|Ammonia:
+        description: ammonia sector
+    - Industry|Chemicals|Methanol:
+        description: menthanol sector
+    - Industry|Chemicals|High Value Chemicals:
+        description: high-value-chemicals sector
+    - Industry|Cement:
+        description: cement sector
+    - Industry|Plastics:
+        description: plastics sector
+    - Industry|Pulp and Paper:
+        description: other industrial sectors
+    - Industry|Other Sector:
+        description: other industrial sectors
+    - Residential:
+        description: residential sector
+    - Commercial:
+        description: commercial sector
+    - Residential and Commercial:
+        description: residential and commercial sector
+    - Transportation:
+        description: transportation sector excluding bunker fuels
+    - Transportation (w/ bunkers):
+        description: transportation sector including bunker fuels
+    - Transportation|Bus:
+        description: transportation sector by bus
+    - Transportation|Light Duty Vehicle:
+        description: transportation sector with light-duty vehicles
+    - Transportation|Truck:
+        description: trucking sector
+    - Transportation|Rail:
+        description: rail transportation sector
+    - Transportation|Domestic Aviation:
+        description: domestic aviation sector
+    - Transportation|Domestic Shipping:
+        description: domestic shipping sector
+    - Transportation|Passenger:
+        description: passenger transportation sector
+    - Transportation|Freight:
+        description: passenger transportation sector
+    - Bunkers:
+        description: bunker-fuels sector
+    - Carbon Removal:
+        description: carbon dioxide removal processes
+    - Carbon Removal|Direct Air Capture:
+        description: direct air capture sector
+    - Carbon Removal|Enhanced Weathering:
+        description: enhanced weathering sector
+    - Other Sector:
+        description: other sectors

definitions/variable/energy/tag_ccs.yaml

@@ -0,0 +1,5 @@
+- CCS:
+    - w/ CCS:
+        description: in combination with CCS
+    - w/o CCS:
+        description: without CCS

definitions/variable/energy/tag_non_biomass_renewables.yaml

@@ -0,0 +1,11 @@
+- Non-Biomass Renewables:
+    - Hydro:
+        description: hydropower
+    - Solar:
+        description: solar energy
+    - Wind:
+        description: wind power
+    - Geothermal:
+        description: geothermal sources
+    - Ocean:
+        description: oceans

definitions/variable/energy/tag_non_energy_sectors.yaml

@@ -0,0 +1,13 @@
+- Non-Energy Sector:
+    - Iron and Steel:
+        description: iron and steel sector
+    - Non-Ferrous Metals:
+        description: non-ferrous metals sector
+    - Non-Metallic Minerals:
+        description: non-metallic minerals sector
+    - Chemicals:
+        description: chemical sector
+    - Pulp and Paper:
+        description: pulp and paper sector
+    - Other Sector:
+        description: other industries

definitions/variable/energy/tag_primary_fossil_energy_carriers.yaml

@@ -0,0 +1,7 @@
+- Primary Fossil Fuel:
+    - Coal:
+        description: coal including lignite
+    - Oil:
+        description: conventional and unconventional crude oil
+    - Gas:
+        description: natural gas (fossil methane)

definitions/variable/energy/tag_secondary_energy_carriers.yaml

@@ -0,0 +1,13 @@
+- Secondary Fuel:
+    # Electricity is treated separately
+    - Liquids:
+        description: liquid fuels (conventional & unconventional oil, biofuels,
+          coal-to-liquids, gas-to-liquids)
+    - Solids:
+        description: solid fuels
+    - Gases:
+        description: gaseous fuels not including hydrogen
+    - Hydrogen:
+        description: hydrogen
+    - Heat:
+        description: heat