Skip to main content

Model Template for Renewable Energy Supply Systems (MTRESS)

Introduction

The DLR Institute of Networked Energy Systems has developed the MTRESS tool that can be used to optimise energy supply systems for new and existing projects at any location. MTRESS facilitates the creation of energy system optimisation models for individual residential and commercial buildings, as well as for neighbourhoods and entire industrial properties. It enables users to include a wide range of influencing factors and energy options in the simulation and minimises the planning effort.

This is a generic model for community-based open source oemof.solph tool. MTRESS offers a variety of possible technology combinations for energy supply systems. It includes pre-built technologies that are commonly considered in energy systems, such as:

  • Photovoltaic or wind power (as generic RenewableEnergySource)
  • Grid Connection (Electricity, Heat and Gas)
  • Heat Pumps
  • Heat Exchangers
  • Electrolysers (PEM, Alkaline, AEM)
  • Fuel Cells (PEM, Alkaline, AEM)
  • Compressors
  • Combined Heat and Power (CHP) with various gas types and gas-mixtures (e.g., H2 + Natural Gas) as input fuels
  • Storages (Battery, Heat Storage, Gas Storage (Hydrogen))
  • Resistive Heater and Gas Boiler

It covers different sectors including Electricity, Heat and Gas (e.g., H2, Natural Gas, Biogas, etc.). It is tailored for optimising control strategies fulfilling fixed demand time series for electricity, heat, gas (including hydrogen), and domestic hot water using any selected combination of the implemented supply technologies.

MTRESS requires appropriately prepared initial data on the boundary conditions of the respective project. A wide range of data sources can be used, including historical energy consumption data for the project, but also higher-level data on the location, for example from climate models or the solar cadastre. Moreover, the forecasted demands and renewable generations could also be used for scheduling optimized operation for next days. It could be used for long-term planning and the assumptions about the development of costs and the CO2 impact of the future energy mix can also be incorporated into the modelling.

As an open-source model, MTRESS is available to users in a wide range of areas. It can be utilized for both research and commercial purposes. Researchers, utility owners, and policymakers can all benefit from this tool for energy system planning and operation. Applications are not just limited to municipal heating plans, home automation offerings, hydrogen infrastructure planning, and optimized operation of sector-coupled energy systems, but extend to any scenario requiring comprehensive energy optimization and management.

Installation

MTRESS depends on solph, which is automatically installed using pip

pip install mtress

However, pip will not install a solver, to perform the actual optimisation. Please refer to the documentation of solph to learn how to install a solver.

Documentation

The auto-generated documentation can be found on the GitLab pages.
The coverage report can be found on the GitLab pages as well.

Usage and Tutorials

Please refer to the examples folder in this repository to get acquainted with building and optimizing energy systems in MTRESS. These examples will help you understand the basics and guide you through the process before you start creating your own energy system.

Please feel free to contact us if you have any questions or need further assistance. Contact information can be found below.

Acknowledgements

The development of Version 2 was funded by the Federal Ministry for Economic Affairs and Energy (BMWi) and the Federal Ministry of Education and Research (BMBF) of Germany in the project ENaQ (project number 03SBE111). The development of the heat sector formulations in Version 3 was funded by the Federal Ministry of Education and Research (BMBF) of Germany in the project Wärmewende Nordwest (project number 03SF0624). The development of the gas sector formulations in Version 3 was funded by the Federal Ministry of Education and Research (BMBF) of Germany in the project H2Giga-Systogen100 (project number 03HY115E).

Contributing

You are welcome to contribute to MTRESS. We use Black code style with 79 characters a line, and put our code under MIT license. When contributing, you need to do the same. For smaller changes, you can just open a merge request. If you plan something bigger, please open an issue first, so that we can discuss beforehand and avoid double work. Also, please report bugs by opening an issue.

Citation

If you use MTRESS Software for your research, please consider citation as follows using the Zenodo record, doi:10.5281/zenodo.6395909.

Reference

[1] Schönfeldt, Patrik and Schlüters, Sunke and Oltmanns, Keno,"MTRESS 3.0--Modell Template for Residential Energy Supply Systems", arXiv preprint, 2022, arXiv:2211.14080.

Contact

The software development is administrated by Patrik Schönfeldt, for general questions please contact him. Individual authors may leave their contact information in the citation.cff.

Metadata

Release files for mtress 26.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mtress 26.5
File Size Uploaded Provenance Actions
mtress-26.5.tar.gz 16.2 MB Without provenance Details for mtress-26.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mtress 26.5
File Interpreter ABI Platform Actions
mtress-26.5-py3-none-any.whl Python 3 none any Details for mtress-26.5-py3-none-any.whl

Total release size: 16.3 MB

Release files / mtress-26.5.tar.gz

Download URL mtress-26.5.tar.gz
Size 16.2 MB
Tags Source
SHA-256 checksum
How to use checksums
43de827c7fd85470909afa5e2c4c4dae2b597ad153d137f23d88fe699464b00c
BLAKE2b-256 checksum
How to use checksums
acce2028e97e1013eb8dcecc19b9cf3806db1bb7a629af344a4104190fcd2951
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.4

Release files / mtress-26.5-py3-none-any.whl

Download URL mtress-26.5-py3-none-any.whl
Size 84.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f6c11096719d20b2143ff45dfd219752d946e0bebc360031550f7f9cf363b586
BLAKE2b-256 checksum
How to use checksums
d5bf5ce1ef5b1aaf58bc15aeb105117dea7847f3a65d0989df2027e2d7494096
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.4

Security for mtress 26.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page