The districtgenerator is a Python tool for generating building-specific thermal, electrical and occupancy profiles for 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 and TU Berlin, Institute for Digital Networking of Buildings, Energy Supply Systems and Users.
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
python -m venv .venv
activate the envrionment and run:
pip install -e <path-to-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 and related approach for non-residential buildings DATA NWG:
- id: building ID (just numerate the buildings)
- building: building type (residential: single family house, terraced house, multi family house or apartment block, non-residential: Office, Administrative or Government Buildings, Research and University Teaching, Health and Care, School, Day Nursery and other Care, Culture and Leisure, Sports Facilities, Hotels, Boarding, Restaurants or Catering, Production, Workshop, Warehouse or Operations, Trade Buildings, Technical and Utility (supply and disposal), Transport, Generalized (1) Services building, Includes categories (1) to (7) and (9), Generalized (2) Production buildings and similar, Includes cat. (8), (10), (11) )
- 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.
- Non-Residential Buildings need EPW-Files.
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 projects "BF2020 Begleitforschung ENERGIEWENDEBAUEN - Modul Quartiere" (promotional reference: 03EWB003B) and "BF2020 Begleitforschung ENERGIEWENDEBAUEN - Modul Digitalisierung" (promotional reference: 04EWB003A) and with financial support by BMWK (German Federal Ministry for Economic Affairs and Climate Action).
Please raise an issue here.