PyDHN is a Python library for storing, visualizing and managing District Heating Network (DHN) data, running simulations and automate I/O workflow, built on top of Networkx.
PyDHN can be installed using pip directly from the GitHub repository:
pip install git+https://github.com/idiap/pydhn
PyDHN is currently in a beta version, and as such, it may undergo frequent and substantial updates. The codebase is actively being developed, and new features, improvements, and optimizations may be introduced regularly.
The documentation for this beta version is currently being written and is not yet available. In the meantime, the main features are explained in the provided examples (examples/).
PyDHN: A Python library for the simulation of District Heating Networks.
Copyright (c) 2023 Idiap Research Institute, https://www.idiap.ch, EPFL, https://www.epfl.ch
Written by Roberto Boghetti roberto.boghetti@idiap.ch
This file is part of PyDHN.
PyDHN is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License version 3 as published by the Free Software Foundation.
PyDHN is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License version 3 for more details.
You should have received a copy of the GNU Affero General Public License version 3 along with PyDHN. If not, see http://www.gnu.org/licenses/
If this work was useful for you, please cite:
@article{
BOGHETTI2024130169,
title = {Verification of an open-source Python library for the simulation of district heating networks with complex topologies},
journal = {Energy},
volume = {290},
pages = {130169},
year = {2024},
issn = {0360-5442},
doi = {https://doi.org/10.1016/j.energy.2023.130169},
url = {https://www.sciencedirect.com/science/article/pii/S0360544223035636},
author = {Roberto Boghetti and Jérôme H. Kämpf},
keywords = {District energy systems, Heat grids, Simulation tools, Open-source software}
}
This module has been developed in the framework of the Eguzki research project, funded by the Swiss Federal Office of Energy, OIKEN SA, ALTIS Groupe SA, SATOM SA and RWB Valais SA.
