gas_areas

The central module containing code to create CH4 and H2 voronoi polygons

class EgonPfHvGasVoronoi(**kwargs)[source]

Bases: Base

Class definition of table grid.egon_gas_voronoi

bus_id: Bus of the corresponding area

carrier: Gas carrier of the voronoi area (“CH4”, “H2” or “H2_saltcavern”)

geom: Geometry of the corresponding area

meta = {'context': {'contact': 'https://ego-n.org/partners/', 'documentation': 'https://egon-data.readthedocs.io/en/latest/', 'fundingAgency': 'Bundesministerium für Wirtschaft und Energie', 'fundingAgencyLogo': 'https://www.innovation-beratung-foerderung.de/INNO/Redaktion/DE/Bilder/Titelbilder/titel_foerderlogo_bmwi.jpg?__blob=normal&v=3', 'grantNo': '03EI1002', 'homepage': 'https://ego-n.org/', 'publisherLogo': 'https://ego-n.org/images/eGon_logo_noborder_transbg.svg', 'sourceCode': 'https://github.com/openego/eGon-data'}, 'contributors': [{'email': 'https://github.com/fwitte', 'title': 'Francesco Witte'}], 'description': 'H2 and CH4 voronoi cells', 'id': 'WILL_BE_SET_AT_PUBLICATION', 'language': ['en-EN'], 'licenses': [{'attribution': '© eGon development team', 'instruction': 'You are free: To Share, To Create, To Adapt; As long as you: Attribute, Share-Alike, Keep open!', 'name': 'ODbL-1.0', 'path': 'https://opendatacommons.org/licenses/odbl/1.0/index.html', 'title': 'Open Data Commons Open Database License 1.0'}], 'metaMetadata': {'metadataLicense': {'name': 'CC0-1.0', 'path': 'https://creativecommons.org/publicdomain/zero/1.0/', 'title': 'Creative Commons Zero v1.0 Universal'}, 'metadataVersion': 'OEP-1.4.1'}, 'name': 'grid.egon_gas_voronoi', 'publicationDate': '2026-06-01', 'resources': [{'dialect': {'decimalSeparator': '.', 'delimiter': None}, 'encoding': 'UTF-8', 'format': 'PostgreSQL', 'name': 'grid.egon_gas_voronoi', 'path': None, 'profile': 'tabular-data-resource', 'schema': {'fields': [{'description': 'Name of the scenario', 'name': 'scn_name', 'type': 'str', 'unit': None}, {'description': 'Unique identifier', 'name': 'bus_id', 'type': 'integer', 'unit': None}, {'description': 'Carrier of the voronoi cell', 'name': 'carrier', 'type': 'str', 'unit': None}, {'description': 'Voronoi cell geometry', 'name': 'geom', 'type': 'Geometry(Polygon, 4326)', 'unit': None}], 'foreignKeys': [], 'primaryKey': ['scn_name', 'bus_id']}}], 'sources': [{'description': 'Full data extract of OpenStreetMap data for defined spatial extent at "referenceDate"', 'licenses': [{'attribution': '© OpenStreetMap contributors', 'instruction': 'You are free: To Share, To Create, To Adapt; As long as you: Attribute, Share-Alike, Keep open!', 'name': 'ODbL-1.0', 'path': 'https://opendatacommons.org/licenses/odbl/1.0/index.html', 'title': 'Open Data Commons Open Database License 1.0'}], 'path': 'https://download.geofabrik.de/europe/germany-210101.osm.pbf', 'title': 'OpenStreetMap Data Extracts (Geofabrik)'}, {'description': 'The SciGRID_gas dataset represents the European gas transport network (pressure levels of 20 bars and higher) including the geo-referenced transport pipelines, compressor stations, LNG terminals, storage, production sites, gas power plants, border points, and demand time series.', 'licenses': [{'attribution': 'Jan Diettrich; Adam Pluta; Wided Medjroubi (DLR-VE)', 'instruction': 'You are free: To Share, To Create, To Adapt; As long as you: Attribute.', 'name': 'CC-BY-4.0', 'path': 'https://creativecommons.org/licenses/by/4.0/legalcode', 'title': 'Creative Commons Attribution 4.0 International'}], 'path': 'https://dx.doi.org/10.5281/zenodo.4896526', 'title': 'SciGRID_gas IGGIELGN'}, {'description': 'Shapefiles corresponding to the data provided in figure 7-1 (Donadei, S., et al., 2020, p. 7-5). The energy storage potential data are provided per federal state in table 7-1 (Donadei, S., et al., 2020, p. 7-4). Note: Please include all bgr data sources when using the data.', 'licenses': [{'attribution': '© BGR, Hannover, 2021', 'instruction': 'Geodaten und Geodatendienste, einschließlich zugehöriger Metadaten, werden für alle derzeit bekannten sowie für alle zukünftig bekannten Zwecke kommerzieller und nicht kommerzieller Nutzung geldleistungsfrei zur Verfügung gestellt, soweit durch besondere Rechtsvorschrift nichts anderes bestimmt ist oder vertragliche oder gesetzliche Rechte Dritter dem nicht entgegenstehen.', 'name': 'geonutzv-de-2013-03-19', 'path': 'https://www.gesetze-im-internet.de/geonutzv/', 'title': 'Verordnung zur Festlegung der Nutzungsbestimmungen für die Bereitstellung von Geodaten des Bundes'}], 'path': 'https://dx.doi.org/10.5281/zenodo.4896526', 'title': 'Informationssystem Salz: Planungsgrundlagen, Auswahlkriterien und Potenzialabschätzung für die Errichtung von Salzkavernen zur Speicherung von Erneuerbaren Energien (Wasserstoff und Druckluft) – Doppelsalinare und flach lagernde Salzschichten. Teilprojekt Bewertungskriterien und Potenzialabschätzung'}], 'spatial': {'extent': 'Germany', 'location': None, 'resolution': None}, 'title': 'Gas voronoi areas'}

