Welcome to the PyPSA-Earth documentation!#
Motivation. Closed-source models are the current standard for most policy and industry decisions. However, open models have proven to be competitive alternatives that promote science, robust technical analysis, collaboration and transparent policy decision making. Yet, two issues slow the adoption: open models are often designed with limited geographic scope, hindering synergies to collaborate, or are based on low spatially resolved data, limiting their utility.
PyPSA-Earth is the first open-source global cross-sectoral energy system model with high spatial and temporal resolution. The workflow provide capabilities for modelling the energy systems of any country in the world, enabling large-scale collaboration and transparent analysis for an inclusive and sustainable energy future. PyPSA-Earth is suitable for both operational studies and capacity expansion studies. Its sector-coupled modeling capabilities enable features for the detailed optimization of multi-energy systems, covering electricity, heating, transport, industry, hydrogen and more.
PyPSA meets Earth initiative members are maintaining the PyPSA-Earth repository as well as many other tools. The website provides more context of the initiative and the associated projects.
![]() |
![]() |
![]() |
Figure: Example power systems build with PyPSA-Earth. See images of ~193 more countries at https://zenodo.org/records/10080766
Get Involved#
- There are multiple ways to get involved and learn more about our work:
Join our forum and communication platform on PyPSA-meets-Earth Discord Server
- Chat on Discord with us in the following meetings:
General initiative meeting for project news and high-level code updates. Held every fourth Thursday 16-17:00 (UK time) and is a perfect place to meet the community and get a high-level update on PyPSA ecosystem relevant for PyPSA-Earth developments.
- Weekly developers meetings
Eastern-Hemisphere friendly Morning meeting every Thursday at 09:00 (UK time).
Western-Hemisphere friendly Evening meeting every Thursday 16:00 (UK time). Every forth Thursday is replaced by the General initiative meeting which has a more high-level perspective, but you can also join to discuss more particular questions.
Look at public materials at google Drive to share to minutes, presentations, lists and documents. Feel gree to get a look!
- Notify your interest to on-demand meetings:
Demand creation and prediction meeting
AI asset detection meeting
Outreach meeting for planning, discussing events, workshops, communication, community activities
Join us and propose your stream.
Documentation#
Getting Started
Configuration
Work flow and API
Advanced Usage
Support and Contributing
References