Repository files navigation

TEASER (Tool for Energy Analysis and Simulation for Efficient Retrofit) allowsfast generation of archetype buildings with low input requirements and theexport of individual dynamic simulation models for the below-mentioned Modelicalibraries. These libraries all use the framework ofModelica IBPSAlibrary. TEASER is being developed at theRWTH Aachen University, E.ON Energy Research Center, Institute for EnergyEfficient Buildings and IndoorClimate.

• AixLib
• BESMod
• Buildings
• BuildingSystems
• IDEAS.

The full documentation of TEASER including examples and description of modules,classes and functions can be found at the website:

• http://rwth-ebc.github.io/TEASER/

If you have any questions regarding TEASER feel free to contact us atebc-tools@eonerc.rwth-aachen.de.

Energy supply of buildings in urban context currently undergoes significantchanges. The increase of renewable energy sources for electrical and thermalenergy generation will require flexible and secure energy storage anddistribution systems. To reflect and consider these changes in energy systemsand buildings, dynamic simulation is one key element, in particular when itcomes to thermal energy demand on minutely or hourly scale.Sparse and limited access to detailed building information as well as computingtimes are challenges for building simulation on urban scale. In addition,data acquisition and modeling for Building Performance Simulation (BPS) aretime consuming and error-prone. To enable the use of BPS on urban scale wepresent the TEASER tool, an open framework for urban energy modeling ofbuilding stocks. TEASER provides an easy interface for multiple data sources,data enrichment (where necessary) and export of ready-to-run Modelica simulationmodels for all libraries supporting theModelica IBPSA library.

We provide different examples to show the usage of TEASER.Check out the files under teaser/examples or the jupyter-notebooks available here:docs/jupyter_notebooks.If you just want to read the example on github, check them here:docs/source/jupyter_notebooks.

TEASER is currently tested against Python 3.7 up to 3.12. Older versions of Python maystill work, but are no longer actively supported.Using a Python distribution is recommended as they already contain (or easilysupport installation of) many Python packages (e.g. SciPy, NumPy, pip, PyQT,etc.) that are used in the TEASER code. Two examples of those distributions are:

1. https://winpython.github.io/ WinPython comes along with a lot of Pythonpackages (e.g. SciPy, NumPy, pip, PyQT, etc.)..
2. http://conda.pydata.org/miniconda.html Conda is an open source packagemanagement system and environment management system for installing multipleversions of software packages and their dependencies and switching easilybetween them.

In addition, TEASER requires some specific Python packages:

1. Mako: template Engineinstall on a python-enabled command line withpip install -U mako
2. pandas: popular data analysis libraryinstall on a python-enabled command line withpip install -U pandas
3. pytest: Unit Tests engineinstall on a python-enabled command line withpip install -U pytest

The best option to install TEASER is to use pip:

pip install teaser

If you actively develop TEASER you can clone this repository by using:

git clone [SSH-Key/Https]

and then run:

pip install -e [Path/to/your/Teaser/Clone] which will install the local version of TEASER.

You are invited to contribute to the development of TEASER. You may report any issues by using theIssues button.Furthermore, you are welcome to contribute viaPull Requests.The workflow for changes is described in ourWiki.

• TEASER: an open tool for urban energy modelling of building stocks. Remmen P., Lauster M., Mans M., Fuchs M., Osterhage T., Müller D.. Journal of Building Performance Simulation, February 2017,pdf,bibtex

• CityGML Import and Export for Dynamic Building Performance Simulation in Modelica. Remmen P.,Lauster M., Mans M., Osterhage T., Müller D.. BSO16, p.329-336, September 2016,pdf,bibtex

• Scalable Design-Driven Parameterization of Reduced Order Models Using Archetype Buildings with TEASER.Lauster M., Mans M., Remmen P., Fuchs M., Müller D.. BauSIM2016, p.535-542, September 2016,pdf

• Refinement of Dynamic Non-Residential Building Archetypes Using Measurement Data and Bayesian CalibrationRemmen P., Schäfer J., Müller D.. Building Simulation 2019, September 2019,pdf

• Selecting statistical indices for calibrating building energy models. Vogt, M., Remmen P., Lauster M., Fuchs M. , Müller D.. Building and Environment 144, pages 94-107, October 2018.bibtex

• TheInstitute of Energy Efficiency and Sustainable Building published a parametric study of TEASER where all functions and parameters used in TEASER are gathered and explained. The publication can be foundhere.

• “Modeling District Heating and Cooling Systems with URBANopt, GeoJSON to Modelica Translator, and the Modelica Buildings Library.”Long, Nicholas, Antoine Gautier, Hagar Elarga, Amy Allen, Ted Summer, Lauren Klun, Nathan Moore, and Michael Wetter. 2021.In Building Simulation 2021, 8. Bruges, Brussels.https://docs.urbanopt.net/doc_files/modeling_des_paper.pdf.

TEASER is released by RWTH Aachen University, E.ON EnergyResearch Center, Institute for Energy Efficient Buildings and Indoor Climate,under theMIT License.

This work was supported by the Helmholtz Association under the Joint Initiative “Energy System 2050 – A Contribution of the Research Field Energy”.

Parts of TEASER have been developed within public funded projectsand with financial support by BMWi (German Federal Ministry for EconomicAffairs and Energy).