DHgeN is a Python module for generating District Heating Networks layouts.
It has been conceived to work with the following open datasets available in Switzerland through the GeoAdmin's REST services:
- the Swiss Federal Register of Buildings and Dwellings (RegBL)
ch.bfs.gebaeude_wohnungs_register - vector building footprints
ch.swisstopo.vec25-gebaeude - vector road network
ch.swisstopo.swisstlm3d-strassen
Alternatively, an input GeoPackage file can be used. This should be composed of the following layers:
substations(point geometry) with apeakattribute indicating the peak power of the substations in kWroads(line geometry), mandatory only if theadd_roadsoptions is set toTruefootprints(polygon geometry), mandatory only if theadd_footprintsoptions is set toTrue
An (approximation of the) Steiner tree can be created using:
- NetworkX integrated algorithm
- the Hušek et al. model
Additional information can be found in the conference paper presented at the EUROSUN 2022 Conference.
You can use pip to install this package, e.g. with:
pip install git+https://github.com/idiap/dhgen.git
For further development, download the repository, then install it in editable mode:
pip install -e /path/to/dhgen
Sample working examples can be found in /examples.
When using the husek model, the star_contractions_test compiled executable must be in the Path.
The Dockerfile provides a pipeline that compiles the model and installs all requirements:
docker build . -t dhgen
docker run dhgen python examples/generate_dhn.py
DHgeN is free to use. You are kindly invited to acknowledge its use by citing it in a research paper you are writing, reports, and/or other applicable materials. When available (pending review, expected publication in January 2023), please cite the following paper:
@inproceedings{peronato_dhgen_2022,
location = {Kassel, Germany},
title = {{DHgeN}: Automated Generation of District Heating Network Layouts for Feasibility Studies},
doi = {doi:10.18086/eurosun.2022.16.10},
eventtitle = {{EuroSun} 2022},
booktitle = {Proceedings of {EuroSun} 2022},
author = {Peronato, Giuseppe and Kämpf, Jérôme H.},
date = {2022}
}
The pre-print (authors' version before review) can be found in Idiap's publication repository.
DHgeN: a Python module for generating District Heating Networks layouts.
Copyright (c) 2022 Idiap Research Institute, http://www.idiap.ch
Written by Giuseppe Peronato [email protected]
This file is part of DHgeN.
DHgeN is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation.
DHgeN 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 General Public License for more details.
You should have received a copy of the GNU General Public License along with DHgeN. If not, see http://www.gnu.org/licenses/
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.