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 energy system model with data in high spatial and temporal resolution. It enables large-scale collaboration by providing a tool that can model the world energy system or any subset of it. This work is derived from the European PyPSA-Eur model using new data and functions. It is suitable for operational as well as combined generation, storage and transmission expansion studies. We work hard to extend the PyPSA-Earth model by end of this year to include sector-coupling, myopic and perfect pathway expansion capabilities.

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.

Get Involved

The PyPSA meets Earth team is currently running four types of meetings:

• **Discord NEW! (Open)**

  • Chat with the community, team up on features, exchange with developers, code in voice channels

• General code meeting (Open)

  • every forth Thursday each month 16-17:00 (UK time) download .ics file

  • updates on overall project and code blocks

  • meeting hosted on Discord; join us, we are waiting for you!

  • open agenda. See what we will discuss. Invited members have edit rights.

• Specific code meeting (by invitation)

  • meeting hosted on Discord

  • join updates, demos, Q&A’s, discussions and the coordination of each work package

    1. Demand creation and prediction meeting, on demand basis

    2. AI asset detection meeting, on demand basis

    3. Sector coupling meeting, every Thursday 09:00 (UK time), download .ics file

    4. PyPSA-Earth meeting, every Thursday 16:00 (UK time), download .ics file

• Outreach meeting (by invitation)

  • every second week

  • planning, discussing events, workshops, communication, community activities

• Buddy talk (Open)

  • book a 30min meeting with Max to discuss anything you like

  • booking link: calendly.com/pypsa-meets-earth

Documentation

Getting Started

• Introduction

• Installation

• Short tutorial

• Model customization

• Data used by the model

• Examples

Configuration

• Wildcards

• Configuration

• Cost Assumptions

Work flow and API

• The structure

• Rules overview

• API Reference (automated)

Advanced Usage

• Monte Carlo

Help and References

• Release Notes

• Сontribute

• Software hints

• Learning materials

• Project structure and credits

• Talks and papers