![E.ON EBC RWTH Aachen University](docs/source/_static/EBC_Logo.png)
# TEASER - Tool for Energy Analysis and Simulation for Efficient Retrofit
[![License](http://img.shields.io/:license-mit-blue.svg)](http://doge.mit-license.org)
[![Coverage Status](https://coveralls.io/repos/github/RWTH-EBC/TEASER/badge.svg)](https://coveralls.io/github/RWTH-EBC/TEASER)
[![Build Status](https://travis-ci.org/RWTH-EBC/TEASER.svg?branch=master)](https://travis-ci.org/RWTH-EBC/TEASER.svg?branch=master)
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/RWTH-EBC/TEASER/master?labpath=docs%2Fjupyter_notebooks)
TEASER (Tool for Energy Analysis and Simulation for Efficient Retrofit) allows
fast generation of archetype buildings with low input requirements and the
export of individual dynamic simulation models for the below-mentioned Modelica
libraries. These libraries all use the framework of [Modelica IBPSA
library](https://github.com/ibpsa/modelica). TEASER is being developed at the
[RWTH Aachen University, E.ON Energy Research Center, Institute for Energy
Efficient Buildings and Indoor
Climate](https://www.ebc.eonerc.rwth-aachen.de/cms/~dmzz/E-ON-ERC-EBC/?lidx=1).
* [AixLib](https://github.com/RWTH-EBC/AixLib)
* [Buildings](https://github.com/lbl-srg/modelica-buildings)
* [BuildingSystems](https://github.com/UdK-VPT/BuildingSystems)
* [IDEAS](https://github.com/open-ideas/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/
This GitHub page will be used to further develop the package and make it
available under the
[MIT License](https://github.com/RWTH-EBC/TEASER/blob/master/License.md).
If you have any questions regarding TEASER feel free to contact us at
[ebc-teaser@eonerc.rwth-aachen.de](mailto:ebc-teaser@eonerc.rwth-aachen.de).
## Description
Energy supply of buildings in urban context currently undergoes significant
changes. The increase of renewable energy sources for electrical and thermal
energy generation will require flexible and secure energy storage and
distribution systems. To reflect and consider these changes in energy systems
and buildings, dynamic simulation is one key element, in particular when it
comes to thermal energy demand on minutely or hourly scale.
Sparse and limited access to detailed building information as well as computing
times are challenges for building simulation on urban scale. In addition,
data acquisition and modeling for Building Performance Simulation (BPS) are
time consuming and error-prone. To enable the use of BPS on urban scale we
present the TEASER tool, an open framework for urban energy modeling of
building stocks. TEASER provides an easy interface for multiple data sources,
data enrichment (where necessary) and export of ready-to-run Modelica simulation
models for all libraries supporting the
[Modelica IBPSA library](https://github.com/ibpsa/modelica).
## Version
TEASER is an ongoing research project, the current version is still a pre-release.
## How to use TEASER
### Examples and jupyter notebooks
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/examples.
### Dependencies
TEASER is currently tested against Python 3.6 and 3.7. Older versions of Python may
still work, but are no longer actively supported.
Using a Python distribution is recommended as they already contain (or easily
support 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 Python
packages (e.g. SciPy, NumPy, pip, PyQT, etc.)..
2. http://conda.pydata.org/miniconda.html Conda is an open source package
management system and environment management system for installing multiple
versions of software packages and their dependencies and switching easily
between them.
In addition, TEASER requires some specific Python packages:
1. Mako: template Engine
install on a python-enabled command line with `pip install -U mako`
2. pandas: popular data analysis library
install on a python-enabled command line with `pip install -U pandas`
3. pytest: Unit Tests engine
install on a python-enabled command line with `pip install -U pytest`
### Installation
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.
### How to contribute to the development of TEASER
You are invited to contribute to the development of TEASER. You may report any issues by using the [Issues](https://github.com/RWTH-EBC/TEASER/issues) button.
Furthermore, you are welcome to contribute via [Pull Requests](https://github.com/RWTH-EBC/TEASER/pulls).
The workflow for changes is described in our [Wiki](https://github.com/RWTH-EBC/TEASER/wiki).
## How to cite TEASER
+ 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](http://dx.doi.org/10.1080/19401493.2017.1283539),
[bibtex](https://github.com/RWTH-EBC/TEASER/tree/master/doc/cite_jbps.bib)
### TEASER related publications
+ 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](http://www.ibpsa.org/proceedings/BSO2016/p1047.pdf),
[bibtex](https://github.com/RWTH-EBC/TEASER/tree/master/doc/cite.bib)
+ 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](https://www.researchgate.net/profile/Moritz_Lauster/publication/310465372_Scalable_Design-Driven_Parameterization_of_Reduced_Order_Models_using_Archetype_Buildings_with_TEASER/links/582ee96908ae004f74be1fb0.pdf?origin=publication_detail&ev=pub_int_prw_xdl&msrp=eEyK6WYemhC8wK7xkMEPRDO4obE4uxBN4-0BdBy1Ldwhy9FhCe1pXfNObJYubvC_aZN0IWDPf9uayBo3u79bsZvg3hzUoLoYRatES2ARH8c.B2cYwSICt0IOa7lD-4oAiEa_3TtrO-7k-1W9chuNQwr_VNMCpZ5ubSb-eY2D77rGUP4S6wS8m6vudUUbMlXbQQ.Cledgd1Q9fPp11nYGpcpKNhSS6bVTqAEXeMZPkiV3HsJxcVWTFj4Hr_jmLZ0MOzDxbDEZObcGiKfmTL_9k_59A)
+ Refinement of Dynamic Non-Residential Building Archetypes Using Measurement Data and Bayesian Calibration
Remmen P., Schäfer J., Müller D.. Building Simulation 2019, September 2019,
[pdf](https://www.researchgate.net/publication/337925776_Refinement_of_Dynamic_Non-Residential_Building_Archetypes_Using_Measurement_Data_and_Bayesian_Calibration)
+ 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](https://github.com/RWTH-EBC/TEASER/tree/master/doc/cite_be.bib)
+ The [Institute of Energy Efficiency and Sustainable Building](https://www.e3d.rwth-aachen.de/go/id/iyld/?) published a parametric study of TEASER where all functions and parameters used in TEASER are gathered and explained. The publication can be found [here](https://publications.rwth-aachen.de/record/749801/files/749801.pdf).
## License
TEASER is released by RWTH Aachen University, E.ON Energy
Research Center, Institute for Energy Efficient Buildings and Indoor Climate,
under the
[MIT License](https://github.com/RWTH-EBC/TEASER/blob/master/License.md).
## Acknowledgements
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 projects
and with financial support by BMWi (German Federal Ministry for Economic
Affairs and Energy).
<img src="https://www.innovation-beratung-foerderung.de/INNO/Redaktion/DE/Bilder/Titelbilder/titel_foerderlogo_bmwi.jpg?__blob=normal" width="200">
Raw data
{
"_id": null,
"home_page": "https://github.com/RWTH-EBC/TEASER",
"name": "teaser",
"maintainer": "",
"docs_url": "https://pythonhosted.org/teaser/",
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "RWTH Aachen University, E.ON Energy Research Center, Institute of Energy Efficient Buildings and Indoor Climate",
"author_email": "ebc-teaser@eonerc.rwth-aachen.de",
"download_url": "https://files.pythonhosted.org/packages/c4/66/2f7b12757c9623e8535bb7029265e3f160cd44d65c8b0424c46d14dfb0a8/teaser-0.7.7.tar.gz",
"platform": null,
"description": "![E.ON EBC RWTH Aachen University](docs/source/_static/EBC_Logo.png)\n\n# TEASER - Tool for Energy Analysis and Simulation for Efficient Retrofit\n\n[![License](http://img.shields.io/:license-mit-blue.svg)](http://doge.mit-license.org)\n[![Coverage Status](https://coveralls.io/repos/github/RWTH-EBC/TEASER/badge.svg)](https://coveralls.io/github/RWTH-EBC/TEASER)\n[![Build Status](https://travis-ci.org/RWTH-EBC/TEASER.svg?branch=master)](https://travis-ci.org/RWTH-EBC/TEASER.svg?branch=master)\n[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/RWTH-EBC/TEASER/master?labpath=docs%2Fjupyter_notebooks)\n\nTEASER (Tool for Energy Analysis and Simulation for Efficient Retrofit) allows\nfast generation of archetype buildings with low input requirements and the\nexport of individual dynamic simulation models for the below-mentioned Modelica\nlibraries. These libraries all use the framework of [Modelica IBPSA\nlibrary](https://github.com/ibpsa/modelica). TEASER is being developed at the\n[RWTH Aachen University, E.ON Energy Research Center, Institute for Energy\nEfficient Buildings and Indoor\nClimate](https://www.ebc.eonerc.rwth-aachen.de/cms/~dmzz/E-ON-ERC-EBC/?lidx=1).\n\n * [AixLib](https://github.com/RWTH-EBC/AixLib)\n * [Buildings](https://github.com/lbl-srg/modelica-buildings)\n * [BuildingSystems](https://github.com/UdK-VPT/BuildingSystems)\n * [IDEAS](https://github.com/open-ideas/IDEAS).\n\nThe full documentation of TEASER including examples and description of modules,\nclasses and functions can be found at the website:\n\n * http://rwth-ebc.github.io/TEASER/\n\nThis GitHub page will be used to further develop the package and make it\navailable under the\n[MIT License](https://github.com/RWTH-EBC/TEASER/blob/master/License.md).\n\nIf you have any questions regarding TEASER feel free to contact us at\n[ebc-teaser@eonerc.rwth-aachen.de](mailto:ebc-teaser@eonerc.rwth-aachen.de).\n\n\n## Description\n\nEnergy supply of buildings in urban context currently undergoes significant\nchanges. The increase of renewable energy sources for electrical and thermal\nenergy generation will require flexible and secure energy storage and\ndistribution systems. To reflect and consider these changes in energy systems\nand buildings, dynamic simulation is one key element, in particular when it\ncomes to thermal energy demand on minutely or hourly scale.\nSparse and limited access to detailed building information as well as computing\ntimes are challenges for building simulation on urban scale. In addition,\ndata acquisition and modeling for Building Performance Simulation (BPS) are\ntime consuming and error-prone. To enable the use of BPS on urban scale we\npresent the TEASER tool, an open framework for urban energy modeling of\nbuilding stocks. TEASER provides an easy interface for multiple data sources,\ndata enrichment (where necessary) and export of ready-to-run Modelica simulation\nmodels for all libraries supporting the\n[Modelica IBPSA library](https://github.com/ibpsa/modelica).\n\n\n## Version\n\nTEASER is an ongoing research project, the current version is still a pre-release.\n\n## How to use TEASER\n\n### Examples and jupyter notebooks\n\nWe provide different examples to show the usage of TEASER.\nCheck out the files under teaser/examples or the jupyter-notebooks available here: docs/jupyter-notebooks.\nIf you just want to read the example on github, check them here: docs/examples.\n\n### Dependencies\n\nTEASER is currently tested against Python 3.6 and 3.7. Older versions of Python may\nstill work, but are no longer actively supported.\nUsing a Python distribution is recommended as they already contain (or easily\nsupport installation of) many Python packages (e.g. SciPy, NumPy, pip, PyQT,\netc.) that are used in the TEASER code. Two examples of those distributions are:\n\n1. https://winpython.github.io/ WinPython comes along with a lot of Python\npackages (e.g. SciPy, NumPy, pip, PyQT, etc.)..\n2. http://conda.pydata.org/miniconda.html Conda is an open source package\nmanagement system and environment management system for installing multiple\nversions of software packages and their dependencies and switching easily\nbetween them.\n\nIn addition, TEASER requires some specific Python packages:\n\n1. Mako: template Engine\n install on a python-enabled command line with `pip install -U mako`\n2. pandas: popular data analysis library\n install on a python-enabled command line with `pip install -U pandas`\n3. pytest: Unit Tests engine\n install on a python-enabled command line with `pip install -U pytest`\n\n### Installation\n\nThe best option to install TEASER is to use pip:\n\n`pip install teaser`\n\nIf you actively develop TEASER you can clone this repository by using:\n\n `git clone [SSH-Key/Https]`\n\nand then run:\n\n `pip install -e [Path/to/your/Teaser/Clone]` which will install the local version of TEASER.\n\n\n### How to contribute to the development of TEASER\nYou are invited to contribute to the development of TEASER. You may report any issues by using the [Issues](https://github.com/RWTH-EBC/TEASER/issues) button.\nFurthermore, you are welcome to contribute via [Pull Requests](https://github.com/RWTH-EBC/TEASER/pulls).\nThe workflow for changes is described in our [Wiki](https://github.com/RWTH-EBC/TEASER/wiki).\n\n## How to cite TEASER\n\n+ TEASER: an open tool for urban energy modelling of building stocks. Remmen P., Lauster M., Mans M., Fuchs M., Osterhage T., M\u00fcller D.. Journal of Building Performance Simulation, February 2017,\n[pdf](http://dx.doi.org/10.1080/19401493.2017.1283539),\n[bibtex](https://github.com/RWTH-EBC/TEASER/tree/master/doc/cite_jbps.bib)\n\n### TEASER related publications\n\n+ CityGML Import and Export for Dynamic Building Performance Simulation in Modelica. Remmen P.,\nLauster M., Mans M., Osterhage T., M\u00fcller D.. BSO16, p.329-336, September 2016,\n[pdf](http://www.ibpsa.org/proceedings/BSO2016/p1047.pdf),\n[bibtex](https://github.com/RWTH-EBC/TEASER/tree/master/doc/cite.bib)\n\n+ Scalable Design-Driven Parameterization of Reduced Order Models Using Archetype Buildings with TEASER.\nLauster M., Mans M., Remmen P., Fuchs M., M\u00fcller D.. BauSIM2016, p.535-542, September 2016,\n[pdf](https://www.researchgate.net/profile/Moritz_Lauster/publication/310465372_Scalable_Design-Driven_Parameterization_of_Reduced_Order_Models_using_Archetype_Buildings_with_TEASER/links/582ee96908ae004f74be1fb0.pdf?origin=publication_detail&ev=pub_int_prw_xdl&msrp=eEyK6WYemhC8wK7xkMEPRDO4obE4uxBN4-0BdBy1Ldwhy9FhCe1pXfNObJYubvC_aZN0IWDPf9uayBo3u79bsZvg3hzUoLoYRatES2ARH8c.B2cYwSICt0IOa7lD-4oAiEa_3TtrO-7k-1W9chuNQwr_VNMCpZ5ubSb-eY2D77rGUP4S6wS8m6vudUUbMlXbQQ.Cledgd1Q9fPp11nYGpcpKNhSS6bVTqAEXeMZPkiV3HsJxcVWTFj4Hr_jmLZ0MOzDxbDEZObcGiKfmTL_9k_59A)\n\n+ Refinement of Dynamic Non-Residential Building Archetypes Using Measurement Data and Bayesian Calibration\nRemmen P., Sch\u00e4fer J., M\u00fcller D.. Building Simulation 2019, September 2019,\n[pdf](https://www.researchgate.net/publication/337925776_Refinement_of_Dynamic_Non-Residential_Building_Archetypes_Using_Measurement_Data_and_Bayesian_Calibration)\n\n+ Selecting statistical indices for calibrating building energy models. Vogt, M., Remmen P., Lauster M., Fuchs M. , M\u00fcller D.. Building and Environment 144, pages 94-107, October 2018. [bibtex](https://github.com/RWTH-EBC/TEASER/tree/master/doc/cite_be.bib)\n\n+ The [Institute of Energy Efficiency and Sustainable Building](https://www.e3d.rwth-aachen.de/go/id/iyld/?) published a parametric study of TEASER where all functions and parameters used in TEASER are gathered and explained. The publication can be found [here](https://publications.rwth-aachen.de/record/749801/files/749801.pdf).\n\n\n## License\n\nTEASER is released by RWTH Aachen University, E.ON Energy\nResearch Center, Institute for Energy Efficient Buildings and Indoor Climate,\nunder the\n[MIT License](https://github.com/RWTH-EBC/TEASER/blob/master/License.md).\n\n## Acknowledgements\n\nThis work was supported by the Helmholtz Association under the Joint Initiative \u201cEnergy System 2050 \u2013 A Contribution of the Research Field Energy\u201d.\n\nParts of TEASER have been developed within public funded projects\nand with financial support by BMWi (German Federal Ministry for Economic\nAffairs and Energy).\n\n<img src=\"https://www.innovation-beratung-foerderung.de/INNO/Redaktion/DE/Bilder/Titelbilder/titel_foerderlogo_bmwi.jpg?__blob=normal\" width=\"200\">\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Tool for Energy Analysis and Simulation for Efficient Retrofit",
"version": "0.7.7",
"project_urls": {
"Download": "https://github.com/RWTH-EBC/TEASER/archive/refs/tags/0.7.7.tar.gz",
"Homepage": "https://github.com/RWTH-EBC/TEASER"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c4662f7b12757c9623e8535bb7029265e3f160cd44d65c8b0424c46d14dfb0a8",
"md5": "0cb1f5b870fccb940e0a19c2e9cb8493",
"sha256": "aed59f5ffd2d8195ee45ccfd9d5f056bb6bef4bdaa96e4ee39785832fea78059"
},
"downloads": -1,
"filename": "teaser-0.7.7.tar.gz",
"has_sig": false,
"md5_digest": "0cb1f5b870fccb940e0a19c2e9cb8493",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 526347,
"upload_time": "2023-09-14T15:42:04",
"upload_time_iso_8601": "2023-09-14T15:42:04.750837Z",
"url": "https://files.pythonhosted.org/packages/c4/66/2f7b12757c9623e8535bb7029265e3f160cd44d65c8b0424c46d14dfb0a8/teaser-0.7.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-14 15:42:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "RWTH-EBC",
"github_project": "TEASER",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "teaser"
}