PyPSA-AT: A Sector-Coupled Open Optimisation Model of the Austrian Energy System

[!WARNING]
PyPSA-AT is under very active early development. Expect things to change rapidly.

PyPSA-AT is an Austrian adaptation of the open European energy system
model PyPSA-Eur.
It provides a detailed sector-coupled model of the Austrian energy system, including the majority of relevant energy
carriers (electricity, gas, hydrogen, biomass, heat, coal, oil, methanol and ammonia) and demand profiles for the
industry, transport, residential, commercial, and agriculture sectors.

The project builds upon the methodologies developed in PyPSA-DE - the adaptation of
PyPSA-Eur for the German energy system - while incorporating Austria-specific network topology, energy system
characteristics, and regulatory frameworks.

For more comprehensive documentation on the underlying PyPSA-Eur/DE framework, model decisions, and implementation
details, please refer to the PyPSA-Eur documentation
and PyPSA-DE documentation, respectively.

🟥⬜🟥 Deutschsprachige Beschreibung:

PyPSA-AT ist eine österreichische Adaption des europäischen
Energiesystemmodells PyPSA-Eur.
Es liefert ein detailliertes, sektorgekoppeltes Modell des österreichischen Energiesystems und inkludiert den Großteil
der wichtigsten Energieträger (Elektrizität, Gas, Wasserstoff, Biomasse, Wärme, Kohle, Öl, Methanol und Ammoniak) sowie
Lastprofile für die Bedarfe von Industrie, Transport, Haushalten, Gewerbe und Landwirtschaft.

Das Projekt baut auf den methodischen Ansätzen auf, die in PyPSA-DE - der Adaption
von PyPSA-Eur für das Energiesystem Deutschlands - entwickelt wurden. Gleichzeitig enthält PyPSA-AT
österreichischspezifische Netzwerktopologien mit höherer räumlicher Auflösung innerhalb der Landesgrenzen,
Energiesystemcharakteristika und den regulatorischen Rahmen des Landes.

Für eine umfassendere Beschreibung der zugrundeliegenden Modelle sei hier auf die entsprechenden Dokumentationen
von PyPSA-Eur und PyPSA-DE
verwiesen.

✨ Features

PyPSA-AT extends the PyPSA-Eur model with Austria-specific enhancements.
While some features have already been implemented (✅), some are being actively worked on (🔨) or discussed (💡) and many
more are planned in the future (📌).
An overview of our planned and active features can be found in the following table.
For more detailed implementation information, see
the mods module documentation.

⌨️ Installation

Please note that PyPSA-AT is only supported on Linux platforms. Installations on Windows or macOS require
modifications currently not supported.

1. Clone the repository:

   git clone https://github.com/AGGM-AG/pypsa-at.git
   cd pypsa-at
   

2. Installation using pixi (optional):

   Explicit package installation may be skipped since running commands with pixi run installs and activates all
   dependencies in pixi.toml.

   pixi install
   

🚀 Usage

1. Configure your model by adjusting the base scenario in config/config.at.yaml

2. Include scenario settings that differ from the base scenario in config/scenarios.manual.yaml

3. Run the model using the default rule all:

   pixi run snakemake all --cores 'all'
   

   or activate the virtual environment and call the same workflow using a shorthand

   pixi shell && snakemake -call all
   

📖 Documentation

More detailed documentation of PyPSA-AT is hosted on pypsa-at.readthedocs.io.

🤝 Contributing

[!NOTE]
The development team focuses on establishing a well-calibrated representation of the Austrian energy system and
has limited capacity to review contributions from the community at the moment.

In general, please install the pre-commit hooks if you plan to contribute to this project.

pixi run pre-commit install

🗄️ Data sources

Scenario data: Ariadne

ariadne-data/ariadne-database.csv

• Source: Kopernikus Projekt Ariadne
• Link: Ariadne Scenario Explorer
• License: CC-BY 4.0
• Description: Results from
  the Ariadne Report: Die Energiewende kosteneffizient gestalten

Data on Ukrainian gas transit: AGGM AG

data/pypsa-at/ukrainian_gas_transit_stop.json

• Source: experts of AGGM (Austrian Gas Grid Management) AG
• Format: geojson dataset of affected network.generators.loc[f"{country_code} gas pipeline import"]
• Description: input of European gas network experts at AGGM on which cross-border transit points between the EU and Ukraine are closed down.

Data on Austrian gas network capacities: AGGM AG

data/pypsa-at/AGGM_gas_network_base_AT10.csv and
data/pypsa-at/AGGM_gas_network_base_AT35.csv

• Source: experts of AGGM (Austrian Gas Grid Management) AG
• Format: table of gas transport corridors in Austria and their properties
• Description: input of experts on the Austrian gas network, clustered for AT-10 (~ NUTS2) and AT-35 (NUTS3). The data contains information on transport corridors - not exact gas pipeline locations - and their properties

The properties improved with expert input are:

• p_nom: nominal capacity
• max_pressure_bar: maximum pressure
• build_year: year of construction

⚖️ License

This project is licensed under the MIT License - see the LICENSE.txt file for details.

Parts of the code that originate from PyPSA-DE
or PyPSA-Eur remain under their original MIT licenses. The copyright and
attribution notices from these original projects are preserved in the respective source files.

🏅 Acknowledgments

PyPSA-AT builds upon PyPSA-Eur and PyPSA-DE,
developed by the PyPSA team at TU Berlin and other contributors.

✏️ Citation

If you use PyPSA-AT in your research, please cite it as:

Worschischek, Philip; Zechner, Nicole; Awetisjan, Vartan; Wernhart, Helmut (2026):
PyPSA-AT - A sector-coupled open optimisation model of the Austrian energy system.
Version 0.1.0. Austrian Gas Grid Management AG.
https://github.com/AGGM-AG/pypsa-at

Or in the German version:

Worschischek, Philip; Zechner, Nicole; Awetisjan, Vartan; Wernhart, Helmut (2026):
PyPSA-AT - Sektorgekoppeltes Energiesystemmodell des österreichischen Energiesystems.
Version 0.1.0. Austrian Gas Grid Management AG.
https://github.com/AGGM-AG/pypsa-at