meta_json = '\'{\n "name": "grid.egon_gas_voronoi",\n "title": "Gas voronoi areas",\n "id": "WILL_BE_SET_AT_PUBLICATION",\n "description": "H2 and CH4 voronoi cells",\n "language": [\n "en-EN"\n ],\n "publicationDate": "2026-06-01",\n "context": {\n "homepage": "https://ego-n.org/",\n "documentation": "https://egon-data.readthedocs.io/en/latest/",\n "sourceCode": "https://github.com/openego/eGon-data",\n "contact": "https://ego-n.org/partners/",\n "grantNo": "03EI1002",\n "fundingAgency": "Bundesministerium für Wirtschaft und Energie",\n "fundingAgencyLogo": "https://www.innovation-beratung-foerderung.de/INNO/Redaktion/DE/Bilder/Titelbilder/titel_foerderlogo_bmwi.jpg?__blob=normal&v=3",\n "publisherLogo": "https://ego-n.org/images/eGon_logo_noborder_transbg.svg"\n },\n "spatial": {\n "location": null,\n "extent": "Germany",\n "resolution": null\n },\n "sources": [\n {\n "title": "OpenStreetMap Data Extracts (Geofabrik)",\n "description": "Full data extract of OpenStreetMap data for defined spatial extent at \\"referenceDate\\"",\n "path": "https://download.geofabrik.de/europe/germany-210101.osm.pbf",\n "licenses": [\n {\n "name": "ODbL-1.0",\n "title": "Open Data Commons Open Database License 1.0",\n "path": "https://opendatacommons.org/licenses/odbl/1.0/index.html",\n "instruction": "You are free: To Share, To Create, To Adapt; As long as you: Attribute, Share-Alike, Keep open!",\n "attribution": "© OpenStreetMap contributors"\n }\n ]\n },\n {\n "title": "SciGRID_gas IGGIELGN",\n "description": "The SciGRID_gas dataset represents the European gas transport network (pressure levels of 20 bars and higher) including the geo-referenced transport pipelines, compressor stations, LNG terminals, storage, production sites, gas power plants, border points, and demand time series.",\n "path": "https://dx.doi.org/10.5281/zenodo.4896526",\n "licenses": [\n {\n "name": "CC-BY-4.0",\n "title": "Creative Commons Attribution 4.0 International",\n "path": "https://creativecommons.org/licenses/by/4.0/legalcode",\n "instruction": "You are free: To Share, To Create, To Adapt; As long as you: Attribute.",\n "attribution": "Jan Diettrich; Adam Pluta; Wided Medjroubi (DLR-VE)"\n }\n ]\n },\n {\n "title": "Informationssystem Salz: Planungsgrundlagen, Auswahlkriterien und Potenzialabschätzung für die Errichtung von Salzkavernen zur Speicherung von Erneuerbaren Energien (Wasserstoff und Druckluft) – Doppelsalinare und flach lagernde Salzschichten. Teilprojekt Bewertungskriterien und Potenzialabschätzung",\n "description": "Shapefiles corresponding to the data provided in figure 7-1 (Donadei, S., et al., 2020, p. 7-5). The energy storage potential data are provided per federal state in table 7-1 (Donadei, S., et al., 2020, p. 7-4). Note: Please include all bgr data sources when using the data.",\n "path": "https://dx.doi.org/10.5281/zenodo.4896526",\n "licenses": [\n {\n "name": "geonutzv-de-2013-03-19",\n "title": "Verordnung zur Festlegung der Nutzungsbestimmungen für die Bereitstellung von Geodaten des Bundes",\n "path": "https://www.gesetze-im-internet.de/geonutzv/",\n "instruction": "Geodaten und Geodatendienste, einschließlich zugehöriger Metadaten, werden für alle derzeit bekannten sowie für alle zukünftig bekannten Zwecke kommerzieller und nicht kommerzieller Nutzung geldleistungsfrei zur Verfügung gestellt, soweit durch besondere Rechtsvorschrift nichts anderes bestimmt ist oder vertragliche oder gesetzliche Rechte Dritter dem nicht entgegenstehen.",\n "attribution": "© BGR, Hannover, 2021"\n }\n ]\n }\n ],\n "licenses": [\n {\n "name": "ODbL-1.0",\n "title": "Open Data Commons Open Database License 1.0",\n "path": "https://opendatacommons.org/licenses/odbl/1.0/index.html",\n "instruction": "You are free: To Share, To Create, To Adapt; As long as you: Attribute, Share-Alike, Keep open!",\n "attribution": "© eGon development team"\n }\n ],\n "contributors": [\n {\n "title": "Francesco Witte",\n "email": "https://github.com/fwitte"\n }\n ],\n "resources": [\n {\n "profile": "tabular-data-resource",\n "name": "grid.egon_gas_voronoi",\n "path": null,\n "format": "PostgreSQL",\n "encoding": "UTF-8",\n "schema": {\n "fields": [\n {\n "name": "scn_name",\n "description": "Name of the scenario",\n "type": "str",\n "unit": null\n },\n {\n "name": "bus_id",\n "description": "Unique identifier",\n "type": "integer",\n "unit": null\n },\n {\n "name": "carrier",\n "description": "Carrier of the voronoi cell",\n "type": "str",\n "unit": null\n },\n {\n "name": "geom",\n "description": "Voronoi cell geometry",\n "type": "Geometry(Polygon, 4326)",\n "unit": null\n }\n ],\n "primaryKey": [\n "scn_name",\n "bus_id"\n ],\n "foreignKeys": []\n },\n "dialect": {\n "delimiter": null,\n "decimalSeparator": "."\n }\n }\n ],\n "metaMetadata": {\n "metadataVersion": "OEP-1.4.1",\n "metadataLicense": {\n "name": "CC0-1.0",\n "title": "Creative Commons Zero v1.0 Universal",\n "path": "https://creativecommons.org/publicdomain/zero/1.0/"\n }\n }\n}\''

