The districtgenerator is a Python tool for generating building-specific thermal, electrical and occupancy profiles for residential districts. By integrating several open-source data bases and tools like TEASER and richardsonpy, the districtgenerator is designed to provide easy access to profile generation.
The districtgenerator is being developed at RWTH Aachen University, E.ON Energy Research Center, Institute for Energy Efficient Buildings and Indoor Climate.
The districtgenerator is an ongoing research project. The current version is v0.1.0.
To install, first clone this repository with
git clone https://github.com/RWTH-EBC/districtgenerator
and secondly run:
pip install -e districtgenerator
Once you have installed the generator, you can check the examples to learn how to use the different components.
To generate your district, you need to know some information about its buildings. The minimal input data set was defined following the TABULA archetype approach:
- id: building ID (just numerate the buildings)
- building: residential building type (single family house, terraced house, multi family house or apartment block)
- year: construction year (the calendar year in which the building was constructed)
- retrofit: retrofit state according to TABULA (0: existing state, 1: usual refurbishment, 2: advanced refurbishment)
- area: reference floor area (given in square meters)
Please find a template here.
After executing district generation you can find building-specific profiles in the .csv format in folder results/demands. The results contain:
- heat: space heating demand
- dhw: domestic hot water demand
- elec: electricity demand for lighting and electric household devices
- occ: number of persons present
- gains: internal gains from persons, lighting and electric household devices
All values are given in Watt and for the time resolution you require.
The districtgenerator is released by RWTH Aachen University, E.ON Energy Research Center, Institute for Energy Efficient Buildings and Indoor Climate, under the MIT License.
coming soon :)
The districtgenerator has been developed within the public funded project "BF2020 Begleitforschung ENERGIEWENDEBAUEN - Modul Quartiere" (promotional reference: 03EWB003B) and with financial support by BMWK (German Federal Ministry for Economic Affairs and Climate Action).
Please raise an issue here.