This is the Tool for Efficient CityGML District Energy Modelling (TECDEM). It is a Python-based tool that utilizes CityGML, the EnergyADE, and the DistrictGenerator (also known as Quartiersgenerator) to easily parameterize districts based on CityGML files, extract and enrich data for simulation, and visualize the results.
TECDEM is a tool that can be used to extract geometry and further information for simulation of districts. We consider districts and tools for their modeling and simulation, as districts provide an important scale in the energy transition. They offer more flexibility than a single building and can be considered the smallest cell of energy transition.
TECDEM is currently under heavy development. An overview of the current functionalities can be found in the experiments folder. Currently, surfaces can be extracted from both CityGML and CityJSON.
To install TECDEM, follow these steps:
- Clone this repository
- Run:
pip install -r requirements.txt - Navigate to the
srcfolder and clone this fork of the DistrictGenerator. Install it accordingly.
For a complete list of dependencies, please refer to the requirements.txt file in the repository.
Please refer to the experiments in the repository for examples of how to use TECDEM. Generally, usage is suggested as follows:
- Load the CityGML file(s)
- Extract the information, e.g. year of construction of building type
- Save detailed information and geometry
- Create low level simulation scenario
- Enrich the basic archetype with geometry
- Run the simulation
TECDEM utilizes CityDPC componenets for geometry extraction and further processing. The strucuture of the project is displayed in the following diagram:
The tool is currently under active development. Future updates and releases are planned, as well as publication in a journal. Stay tuned for more features and improvements.
- Planned to allow for different spatial merges.
- Verifaction and validation of GML files.
- Write results to CityGML + EnergyADE files
TECDEM is developed and maintained by Felix Rehmann. For inquiries, please contact: rehmann@tu-berlin.de
TECDEM is licensed under the MIT License.
At present, there are no other contributors to the project. However, we welcome contributions and feedback from the community.
TECDEM utilizes CityDPC componenets for geometry extraction and further processing.
TECDEM utilizes DistrictGenerator for the simulation of the districts, in a forked version: DistrictGenerator
TECDEM utilizes TABULA for archetype enrichment of residential buildings.
TECDEM utilizes DataNWG for the archetype enrichment of non-residential buildings.