scn_name: Name of the scenario

source_list = [{'description': 'Full data extract of OpenStreetMap data for defined spatial extent at "referenceDate"', 'licenses': [{'attribution': '© OpenStreetMap contributors', 'instruction': 'You are free: To Share, To Create, To Adapt; As long as you: Attribute, Share-Alike, Keep open!', 'name': 'ODbL-1.0', 'path': 'https://opendatacommons.org/licenses/odbl/1.0/index.html', 'title': 'Open Data Commons Open Database License 1.0'}], 'path': 'https://download.geofabrik.de/europe/germany-210101.osm.pbf', 'title': 'OpenStreetMap Data Extracts (Geofabrik)'}, {'description': 'The SciGRID_gas dataset represents the European gas transport network (pressure levels of 20 bars and higher) including the geo-referenced transport pipelines, compressor stations, LNG terminals, storage, production sites, gas power plants, border points, and demand time series.', 'licenses': [{'attribution': 'Jan Diettrich; Adam Pluta; Wided Medjroubi (DLR-VE)', 'instruction': 'You are free: To Share, To Create, To Adapt; As long as you: Attribute.', 'name': 'CC-BY-4.0', 'path': 'https://creativecommons.org/licenses/by/4.0/legalcode', 'title': 'Creative Commons Attribution 4.0 International'}], 'path': 'https://dx.doi.org/10.5281/zenodo.4896526', 'title': 'SciGRID_gas IGGIELGN'}, {'description': 'Shapefiles corresponding to the data provided in figure 7-1 (Donadei, S., et al., 2020, p. 7-5). The energy storage potential data are provided per federal state in table 7-1 (Donadei, S., et al., 2020, p. 7-4). Note: Please include all bgr data sources when using the data.', 'licenses': [{'attribution': '© BGR, Hannover, 2021', 'instruction': 'Geodaten und Geodatendienste, einschließlich zugehöriger Metadaten, werden für alle derzeit bekannten sowie für alle zukünftig bekannten Zwecke kommerzieller und nicht kommerzieller Nutzung geldleistungsfrei zur Verfügung gestellt, soweit durch besondere Rechtsvorschrift nichts anderes bestimmt ist oder vertragliche oder gesetzliche Rechte Dritter dem nicht entgegenstehen.', 'name': 'geonutzv-de-2013-03-19', 'path': 'https://www.gesetze-im-internet.de/geonutzv/', 'title': 'Verordnung zur Festlegung der Nutzungsbestimmungen für die Bereitstellung von Geodaten des Bundes'}], 'path': 'https://dx.doi.org/10.5281/zenodo.4896526', 'title': 'Informationssystem Salz: Planungsgrundlagen, Auswahlkriterien und Potenzialabschätzung für die Errichtung von Salzkavernen zur Speicherung von Erneuerbaren Energien (Wasserstoff und Druckluft) – Doppelsalinare und flach lagernde Salzschichten. Teilprojekt Bewertungskriterien und Potenzialabschätzung'}]

