Skip to main content

ZEN-garden is an optimization model of energy systems and value chains.

Project description

ZEN-garden

Python Version from PEP 621 TOML

GitHub Release PyPI - Version

GitHub Actions Workflow Status Endpoint Badge Read the Docs

GitHub forks

drawing

Welcome to the ZEN-garden! ZEN-garden is an optimization model of energy systems and value chains. It is currently used to model the electricity system, hydrogen value chains, and carbon capture, storage and utilization (CCUS) value chains. However, it is designed to be modular and flexible, and can be extended to model other types of energy systems, value chains or other network-based systems.

ZEN-garden is developed by the Reliability and Risk Engineering Laboratory at ETH Zurich.


Quick Start

To get started with ZEN-garden, you can follow the instructions in the installation guide.

If you want to use ZEN-garden without working on the codebase, run the following command:

pip install zen-garden

If you want to work on the codebase, fork and clone the repository and install the package in editable mode. More information on how to install the package in editable mode can be found in the installation guide.

Documentation

Please refer to the documentation of the ZEN-garden framework on Read-the-Docs.

In the file documentation/how_to_ZEN-garden.md, you can find additional information on how to use the framework. The documentation/dataset_creation_tutorial.md file contains a tutorial on how to create a simple dataset for the framework. Additionally, example datasets are available in the dataset_examples folder.

More in-depth manuals are available in the discussions forum of our repo.

News

Review recent modifications outlined in the changelog.

Citing ZEN-garden

If you use ZEN-garden for research, please cite

Jacob Mannhardt, Alissa Ganter, Johannes Burger, Francesco De Marco, Lukas Kunz, Lukas Schmidt-Engelbertz, Paolo Gabrielli, Giovanni Sansavini (2025). ZEN-garden: Optimizing energy transition pathways with user-oriented data handling. https://www.sciencedirect.com/science/article/pii/S2352711025000263

and use the following BibTeX:

@article{ZENgarden2025,
title = {ZEN-garden: Optimizing Energy Transition Pathways with User-Oriented Data Handling},
author = {Mannhardt, Jacob and Ganter, Alissa and Burger, Johannes and De Marco, Francesco and Kunz, Lukas and {Schmidt-Engelbertz}, Lukas and Gabrielli, Paolo and Sansavini, Giovanni},
year = {2025},
journal = {SoftwareX},
volume = {29},
pages = {102059},
issn = {2352-7110},
doi = {10.1016/j.softx.2025.102059},
}

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zen_garden-2.7.3.tar.gz (135.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

zen_garden-2.7.3-py3-none-any.whl (149.7 kB view details)

Uploaded Python 3

File details

Details for the file zen_garden-2.7.3.tar.gz.

File metadata

  • Download URL: zen_garden-2.7.3.tar.gz
  • Upload date:
  • Size: 135.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for zen_garden-2.7.3.tar.gz
Algorithm Hash digest
SHA256 e4886f31b318a6f84b9386dfaa6c58468e8d82efa7fafc7e7404b56943a696aa
MD5 c59f169b5307aa6fa0ae4abd1aecd5b2
BLAKE2b-256 4b233dc62618f0af6c41ef4ab768ecb5f10327a0d9e23b24c2533ba7d8fa38c8

See more details on using hashes here.

Provenance

The following attestation bundles were made for zen_garden-2.7.3.tar.gz:

Publisher: bump_and_release.yml on ZEN-universe/ZEN-garden

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zen_garden-2.7.3-py3-none-any.whl.

File metadata

  • Download URL: zen_garden-2.7.3-py3-none-any.whl
  • Upload date:
  • Size: 149.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for zen_garden-2.7.3-py3-none-any.whl
Algorithm Hash digest
SHA256 90faa1b73657583359045d7e875eeb3cd2ab7a298beabd337d1e833bd346d1c0
MD5 b93f6039ce7e3cf8cff0fd9f78daa3ce
BLAKE2b-256 05c9a14b061b3f78aa25dfbd0009afe74d96c474ecdadb64aaaa1bd2f854e36a

See more details on using hashes here.

Provenance

The following attestation bundles were made for zen_garden-2.7.3-py3-none-any.whl:

Publisher: bump_and_release.yml on ZEN-universe/ZEN-garden

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page