District Energy System (DES)

A Python package for simulating district heating networks using the mosaik co-simulation framework. Models include heat pumps, CHP units, boilers, PV systems, battery storage, and thermal tanks.

Developed at Hochschule Offenburg – Institute for Sustainable Energy Systems INES.

Installation

Create a new conda environment:

conda create --name des_sim python=3.10.13
conda activate des_sim
pip install DES-sim

(If you plan to modify the core models in the src/ folder, install in editable mode instead using pip install -e .)

Usage

Run the simulation from the project root:

python main_sim.py

Configuration is pulled from data/inputs/input_params.json, and outputs are saved to data/outputs/.

Documentation

The documentation for the individual models is available here.