class GasAreas(dependencies)[source]

Bases: Dataset

Create the gas voronoi table and the gas voronoi areas

Dependencies

Resulting tables

EgonPfHvGasVoronoi

extra_dependencies = ()

name: str = 'GasAreas'

scn_name = 'eGon2035'

tasks: Tasks = (<function create_gas_voronoi_table>, <function voronoi_egon2035>, functools.partial(<function voronoi_status>, scn_name='status2019')): The tasks of this Dataset. A TaskGraph will automatically be converted to Tasks_.

version: str = '0.0.5'

class GasAreaseGon100RE(dependencies)[source]

Bases: Dataset

Insert the gas voronoi areas for eGon100RE

Inserts the gas voronoi areas for the eGon100RE scenario with the voronoi_egon100RE() function.

Dependencies

Resulting tables

EgonPfHvGasVoronoi

name: str = 'GasAreaseGon100RE'

sources: DatasetSources = DatasetSources(tables={'vg250_sta_union': 'boundaries.vg250_sta_union', 'egon_etrago_bus': 'grid.egon_etrago_bus'}, files={}, urls={}): The sources used by the datasets. Could be tables, files and urls

targets: DatasetTargets = DatasetTargets(tables={'ch4_voronoi': 'grid.egon_gas_voronoi'}, files={}): The targets created by the datasets. Could be tables and files

version: str = '0.0.5'

class GasAreaseGon2035(dependencies)[source]

Bases: Dataset

Create the gas voronoi table and the gas voronoi areas for eGon2035

Create the gas voronoi table by executing the function create_gas_voronoi_table() and inserts the gas voronoi areas for the eGon2035 scenario with the voronoi_egon2035() function.

Dependencies

Resulting tables

EgonPfHvGasVoronoi

name: str = 'GasAreaseGon2035'

sources: DatasetSources = DatasetSources(tables={'vg250_sta_union': 'boundaries.vg250_sta_union', 'egon_etrago_bus': 'grid.egon_etrago_bus'}, files={}, urls={}): The sources used by the datasets. Could be tables, files and urls

targets: DatasetTargets = DatasetTargets(tables={'ch4_voronoi': 'grid.egon_gas_voronoi'}, files={}): The targets created by the datasets. Could be tables and files

version: str = '0.0.5'

create_gas_voronoi_table()[source]: Create gas voronoi table

create_voronoi(scn_name, carrier)[source]

Create voronoi polygons for specified carrier in specified scenario.

Parameters:

scn_name (str) – Name of the scenario
carrier (str) – Name of the carrier

voronoi_egon100RE()[source]

Insert the gas voronoi polygons in eGon100RE into the database

This function insert the voronoi polygons for CH4, H2_grid and H2_saltcavern into the database for the scenario eGon100RE, making use of the function create_voronoi().

voronoi_egon2035()[source]

Insert the gas voronoi polygons in eGon2035 into the database

This function insert the voronoi polygons for CH4, H2_grid and H2_saltcavern into the database for the scenario eGon2035, making use of the function create_voronoi().

voronoi_status(scn_name)[source]: Create voronoi polygons for all gas carriers in status_x scenario