PyPSA-Earth Tutorial Databundle
Input Data for the PyPSA-Earth Tutorial Workflow
Description
This record provides the PyPSA-Earth Tutorial Databundle, a minimal and curated collection of datasets required to execute the testing and tutorial versions of the PyPSA-Earth workflow.
This databundle is not intended for full-scale modelling or research applications. It contains reduced, derived, or artificial datasets that can be used for the following purposes:
Testing and verifying the workflow
Running tutorial examples
Exploring the modelling pipeline
The data included here are for educational and workflow demonstration purposes only and are not necessarily representative of real-world conditions.
PyPSA-Earth is an open-source, sector-coupled global energy system modelling framework built on PyPSA and developed within the PyPSA meets Earth initiative.
Documentation: pypsa-earth.readthedocs.ior…: github.com: Parzen M., Abdel-Khalek H., Fedotova E., Mahmood M., Frysztacki M.M., Hampp J., Franken L., Schumm L., Neumann F., Poli D., Kiprakis A., Fioriti D.. PyPSA-Earth. A new global open energy system optimization model demonstrated in Africa. Applied Energy 2023; 341. doi:10.1016/j.apenergy.2023. 121096.
Included Data
The tutorial databundle includes subsets of the following datasets:
Exclusive Economic Zones (EEZ)data/eez/eez_v11.gpkgSource: Marine RegionsLicense: CC-BYLicense information: marineregions.org
Global Bathymetry (GEBCO 2025)data/gebco/GEBCO_2025_sub_ice.ncSource: GEBCOLicense: Public DomainLicense information: gebco.net
Global Land Cover (PROBA-V LC100)data/copernicus/PROBAV_LC100_global_v3.0.1_2019-nrt_Discrete-Classification-map_EPSG-4326.tifLicense: CC-BY-4.0Zenodo record: zenodo.org
Raw Protected Areasdata/landcover/world_protected_areas/*License: CC0Note: This dataset is not representative and is included solely to test workflow functionality. It is used to test the creation of the file natura.tiff used by the workflow
ERA5 Climate Cutoutcutout/cutout-2013-era5-tutorial.ncDerived from ERA5 (Copernicus Climate Data Store)License: CC-BY-4.0Dataset link: cds.climate.copernicus.eu
Demand Data (GlobalEnergyGIS)data/ssp2-2.6/*Generated for PyPSA-Earth tutorial execution using GlobalEnergyGIS: github.com: Mattsson N, Verendel V, Hedenus F, Reichenberg L. An autopilot for energy models – Automatic generation of renewable supply curves, hourly capacity factors and hourly synthetic electricity demand for arbitrary world regions. Energy Strategy Rev 2021
Administrative Boundaries (GeoBoundaries-derived)data/gadm/*Retrieved and adapted from GeoBoundaries.Provided as reduced samples for tutorial purposes.GeoBoundaries website: geoboundaries.orgreference: Runfola, D. et al. (2020) geoBoundaries: A global database of political administrative boundaries. PLoS ONE 15(4): e0231866. doi.org
Gridded GDP datasetdata/GDP/GDP_PPP_1990_2015_5arcmin_v2.tifLicense: Creative Commons Zero (CC0 1.0 Universal)Reference: Kummu, M., Taka, M., & Guillaume, J. H. A. (2020), Gridded global datasets for Gross Domestic Product and Human Development Index over 1990–2015*.Dataset link: doi.org
Global Buildings datasetdata/global_buildings/{BJ/NG}_global_buildings_raw.parquetRetrieved and adapted from github.com: Community Data License Agreement – Permissive – Version 2.0Dataset link: Microsoft Building Footprin…
Derived Hydrography of Africadata/hydrobasins_hydroshare/global_buildings/africa-geoglows-catchment.*Reference: Brigham Young University, Ashby, K., Nelson, J., Ames, D. (2026). Derived Hydrography of Africa, HydroShare, doi.org: CC-BY-4.0Dataset link: hydroshare.org
Licensing
All datasets retain their original licences (CC-BY, CC-BY-4.0, CDLA Permissive 2.0, CC0, or Public Domain).Users are responsible for complying with upstream licensing terms.
A licence summary is available in the PyPSA-Earth documentation:pypsa-earth.readthedocs.io