districtgenerator

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.

Version

The districtgenerator is an ongoing research project. The current version is v0.1.0.

Getting started

Install the districtgenerator

To install, first clone this repository with

git clone https://github.com/RWTH-EBC/districtgenerator

and secondly run:

pip install -e districtgenerator

How to get started?

Once you have installed the generator, you can check the examples to learn how to use the different components.

Minimum required input data

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.

What you get

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.

License

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.

Reference

coming soon :)

Acknowledgements

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).

Problems?

Please raise an issue here.