From cdccf53e02b9cdf53ed7af7b82704608060619bf Mon Sep 17 00:00:00 2001 From: Daniel Huppmann Date: Thu, 20 Jul 2023 14:58:43 +0200 Subject: [PATCH 1/4] Add primary energy variables --- .../variable/energy/primary-energy.yaml | 84 +++++++++++++++++++ definitions/variable/energy/tag_ccs.yaml | 5 ++ .../energy/tag_non_biomass_renewables.yaml | 11 +++ .../tag_primary_fossil_energy_carriers.yaml | 7 ++ .../energy/tag_secondary_energy_carriers.yaml | 13 +++ definitions/variable/variable.yaml | 3 - 6 files changed, 120 insertions(+), 3 deletions(-) create mode 100644 definitions/variable/energy/primary-energy.yaml create mode 100644 definitions/variable/energy/tag_ccs.yaml create mode 100644 definitions/variable/energy/tag_non_biomass_renewables.yaml create mode 100644 definitions/variable/energy/tag_primary_fossil_energy_carriers.yaml create mode 100644 definitions/variable/energy/tag_secondary_energy_carriers.yaml delete mode 100644 definitions/variable/variable.yaml diff --git a/definitions/variable/energy/primary-energy.yaml b/definitions/variable/energy/primary-energy.yaml new file mode 100644 index 00000000..761fd2f7 --- /dev/null +++ b/definitions/variable/energy/primary-energy.yaml @@ -0,0 +1,84 @@ +- 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|{Secondary Fuel}: + description: Primary energy input of biomass for {Secondary Fuel} + unit: EJ/yr +- Primary Energy|Biomass|{Secondary Fuel}|{CCS}: + description: Primary energy input of biomass for {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}|{Secondary Fuel}: + description: Primary energy consumption of {Primary Fossil Fuel} for {Secondary Fuel} + unit: EJ/yr +- Primary Energy|{Primary Fossil Fuel}|{Secondary Fuel}|{CCS}: + description: Primary energy consumption of {Primary Fossil Fuel} for {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 diff --git a/definitions/variable/energy/tag_ccs.yaml b/definitions/variable/energy/tag_ccs.yaml new file mode 100644 index 00000000..d3abbbad --- /dev/null +++ b/definitions/variable/energy/tag_ccs.yaml @@ -0,0 +1,5 @@ +- CCS: + - w/ CCS: + description: in combination with CCS + - w/o CCS: + description: without CCS diff --git a/definitions/variable/energy/tag_non_biomass_renewables.yaml b/definitions/variable/energy/tag_non_biomass_renewables.yaml new file mode 100644 index 00000000..2d032484 --- /dev/null +++ b/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 diff --git a/definitions/variable/energy/tag_primary_fossil_energy_carriers.yaml b/definitions/variable/energy/tag_primary_fossil_energy_carriers.yaml new file mode 100644 index 00000000..ecca2bd6 --- /dev/null +++ b/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) diff --git a/definitions/variable/energy/tag_secondary_energy_carriers.yaml b/definitions/variable/energy/tag_secondary_energy_carriers.yaml new file mode 100644 index 00000000..a640a34b --- /dev/null +++ b/definitions/variable/energy/tag_secondary_energy_carriers.yaml @@ -0,0 +1,13 @@ +- Secondary Fuel: + - Electricity: + description: electricity generation + - Liquids: + description: conversion to liquid fuels + - Solids: + description: conversion to solid fuels + - Gases: + description: conversion to gaseous fuels not including hydrogen + - Hydrogen: + description: conversion to hydrogen + - Heat: + description: heat generation diff --git a/definitions/variable/variable.yaml b/definitions/variable/variable.yaml deleted file mode 100644 index e5a870ef..00000000 --- a/definitions/variable/variable.yaml +++ /dev/null @@ -1,3 +0,0 @@ -- Primary Energy: - description: Total primary energy consumption (direct equivalent) - unit: EJ/yr From 7ab5bedec93d22c25c963ec81b459ebfd64af9c1 Mon Sep 17 00:00:00 2001 From: Daniel Huppmann Date: Thu, 20 Jul 2023 15:43:57 +0200 Subject: [PATCH 2/4] Remove electricity from secondary fuels --- .../variable/energy/primary-energy.yaml | 24 +++++++++++++++---- .../energy/tag_secondary_energy_carriers.yaml | 13 +++++----- 2 files changed, 26 insertions(+), 11 deletions(-) diff --git a/definitions/variable/energy/primary-energy.yaml b/definitions/variable/energy/primary-energy.yaml index 761fd2f7..433ce306 100644 --- a/definitions/variable/energy/primary-energy.yaml +++ b/definitions/variable/energy/primary-energy.yaml @@ -31,11 +31,17 @@ - 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 {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 {Secondary Fuel} {CCS} + description: Primary energy input of biomass for conversion to {Secondary Fuel} {CCS} unit: EJ/yr - Primary Energy|Non-Biomass Renewables: @@ -64,11 +70,21 @@ - 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 {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 {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: diff --git a/definitions/variable/energy/tag_secondary_energy_carriers.yaml b/definitions/variable/energy/tag_secondary_energy_carriers.yaml index a640a34b..b88e9aea 100644 --- a/definitions/variable/energy/tag_secondary_energy_carriers.yaml +++ b/definitions/variable/energy/tag_secondary_energy_carriers.yaml @@ -1,13 +1,12 @@ - Secondary Fuel: - - Electricity: - description: electricity generation - Liquids: - description: conversion to liquid fuels + description: liquid fuels (conventional & unconventional oil, biofuels, + coal-to-liquids, gas-to-liquids) - Solids: - description: conversion to solid fuels + description: solid fuels - Gases: - description: conversion to gaseous fuels not including hydrogen + description: gaseous fuels not including hydrogen - Hydrogen: - description: conversion to hydrogen + description: hydrogen - Heat: - description: heat generation + description: heat From 15c01971ffd9c4fb4512a8f51cdc27a223c537e5 Mon Sep 17 00:00:00 2001 From: Daniel Huppmann Date: Thu, 20 Jul 2023 18:33:07 +0200 Subject: [PATCH 3/4] Add final-energy variables --- definitions/variable/energy/final-energy.yaml | 128 ++++++++++++++++++ .../variable/energy/tag_all_sectors.yaml | 63 +++++++++ .../energy/tag_non_energy_sectors.yaml | 13 ++ .../energy/tag_secondary_energy_carriers.yaml | 1 + 4 files changed, 205 insertions(+) create mode 100644 definitions/variable/energy/final-energy.yaml create mode 100644 definitions/variable/energy/tag_all_sectors.yaml create mode 100644 definitions/variable/energy/tag_non_energy_sectors.yaml diff --git a/definitions/variable/energy/final-energy.yaml b/definitions/variable/energy/final-energy.yaml new file mode 100644 index 00000000..1c2cb081 --- /dev/null +++ b/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 diff --git a/definitions/variable/energy/tag_all_sectors.yaml b/definitions/variable/energy/tag_all_sectors.yaml new file mode 100644 index 00000000..42be9337 --- /dev/null +++ b/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|Rail: + description: rail transportation sector + - Transportation|Truck: + description: trucking 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 diff --git a/definitions/variable/energy/tag_non_energy_sectors.yaml b/definitions/variable/energy/tag_non_energy_sectors.yaml new file mode 100644 index 00000000..9aea5f2e --- /dev/null +++ b/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 diff --git a/definitions/variable/energy/tag_secondary_energy_carriers.yaml b/definitions/variable/energy/tag_secondary_energy_carriers.yaml index b88e9aea..76937b33 100644 --- a/definitions/variable/energy/tag_secondary_energy_carriers.yaml +++ b/definitions/variable/energy/tag_secondary_energy_carriers.yaml @@ -1,4 +1,5 @@ - Secondary Fuel: + # Electricity is treated separately - Liquids: description: liquid fuels (conventional & unconventional oil, biofuels, coal-to-liquids, gas-to-liquids) From 1d38064b6cc6a9f4c4c1ecfc61f349a18453788e Mon Sep 17 00:00:00 2001 From: Daniel Huppmann Date: Thu, 20 Jul 2023 18:34:24 +0200 Subject: [PATCH 4/4] Change order --- definitions/variable/energy/tag_all_sectors.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/definitions/variable/energy/tag_all_sectors.yaml b/definitions/variable/energy/tag_all_sectors.yaml index 42be9337..6ed415df 100644 --- a/definitions/variable/energy/tag_all_sectors.yaml +++ b/definitions/variable/energy/tag_all_sectors.yaml @@ -39,10 +39,10 @@ description: transportation sector by bus - Transportation|Light Duty Vehicle: description: transportation sector with light-duty vehicles - - Transportation|Rail: - description: rail transportation sector - Transportation|Truck: description: trucking sector + - Transportation|Rail: + description: rail transportation sector - Transportation|Domestic Aviation: description: domestic aviation sector - Transportation|Domestic Shipping: