powerplantmatching

A toolset for cleaning, standardizing and combining multiple power plant databases.
https://github.com/PyPSA/powerplantmatching

Category: Energy Systems
Sub Category: Energy Data Accessibility and Integration

Keywords from Contributors

energy-system-model energy-system power-systems pypsa capacity-expansion-planning energy-data energy-model heat-pump renewable-energy transmission-network

Last synced: about 2 hours ago
JSON representation

Repository metadata

Set of tools to combine multiple power plant databases

README.md

powerplantmatching

pypi
conda
pythonversion
Tests
doc
pre-commit.ci status
Ruff
REUSE status
DOI
Stack Exchange questions

A toolset for cleaning, standardizing and combining multiple power
plant databases.

This package provides ready-to-use power plant data for the European power system.
Starting from openly available power plant datasets, the package cleans, standardizes
and merges the input data to create a new combined dataset, which includes all the important information.
The package allows to easily update the combined data as soon as new input datasets are released.

You can directly download the current version of the data as a CSV file.

Initially, powerplantmatching was developed by the
Renewable Energy Group
at FIAS and is now maintained by the Digital Transformation in Energy Systems Group at the Technical University of Berlin to build power plant data
inputs to PyPSA-based models for carrying
out simulations.

Main Features

  • clean and standardize power plant data sets
  • aggregate power plant units which belong to the same plant
  • compare and combine different data sets
  • create lookups and give statistical insight to power plant goodness
  • provide cleaned data from different sources
  • choose between gross/net capacity
  • provide an already merged data set of multiple different open data sources
  • scale the power plant capacities in order to match country-specific statistics about total power plant capacities
  • visualize the data
  • export your powerplant data to a PyPSA-based model

Map

powerplants.png

Installation

Using pip

pip install powerplantmatching

or conda

conda install -c conda-forge powerplantmatching

Contributing and Support

We strongly welcome anyone interested in contributing to this project. If you have any ideas, suggestions or encounter problems, feel invited to file issues or make pull requests on GitHub.

Citing powerplantmatching

If you want to cite powerplantmatching, use the following paper

with bibtex

@article{gotzens_performing_2019,
 title = {Performing energy modelling exercises in a transparent way - {The} issue of data quality in power plant databases},
 volume = {23},
 issn = {2211467X},
 url = {https://linkinghub.elsevier.com/retrieve/pii/S2211467X18301056},
 doi = {10.1016/j.esr.2018.11.004},
 language = {en},
 urldate = {2018-12-03},
 journal = {Energy Strategy Reviews},
 author = {Gotzens, Fabian and Heinrichs, Heidi and Hörsch, Jonas and Hofmann, Fabian},
 month = jan,
 year = {2019},
 pages = {1--12}
}

and/or the current release stored on Zenodo with a release-specific DOI:

DOI

Licence

powerplantmatching is released as free software under the MIT license.
The default output data powerplants.csv generated by the package is released under CC BY 4.0.
Parts of the repository may be licensed under different licenses, especially dependent package binaries for duke being licensed under Apache 2.0 license.

This repository uses the REUSE conventions to indicate the licenses that apply to individual files and parts of the repository.
For details on the licenses that apply, see the the header information of the respective files and REUSE.toml for details.

Copyright 2018-2024 Fabian Gotzens (FZ Jülich), Jonas Hörsch (KIT), Fabian Hofmann (FIAS)
Copyright 2025- Contributors to powerplantmatching https://github.com/pypsa/powerplantmatching

You can find a list of contributors in the contributors page and in the contributors file.

Citation (CITATION.cff)

# SPDX-FileCopyrightText: Contributors to powerplantmatching <https://github.com/pypsa/powerplantmatching>
#
# SPDX-License-Identifier: MIT

cff-version: 1.2.0
message: "If you use this package, please cite the corresponding manuscript in Journal of Open Research Software."
title: "Performing energy modelling exercises in a transparent way - The issue of data quality in power plant databases"
journal: Energy Strategy Reviews
doi: 10.1016/j.esr.2018.11.004
repository: https://github.com/pypsa/powerplantmatching
version: 0.8.2.dev0+gf7b432080.d20260211 # Don't touch, will be updated by the release script
license: MIT
authors:
  - family-names: Gotzens
    given-names: Fabian
    orcid: https://orcid.org/0000-0001-8546-2033
  - family-names: Heinrichs
    given-names: Heidi
    orcid: https://orcid.org/0000-0001-9536-9465
  - family-names: Hörsch
    given-names: Jonas
    orcid: https://orcid.org/0000-0001-9438-767X
  - family-names: Hofmann
    given-names: Fabian
    orcid: https://orcid.org/0000-0002-6604-5450

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 1 day ago

Total Commits: 904
Total Committers: 32
Avg Commits per committer: 28.25
Development Distribution Score (DDS): 0.612

Commits in past year: 35
Committers in past year: 12
Avg Commits per committer in past year: 2.917
Development Distribution Score (DDS) in past year: 0.8

Name Email Commits
Fabian f****f@g****e 351
Fabian Gotzens f****s@f****e 189
Jonas Hoersch j****s@c****t 102
pre-commit-ci[bot] 6****] 47
Lukas Trippe l****p@p****e 44
davide-f f****s@g****m 33
Fabian Neumann f****n@o****e 31
Thomas Kouroughli t****u@i****m 24
Max Parzen m****n@e****k 14
dependabot[bot] 4****] 9
Johannes HAMPP 4****n 9
Martin Hjelmeland h****n@g****m 6
= m****d@n****o 5
Schmugge, Jens j****e@d****e 4
martha.frysztacki e****4@i****u 3
Carlos Gaete c****e@p****m 3
Heinz-Alexander Fuetterer 3****r 3
Koen van Greevenbroek k****k@u****o 3
energyls l****m@o****e 3
eb5194 m****i@k****u 3
Daniel Rüdt 1****t 2
Fabian Gotzens f****s@r****e 2
Irieo i****n@g****m 2
LukasFrankenQ l****n@e****k 2
Strohut 5****t 2
rbaard1 1****1 2
Florian Maurer f****r@d****g 1
Markus Groissböck m****k@g****t 1
Fabian Neumann F****n 1
Mayk Thewessen m****2@h****m 1
and 2 more...

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 107
Total pull requests: 240
Average time to close issues: 7 months
Average time to close pull requests: 27 days
Total issue authors: 51
Total pull request authors: 30
Average comments per issue: 1.93
Average comments per pull request: 0.89
Merged pull request: 194
Bot issues: 0
Bot pull requests: 81

Past year issues: 5
Past year pull requests: 18
Past year average time to close issues: 3 months
Past year average time to close pull requests: 23 days
Past year issue authors: 3
Past year pull request authors: 8
Past year average comments per issue: 0.2
Past year average comments per pull request: 0.89
Past year merged pull request: 7
Past year bot issues: 0
Past year bot pull requests: 9

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/PyPSA/powerplantmatching

Top Issue Authors

  • FabianHofmann (12)
  • fneum (9)
  • davide-f (7)
  • irm-codebase (6)
  • pz-max (4)
  • SimDeh (4)
  • euronion (4)
  • cdgaete (3)
  • ChinCity (3)
  • henri-chat-noir (3)
  • FebinKa (3)
  • lisazeyen (2)
  • JanFrederickUnnewehr (2)
  • Tomkourou (2)
  • Jaspergeipel (2)

Top Pull Request Authors

  • pre-commit-ci[bot] (68)
  • lkstrp (37)
  • fneum (27)
  • FabianHofmann (18)
  • dependabot[bot] (13)
  • euronion (13)
  • davide-f (10)
  • cdgaete (5)
  • koen-vg (4)
  • afuetterer (4)
  • Tomkourou (4)
  • daniel-rdt (4)
  • pz-max (3)
  • martacki (3)
  • fgotzens (3)

Top Issue Labels

  • needs triage (12)
  • new dataset (5)
  • bug (3)
  • enhancement (2)
  • feature (1)

Top Pull Request Labels

  • dependencies (13)
  • github_actions (11)

Package metadata

proxy.golang.org: github.com/PyPSA/powerplantmatching

proxy.golang.org: github.com/pypsa/powerplantmatching

pypi.org: powerplantmatching

Toolset for generating and managing Power Plant Data

  • Homepage: https://github.com/PyPSA/powerplantmatching
  • Documentation: https://powerplantmatching.readthedocs.io/
  • Licenses: MIT License
  • Latest release: 0.8.1 (published 6 months ago)
  • Last Synced: 2026-08-12T13:32:04.288Z (1 day ago)
  • Versions: 35
  • Dependent Packages: 0
  • Dependent Repositories: 23
  • Downloads: 2,223 Last month
  • Rankings:
    • Dependent repos count: 3.028%
    • Forks count: 6.007%
    • Stargazers count: 6.503%
    • Average: 7.732%
    • Dependent packages count: 10.06%
    • Downloads: 13.065%
  • Maintainers (2)
conda-forge.org: powerplantmatching

This package provides ready-to-use power plant data for the European power system. Starting from openly available power plant datasets, the package cleans, standardizes and merges the input data to create a new combining dataset, which includes all the important information. The package allows to easily update the combined data as soon as new input datasets are released.

  • Homepage: https://github.com/PyPSA/powerplantmatching
  • Licenses: MIT
  • Latest release: 0.5.4 (published about 4 years ago)
  • Last Synced: 2026-04-01T02:01:22.682Z (4 months ago)
  • Versions: 7
  • Dependent Packages: 0
  • Dependent Repositories: 7
  • Rankings:
    • Dependent repos count: 12.9%
    • Forks count: 27.611%
    • Average: 31.238%
    • Stargazers count: 32.861%
    • Dependent packages count: 51.579%

Dependencies

.github/workflows/release.yml actions
  • actions/checkout v6 composite
  • actions/create-github-app-token v3 composite
  • actions/download-artifact v8 composite
  • actions/setup-python v6 composite
  • hynek/build-and-inspect-python-package v2 composite
  • pypa/gh-action-pypi-publish release/v1 composite
  • softprops/action-gh-release v3 composite
  • stefanzweifel/git-auto-commit-action v7 composite
.github/workflows/test.yml actions
  • actions/checkout v6 composite
  • actions/download-artifact v8 composite
  • actions/setup-java v5 composite
  • actions/setup-python v6 composite
  • hynek/build-and-inspect-python-package v2 composite
pyproject.toml pypi
  • country-converter *
  • deprecation *
  • entsoe-py >=0.3.1
  • geopy *
  • matplotlib *
  • networkx >=1.10
  • numpy *
  • openpyxl *
  • pandas >=0.24.0,<4
  • pycountry *
  • pyyaml >=5.1.0
  • requests *
  • scipy *
  • seaborn *
  • tqdm *
  • unidecode *
  • xlrd *
.github/workflows/codeql.yml actions
  • actions/checkout v6 composite
  • github/codeql-action/analyze v4 composite
  • github/codeql-action/init v4 composite
.github/workflows/type-checking.yml actions
  • actions/checkout v6 composite
  • actions/setup-python v6 composite

Score: 16.754985658497603