Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion config/config.default.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -90,6 +90,7 @@ enable:
# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration/#co2_budget_cf
co2_budget:
emissions_scope: CO2
international_bunkers: false
relative: true
upper:
2020: 0.72
Expand Down Expand Up @@ -539,7 +540,6 @@ load:
# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration/#energy_cf
energy:
energy_totals_year: 2023
base_emissions_year: 1990

# docs in https://pypsa-eur.readthedocs.io/en/latest/configuration/#biomass_cf
biomass:
Expand Down Expand Up @@ -1575,6 +1575,12 @@ data:
ghg_emissions:
source: archive
version: latest
ghg_emissions_energy_community:
source: archive
version: latest
desnz_ghg_emissions:
source: archive
version: latest
gebco:
source: archive
version: latest
Expand Down
114 changes: 100 additions & 14 deletions config/schema.default.json
Original file line number Diff line number Diff line change
Expand Up @@ -689,9 +689,18 @@
"properties": {
"emissions_scope": {
"default": "CO2",
"description": "Emissions scope for CO2 budget calculations.",
"description": "Emissions scope of the national inventories used for the 1990 baseline: CO2 only or all greenhouse gases in CO2 equivalent.",
"enum": [
"CO2",
"All greenhouse gases - (CO2 equivalent)"
],
"type": "string"
},
"international_bunkers": {
"default": false,
"description": "If true, the 1990 baseline includes the emissions of international aviation and shipping, which national inventory totals report only as memo items. The model covers their fuel demand and emissions either way.",
"type": "boolean"
},
"relative": {
"default": true,
"description": "If true, budget values are fractions of 1990 baseline emissions. If false, values are absolute (Gt CO2/year).",
Expand Down Expand Up @@ -1723,6 +1732,46 @@
}
}
},
"ghg_emissions_energy_community": {
"description": "Configuration for a single data source.",
"properties": {
"source": {
"default": "archive",
"description": "Source of the data. 'archive' retrieves pre-built data, 'primary' retrieves from primary source.",
"enum": [
"archive",
"primary",
"build"
],
"type": "string"
},
"version": {
"default": "latest",
"description": "Version of the data to use. Uses the specific 'version' for the selected 'source' or the dataset tagged 'latest' for this source.",
"type": "string"
}
}
},
"desnz_ghg_emissions": {
"description": "Configuration for a single data source.",
"properties": {
"source": {
"default": "archive",
"description": "Source of the data. 'archive' retrieves pre-built data, 'primary' retrieves from primary source.",
"enum": [
"archive",
"primary",
"build"
],
"type": "string"
},
"version": {
"default": "latest",
"description": "Version of the data to use. Uses the specific 'version' for the selected 'source' or the dataset tagged 'latest' for this source.",
"type": "string"
}
}
},
"gebco": {
"description": "Configuration for a single data source.",
"properties": {
Expand Down Expand Up @@ -2604,12 +2653,6 @@
"default": 2023,
"description": "The year for the sector energy use. The year must be available in the Eurostat report.",
"type": "integer"
},
"base_emissions_year": {
"default": 1990,
"description": "The base year for the sector emissions. See `European Environment Agency (EEA) <https://www.eea.europa.eu/data-and-maps/data/national-emissions-reported-to-the-unfccc-and-to-the-eu-greenhouse-gas-monitoring-mechanism-16>`_.",
"markdownDescription": "The base year for the sector emissions. See [European Environment Agency (EEA) ](https://www.eea.europa.eu/data-and-maps/data/national-emissions-reported-to-the-unfccc-and-to-the-eu-greenhouse-gas-monitoring-mechanism-16).",
"type": "integer"
}
}
},
Expand Down Expand Up @@ -10675,9 +10718,18 @@
"properties": {
"emissions_scope": {
"default": "CO2",
"description": "Emissions scope for CO2 budget calculations.",
"description": "Emissions scope of the national inventories used for the 1990 baseline: CO2 only or all greenhouse gases in CO2 equivalent.",
"enum": [
"CO2",
"All greenhouse gases - (CO2 equivalent)"
],
"type": "string"
},
"international_bunkers": {
"default": false,
"description": "If true, the 1990 baseline includes the emissions of international aviation and shipping, which national inventory totals report only as memo items. The model covers their fuel demand and emissions either way.",
"type": "boolean"
},
"relative": {
"default": true,
"description": "If true, budget values are fractions of 1990 baseline emissions. If false, values are absolute (Gt CO2/year).",
Expand Down Expand Up @@ -12688,12 +12740,6 @@
"default": 2023,
"description": "The year for the sector energy use. The year must be available in the Eurostat report.",
"type": "integer"
},
"base_emissions_year": {
"default": 1990,
"description": "The base year for the sector emissions. See `European Environment Agency (EEA) <https://www.eea.europa.eu/data-and-maps/data/national-emissions-reported-to-the-unfccc-and-to-the-eu-greenhouse-gas-monitoring-mechanism-16>`_.",
"markdownDescription": "The base year for the sector emissions. See [European Environment Agency (EEA) ](https://www.eea.europa.eu/data-and-maps/data/national-emissions-reported-to-the-unfccc-and-to-the-eu-greenhouse-gas-monitoring-mechanism-16).",
"type": "integer"
}
}
},
Expand Down Expand Up @@ -16061,6 +16107,46 @@
}
}
},
"ghg_emissions_energy_community": {
"description": "Configuration for a single data source.",
"properties": {
"source": {
"default": "archive",
"description": "Source of the data. 'archive' retrieves pre-built data, 'primary' retrieves from primary source.",
"enum": [
"archive",
"primary",
"build"
],
"type": "string"
},
"version": {
"default": "latest",
"description": "Version of the data to use. Uses the specific 'version' for the selected 'source' or the dataset tagged 'latest' for this source.",
"type": "string"
}
}
},
"desnz_ghg_emissions": {
"description": "Configuration for a single data source.",
"properties": {
"source": {
"default": "archive",
"description": "Source of the data. 'archive' retrieves pre-built data, 'primary' retrieves from primary source.",
"enum": [
"archive",
"primary",
"build"
],
"type": "string"
},
"version": {
"default": "latest",
"description": "Version of the data to use. Uses the specific 'version' for the selected 'source' or the dataset tagged 'latest' for this source.",
"type": "string"
}
}
},
"gebco": {
"description": "Configuration for a single data source.",
"properties": {
Expand Down
8 changes: 6 additions & 2 deletions data/versions.csv
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,8 @@ cutout,v1.0,archive,latest supported,2026-01-13,Pre-build cutouts for PyPSA-Eur,
cutout,unknown,build,latest supported,2025-12-02,Build latest cutouts using ERA5/SARAH3 data.,
desnz_electricity_consumption,unknown,primary,latest supported,2026-02-02,,https://assets.publishing.service.gov.uk/media/6762951abe7b2c675de30705/Subnational_electricity_consumption_statistics_2005-2024.xlsx
desnz_electricity_consumption,2026-02-16,archive,latest supported,2026-02-16,,https://data.pypsa.org/workflows/eur/desnz_electricity_consumption/2026-02-16/Subnational_electricity_consumption_statistics_2005-2024.xlsx
desnz_ghg_emissions,1990-2024,primary,latest supported,2026-10-03,Final UK greenhouse gas emissions statistics published February 2026,https://assets.publishing.service.gov.uk/media/6982298de833d031a3158ff2/final-greenhouse-gas-emissions-2024-by-source-datasets.xlsx
desnz_ghg_emissions,1990-2024,archive,latest supported,2026-11-19,Final UK greenhouse gas emissions statistics published February 2026,https://data.pypsa.org/workflows/eur/desnz_ghg_emissions/1990-2024/final-greenhouse-gas-emissions-2024-by-source-datasets.xlsx
dh_areas,341.5,primary,latest supported,2025-12-02,,https://fordatis.fraunhofer.de/bitstream/fordatis/341.5/2/dh_areas.gpkg
dh_areas,341.5,archive,latest supported,2026-01-13,,https://data.pypsa.org/workflows/eur/dh_areas/341.5/dh_areas.gpkg
eez,v12_20231025,primary,latest supported,2025-12-02,API request used,https://www.marineregions.org/download_file.php
Expand Down Expand Up @@ -77,8 +79,10 @@ gem_gspt,march-2025-v1.1,archive,latest supported,2026-02-02,,https://data.pypsa
gem_gspt,april-2024-v1,archive,not-supported,2026-01-13,,https://data.pypsa.org/workflows/eur/gem_gspt/april-2024-v1/Global-Steel-Plant-Tracker-April-2024-Standard-Copy-V1.xlsx
geothermal_heat_utilisation_potentials,341.5,primary,latest supported,2025-12-02,,https://fordatis.fraunhofer.de/bitstream/fordatis/341.5/11/Results_DH_Matching_Cluster.xlsx
geothermal_heat_utilisation_potentials,341.5,archive,latest supported,2026-01-13,,https://data.pypsa.org/workflows/eur/geothermal_heat_utilisation_potentials/341.5/Results_DH_Matching_Cluster.xlsx
ghg_emissions,v23,primary,latest supported,2025-12-02,,https://web.archive.org/web/20200622130401if_/https%3A//www.eea.europa.eu/data-and-maps/data/national-emissions-reported-to-the-unfccc-and-to-the-eu-greenhouse-gas-monitoring-mechanism-16/national-greenhouse-gas-inventories-ipcc-common-reporting-format-sector-classification/ascii-delimited-zip-2/at_download/file
ghg_emissions,v23,archive,latest supported,2026-01-13,earlier part of databundle,https://data.pypsa.org/workflows/eur/ghg_emissions/v23/UNFCCC_v23.csv
ghg_emissions,v32,primary,latest supported,2026-10-03,EEA GovReg dataset 2026 v2.0,https://sdi.eea.europa.eu/datashare/s/sptXqwkQr5g7Bp5/download?path=%2Feea_t_national-emissions-reported_p_2026_v02_r00%2FCSV&files=UNFCCC_v32.csv
ghg_emissions,v32,archive,latest supported,2026-11-19,EEA GovReg dataset 2026 v2.0,https://data.pypsa.org/workflows/eur/ghg_emissions/v32/download
ghg_emissions_energy_community,v1,primary,latest supported,2026-10-03,EEA Energy Community dataset 2026,https://sdi.eea.europa.eu/datashare/s/WqKyeH8skz9QdRg/download?path=%2F&files=UNFCCC_v1.csv
ghg_emissions_energy_community,v1,archive,latest supported,2026-11-19,EEA Energy Community dataset 2026,https://data.pypsa.org/workflows/eur/ghg_emissions_energy_community/v1/download
h2_salt_caverns,16-10-2019,primary,latest supported,2025-12-02,,https://zenodo.org/records/16899309/files/h2_salt_caverns_GWh_per_sqkm.geojson
h2_salt_caverns,16-10-2019,archive,latest supported,2026-01-13,,https://data.pypsa.org/workflows/eur/h2_salt_caverns/16-10-2019/h2_salt_caverns_GWh_per_sqkm.geojson
hotmaps_industrial_sites,version-1.1,archive,latest supported,2026-01-13,,https://data.pypsa.org/workflows/eur/hotmaps_industrial_sites/version-1.1/Industrial_Database.csv
Expand Down
3 changes: 2 additions & 1 deletion doc/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -247,7 +247,8 @@ Configuration for `enable` settings.
Carbon budgets share one schema for all foresight modes. The `relative` flag
selects whether yearly entries inside `upper`/`lower` are interpreted as
fractions of the 1990 baseline (`true`) or absolute GtCO₂/year
(`false`). Enable `upper` and/or `lower` to enforce those caps only for
(`false`). The baseline excludes international aviation and shipping unless
`international_bunkers` is set. Enable `upper` and/or `lower` to enforce those caps only for
the explicitly listed years or a total budget across all [planning_horizons](#planning_horizons_cf).

Configuration for `co2_budget` settings.
Expand Down
4 changes: 3 additions & 1 deletion doc/data_inventory.csv
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,9 @@
"nuts3_population","Population by NUTS3 region","Average annual population to calculate regional GDP data (thousand persons) by NUTS 3 region (nama_10r_3popgdp)","Eurostat","[ec.europa.eu](https://ec.europa.eu/eurostat/databrowser/bulk?lang=en&searchFilter=nama_10r_3pop)", "CC-BY-4.0"
"gdp_per_capita","Gridded global datasets for Gross Domestic Product over 1990–2015","Gross Domestic Product per capita (PPP)","Kummu, M et al.","[nature.com](https://www.nature.com/articles/sdata20184)","CC-BY-4.0"
"population_count","World - Population Counts","Spatial distribution of population","WorldPop","[data.humdata.org](https://data.humdata.org/dataset/worldpop-population-counts-for-world) [hub.worldpop.org](https://hub.worldpop.org/doi/10.5258/SOTON/WP00647)","CC-BY-4.0"
"ghg_emissions","Total GHG emissions and removals in the EU","National emissions reported to the UNFCCC and to the EU under the Governance Regulation","European Environment Agency","[eea.europa.eu](https://www.eea.europa.eu/en/datahub/datahubitem-view/3b7fe76c-524a-439a-bfd2-a6e4046302a2?activeAccordion=1095700%2C1095998%2C1085929%2C1084352%2C1084914)","CC-BY-4.0"
"ghg_emissions","National greenhouse gas emissions reported to the UNFCCC","Greenhouse gas emissions and removals by IPCC source category of the EU, its member states and EEA member countries reported under the Governance Regulation","European Environment Agency","[sdi.eea.europa.eu](https://doi.org/10.2909/a1407927-71d3-49da-9895-29a5e4cbcaf1)","CC-BY-4.0"
"ghg_emissions_energy_community","Greenhouse gas emissions of Energy Community Contracting Parties","Greenhouse gas emissions and removals by IPCC source category reported by the Energy Community Contracting Parties (e.g. Albania, Moldova, Montenegro, Serbia, Ukraine)","European Environment Agency","[sdi.eea.europa.eu](https://sdi.eea.europa.eu/catalogue/srv/api/records/b2f0b8a6-ae5f-44ff-ade4-7054a5cf5daa)","CC-BY-4.0"
"desnz_ghg_emissions","Final UK greenhouse gas emissions statistics","UK territorial greenhouse gas emissions by source and CRT category from 1990 onwards, including international aviation and shipping","UK Department for Energy Security and Net Zero","[gov.uk](https://www.gov.uk/government/collections/final-uk-greenhouse-gas-emissions-national-statistics)","OGL-UK-3.0"
"gebco","General Bathymetric Chart of the Oceans","Gridded Bathymetric data for ocean and land, providing elevation data in meters, on a 15 arc-second interval grid.","GEBCO Comilation Group","[gebco.net](https://www.gebco.net/data-products/gridded-bathymetry-data)","Public domain"
"attributed_ports","Global - International Ports","International ports with attributes describing name, port functions, total capacity and location","World bank Group","[datacatalog.worldbank.org](https://datacatalog.worldbank.org/search/dataset/0038118/Global---International-Ports)", "CC-BY-4.0"
"corine","CORINE Land Cover 2012","Pan European Land cover for 44 thematic classes with 2012 as reference year","Copernicus","[land.copernicus.eu](https://land.copernicus.eu/en/products/corine-land-cover/clc-2012)","Custom similar to CC-BY"
Expand Down
3 changes: 1 addition & 2 deletions doc/migration.md
Original file line number Diff line number Diff line change
Expand Up @@ -422,8 +422,7 @@ unconstrained to zero-emission.
To restore the *old behaviour*, set: `co2_budget: {upper: null, lower: null}`. To migrate your previous `<x> t` values, divide your old values by `1e9`.

**Relative budgets are always measured against 1990.**
`energy.base_emissions_year` no longer influences the CO₂ baseline; it still controls
`build_co2_totals`. For electricity-only runs the baseline still covers every sector
`energy.base_emissions_year` is removed. For electricity-only runs the baseline still covers every sector
that is flagged in `sector:`, which makes a relative budget almost non-binding.
*Old behaviour:* nothing to do for sector runs with a 1990 baseline. Otherwise
rescale `upper` by hand or use `relative: false`. For electricity-only runs, switch
Expand Down
2 changes: 2 additions & 0 deletions doc/release_notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@

<!-- Upcoming Release -->
<!-- ================= -->
* **Breaking:** Historical emissions now come from the latest national inventories (1990-2024): EEA for EU, EEA and Energy Community countries (`ghg_emissions`, new `ghg_emissions_energy_community`) and DESNZ for Great Britain (new `desnz_ghg_emissions`). [build_co2_totals][] writes emissions per country, year and sector, which [compose_network][] and [plot_summary][] read. The baseline for relative targets still excludes international aviation and shipping; the new option `co2_budget: international_bunkers` includes them. `co2_budget: emissions_scope` accepts only `CO2` and `All greenhouse gases - (CO2 equivalent)`. `energy: base_emissions_year` is removed ([#2337](https://github.com/PyPSA/pypsa-eur/pull/2337)).

* Fix: Gas pipelines ending in regions without an onshore region, e.g. offshore junctions at high resolution, now get gas and H2 buses instead of leaving the network inconsistent ([#2429](https://github.com/PyPSA/pypsa-eur/pull/2429)).
* Fix: Offshore wind profiles no longer fail for clustered buses without an onshore region; the nearest onshore regions then serve as the shoreline ([#2425](https://github.com/PyPSA/pypsa-eur/pull/2425)).
* Fix: Hydro reservoir storage (`renewable: hydro: hydro_max_hours`) no longer depends on the first unit of each country, and the default now matches the country totals. This changes default results ([#2428](https://github.com/PyPSA/pypsa-eur/pull/2428)).
Expand Down
4 changes: 4 additions & 0 deletions doc/tutorial_sector.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,6 +135,7 @@ retrieve_cutout 1
retrieve_desnz_electricity_consumption 1
retrieve_dh_areas 1
retrieve_eez 1
retrieve_desnz_ghg_emissions 1
retrieve_jrc_energy_atlas 1
retrieve_entsoe_electricity_demand 1
retrieve_neso_electricity_demand 1
Expand All @@ -151,6 +152,7 @@ retrieve_gem_europe_gas_tracker 1
retrieve_gem_gspt 1
retrieve_geothermal_heat_utilisation_potentials 1
retrieve_ghg_emissions 1
retrieve_ghg_emissions_energy_community 1
retrieve_h2_salt_caverns 1
retrieve_hera_data_test_cutout 1
retrieve_hotmaps_industrial_sites 1
Expand Down Expand Up @@ -314,6 +316,7 @@ retrieve_cutout 1
retrieve_desnz_electricity_consumption 1
retrieve_dh_areas 1
retrieve_eez 1
retrieve_desnz_ghg_emissions 1
retrieve_jrc_energy_atlas 1
retrieve_entsoe_electricity_demand 1
retrieve_neso_electricity_demand 1
Expand All @@ -330,6 +333,7 @@ retrieve_gem_europe_gas_tracker 1
retrieve_gem_gspt 1
retrieve_geothermal_heat_utilisation_potentials 1
retrieve_ghg_emissions 1
retrieve_ghg_emissions_energy_community 1
retrieve_h2_salt_caverns 1
retrieve_hera_data_test_cutout 1
retrieve_hotmaps_industrial_sites 1
Expand Down
Loading
Loading