diff --git a/README.md b/README.md index 0d74553df..aaa87ee87 100644 --- a/README.md +++ b/README.md @@ -1,27 +1,27 @@ -# TEASER4 - Tool for Energy Analysis and Simulation for Efficient Retrofit +# TEASER - Tool for Energy Analysis and Simulation for Efficient Retrofit -The TEASER4 tool allows the creation of archetpye as well as the representation of existing buildings and the calculation of simulation parameters for simulation models. +The TEASER tool allows the creation of archetpye as well as the representation of existing buildings and the calculation of simulation parameters for simulation models. It is being developed at the Institute for Energy Efficient Buildings and Indoor Climate (EBC) at RWTH Aachen University. This site will be used to further develop the library and make it available under the MIT License. -If you have any questions regarding TEASER4 feel free to contact us at teaser@eonerc.rwth-aachen.de. +If you have any questions regarding TEASER feel free to contact us at teaser@eonerc.rwth-aachen.de. ### License -TEASER4 is released by RWTH Aachen University's Institute for Energy Efficient Buildings and Indoor Climate (EBC) under the [MIT License](http://opensource.org/licenses/MIT). +TEASER is released by RWTH Aachen University's Institute for Energy Efficient Buildings and Indoor Climate (EBC) under the [MIT License](http://opensource.org/licenses/MIT). ### Acknowledgements -Parts of TEASER4 have been developed within public funded projects and with financial support by BMWi (German Federal Ministry for Economic Affairs and 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). ### Description -TEASER4 contains an archetype building generator as well as parameter calculation for the Low Order Model of [AixLib](https://github.com/RWTH-EBC/AixLib). TEASER4 will be able to interface arbitrary data sources. +TEASER contains an archetype building generator as well as parameter calculation for the Low Order Model of [AixLib](https://github.com/RWTH-EBC/AixLib). TEASER will be able to interface arbitrary data sources. ### Version -The current version is 0.1.4. As the idea of TEASER came up at the Institute for Energy Efficient Buildings and Indoor Climate (EBC) at RWTH Aachen University in 2012 we leave the number 4 as a reminder. +The current version is 0.2.0, which is a pre-release ### How to contribute to the development of TEASER diff --git a/doc/Literatur.bib b/doc/Literatur.bib new file mode 100644 index 000000000..a273e83d0 --- /dev/null +++ b/doc/Literatur.bib @@ -0,0 +1,180 @@ +% This file was created with JabRef 2.8.1. +% Encoding: Cp1252 + +@MISC{Bauministerkonferenz.Dezember2010, + author = {Bauministerkonferenz}, + title = {Bauwerkszuordnungskatalog}, + year = {2010}, + institution = {{Ausschuss f{\"u}r staatlichen Hochbau}} +} + +@MISC{BundesministeriumfurVerkehrBauundStadtentwicklung.30.07.2009, + author = {{Bundesministerium f{\"u}r Verkehr, Bau und Stadtentwicklung}}, + title = {{Bekanntmachung der Regeln f{\"u}r Energieverbrauchskennwerte und + der Vergleichswerte im Nichtwohngeb{\"a}udebestand}}, + year = {2009}, + address = {Berlin}, + editor = {BMVBS}, + keywords = {Archetypes;mehr info} +} + +@MISC{BundesministeriumfurVerkehrBauundStadtentwicklung.December2010, + author = {{Bundesministerium f{\"u}r Verkehr, Bau und Stadtentwicklung}}, + title = {Vereinfachung zur geometrischen und technischen {Datenaufnahme} im + {Nichtwohngeb{\"a}udebestand}}, + year = {2010}, + address = {Berlin}, + editor = {BMVBS}, + keywords = {Archetypes;mehr info}, + number = {26/2010}, + series = {BMVBS-Online-Publikation} +} + +@MISC{BundesministeriumfurWirtschaftundEnergie.2009, + author = {{Bundesministerium f{\"u}r Wirtschaft und Energie}}, + title = {Energieeinsparverordnung f{\"u}r Geb{\"a}ude: EnEV 2009}, + year = {2009}, + url = {http://www.enev-online.org/enev\_2009\_volltext/enev\_2009\_0\_090430\_bundesgesetzblatt\_amtliche\_fassung\_leseversion.pdf} +} + +@MISC{DeutschesInstitutfurNormung.Februar2013, + author = {DIN 4108}, + title = {{W{\"a}rmeschutz und Energie-Einsparung in Geb{\"a}uden - Teil 4: + W{\"a}rme- und feuchteschutztechnische Bemessungswerte}}, + month = {Februar}, + year = {2013}, + address = {Berlin}, + number = {4108-4}, + publisher = {Beuth Verlag}, + type = {Norm}, + volume = {91.120.10} +} + +@MISC{DeutschesInstitutfurNormung.Februar2005, + author = {DIN 277}, + title = {Grundfl{\"a}chen und Rauminhalte von Bauwerken im Hochbau - Teil + 2: Gliederung der Netto-Grundfl{\"a}che (Nutzfl{\"a}chen, Technische + Funktionsfl{\"a}chen und Verkehrsfl{\"a}chen)}, + month = {Februar}, + year = {2005}, + address = {Berlin}, + number = {277-2}, + publisher = {Beuth Verlag}, + type = {Norm}, + volume = {01.040.91} +} + +@MISC{DeutschesInstitutfurNormung.Juli2000, + author = {DIN 12524}, + title = {{Baustoffe und -produkte - W{\"a}rme- und feuchteschutztechnische + Eigenschaften - Tabellierte Bemessungswerte - Deutsche Fassung}}, + month = {Juli}, + year = {2000}, + address = {Berlin}, + number = {12524}, + publisher = {Beuth Verlag}, + type = {Norm}, + volume = {91.100.01} +} + +@MISC{DINV1859910, + author = {{DIN V 18599}}, + title = {{Energetische Bewertung von Geb{\"a}uden -- Berechnung des Nutz-, + End- und Prim{\"a}renergiebedarfs f{\"u}r Heizung, K{\"u}hlung, L{\"u}ftung, + Trinkwarmwasser und Beleuchtung -- Teil 10: Nutzungsrandbedingungen, + Klimadaten}}, + month = {Dezember}, + year = {2011}, + address = {Berlin}, + number = {DIN~V~18599-10}, + publisher = {Beuth Verlag GmbH}, + type = {Vornorm} +} + +@MISC{DINV185993, + author = {{DIN}}, + title = {Energetische Bewertung von Geb{\"a}uden -- Berechnung des Nutz-, + End- und Prim{\"a}renergiebedarfs f{\"u}r Heizung, K{\"u}hlung, L{\"u}ftung, + Trinkwarmwasser und Beleuchtung -- Teil 3: Nutzenergiebedarf f{\"u}r + die energetische Luftaufbereitung}, + month = {Dezember}, + year = {2011}, + address = {Berlin}, + number = {DIN~V~18599-3}, + publisher = {Beuth Verlag GmbH}, + type = {Vornorm}, + volume = {91.140.30} +} + +@ARTICLE{Hillebrand.2012, + author = {Hillebrand, G. and Streblow, R. and M{\"u}ller, D. and Arends, G. + and Kumbaroglu, G. and Madlener, R.}, + title = {Evaluation Tool and Retrofit Matrix for Office Buildings}, + journal = {EON Energy Research Series}, + year = {2012}, + volume = {4}, + number = {4} +} + +@MISC{Kaag.March2008, + author = {Kaag, W. and Ummenh{\"o}fer, T. and Fisch, M. N.}, + title = {{Forschungsprojekt energieeffiziente Sanierung von B{\"u}rogeb{\"a}uden + der 50er bis 70er Jahre - Erarbeitung einer Planungshilfe}}, + year = {2008}, + address = {Braunschweig}, + editor = {ProSAB}, + keywords = {Archetypes;mehr info} +} + +@BOOK{Lichtme.2010, + title = {Vereinfachungen f{\"u}r die energetische Bewertung von Geb{\"a}uden}, + publisher = {Universit{\"a}tsbibliothek Wuppertal}, + year = {2010}, + author = {Lichtme{\ss}, Markus}, + address = {Wuppertal} +} + +@MISC{SwissSocietyofEngineersandArchitects.March2006, + author = {{SIA 2024}}, + title = {{Standard-Nutzungsbedingungen f{\"u}r die Energie- und Geb{\"a}udetechnik}}, + year = {2006}, + address = {Zurich}, + number = {SIA 2024}, + publisher = {SIA}, + type = {Merkblatt} +} + +@BOOK{KurzverfahrenIWU, + title = {{Ein vereinfachtes, statistisch abgesichertes Verfahren zur Erhebung + von Geb{\"a}udedaten f{\"u}r die energetische Bewertung von Geb{\"a}uden}}, + publisher = {Institut Wohnen und Umwelt GmbH, Darmstadt}, + year = {2005}, + editor = {Fraunhofer IRB Verlag}, + author = {Tobias Loga and Nikolaus Diefenbach and Jens Knissel and Rolf Born}, + volume = {Bauforschung für die Praxis}, + number = {72}, + pages = {160}, + timestamp = {2016.01.13} +} + +@MISC{GermanAssociationofEngineers.March2012b, + author = {{VDI}}, + title = {Berechnung des instation{\"a}ren thermischen Verhaltens von R{\"a}umen + und Geb{\"a}uden - Raummodell}, + month = {M{\"a}rz}, + year = {2012}, + address = {D{\"u}sseldorf}, + number = {VDI 6007-1}, + publisher = {Beuth Verlag GmbH}, + type = {Richtlinie}, + volume = {91.140.10} +} + +@MISC{Abschlussbericht, + author = {M{\"u}ller, D. and Fuchs, M. and Lauster, M. and Teichmann, J.}, + title = {{EnEff:Campus - Entwicklung eines integralen Planungshilfsmittels, Projekt - Abschlussbericht}}, + month = {Juni}, + year = {2015}, + address = {Aachen}, + editor = {RWTH} +} diff --git a/doc/_build/doctrees/environment.pickle b/doc/_build/doctrees/environment.pickle index 793a4dae4..da0c2de1d 100644 Binary files a/doc/_build/doctrees/environment.pickle and b/doc/_build/doctrees/environment.pickle differ diff --git a/doc/_build/doctrees/index.doctree b/doc/_build/doctrees/index.doctree index ffa7288c4..fa7082178 100644 Binary files a/doc/_build/doctrees/index.doctree and b/doc/_build/doctrees/index.doctree differ diff --git a/doc/_build/doctrees/teaser.Data.DataHelp.doctree b/doc/_build/doctrees/teaser.Data.DataHelp.doctree index 784bc12dd..ce4ff44a3 100644 Binary files a/doc/_build/doctrees/teaser.Data.DataHelp.doctree and b/doc/_build/doctrees/teaser.Data.DataHelp.doctree differ diff --git a/doc/_build/doctrees/teaser.Data.doctree b/doc/_build/doctrees/teaser.Data.doctree index 4e1f3d203..a8cc0320f 100644 Binary files a/doc/_build/doctrees/teaser.Data.doctree and b/doc/_build/doctrees/teaser.Data.doctree differ diff --git a/doc/_build/doctrees/teaser.Examples.doctree b/doc/_build/doctrees/teaser.Examples.doctree index 1a12396be..219a3653c 100644 Binary files a/doc/_build/doctrees/teaser.Examples.doctree and b/doc/_build/doctrees/teaser.Examples.doctree differ diff --git a/doc/_build/doctrees/teaser.InputData.doctree b/doc/_build/doctrees/teaser.InputData.doctree index cf35579fc..fdf36b6f8 100644 Binary files a/doc/_build/doctrees/teaser.InputData.doctree and b/doc/_build/doctrees/teaser.InputData.doctree differ diff --git a/doc/_build/doctrees/teaser.Logic.BuildingObjects.BuildingPhysics.doctree b/doc/_build/doctrees/teaser.Logic.BuildingObjects.BuildingPhysics.doctree index 551eba0dc..0f501a869 100644 Binary files a/doc/_build/doctrees/teaser.Logic.BuildingObjects.BuildingPhysics.doctree and b/doc/_build/doctrees/teaser.Logic.BuildingObjects.BuildingPhysics.doctree differ diff --git a/doc/_build/doctrees/teaser.Logic.BuildingObjects.TypeBuildings.doctree b/doc/_build/doctrees/teaser.Logic.BuildingObjects.TypeBuildings.doctree index 420d1ad09..728a0bf27 100644 Binary files a/doc/_build/doctrees/teaser.Logic.BuildingObjects.TypeBuildings.doctree and b/doc/_build/doctrees/teaser.Logic.BuildingObjects.TypeBuildings.doctree differ diff --git a/doc/_build/doctrees/teaser.Logic.BuildingObjects.doctree b/doc/_build/doctrees/teaser.Logic.BuildingObjects.doctree index f16084515..68561d440 100644 Binary files a/doc/_build/doctrees/teaser.Logic.BuildingObjects.doctree and b/doc/_build/doctrees/teaser.Logic.BuildingObjects.doctree differ diff --git a/doc/_build/doctrees/teaser.Logic.doctree b/doc/_build/doctrees/teaser.Logic.doctree index 0eba42747..1c305df8d 100644 Binary files a/doc/_build/doctrees/teaser.Logic.doctree and b/doc/_build/doctrees/teaser.Logic.doctree differ diff --git a/doc/_build/doctrees/teaser.Project.doctree b/doc/_build/doctrees/teaser.Project.doctree index dcb33e911..c295a660f 100644 Binary files a/doc/_build/doctrees/teaser.Project.doctree and b/doc/_build/doctrees/teaser.Project.doctree differ diff --git a/doc/_build/doctrees/teaser.doctree b/doc/_build/doctrees/teaser.doctree index e9d9991cf..c14c69e5a 100644 Binary files a/doc/_build/doctrees/teaser.doctree and b/doc/_build/doctrees/teaser.doctree differ diff --git a/doc/_build/html/.buildinfo b/doc/_build/html/.buildinfo index dcc31a9dc..8d3067df9 100644 --- a/doc/_build/html/.buildinfo +++ b/doc/_build/html/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 4a7da4c93ea9191a5c370697bc2e0241 +config: 81ef64bbc860285ac36422ae6c59ab8b tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/doc/_build/html/_sources/index.txt b/doc/_build/html/_sources/index.txt index d64603430..5694fe60b 100644 --- a/doc/_build/html/_sources/index.txt +++ b/doc/_build/html/_sources/index.txt @@ -3,36 +3,36 @@ You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. -TEASER4 - Tool for Energy Analysis and Simulation for Efficient Retrofit +TEASER - Tool for Energy Analysis and Simulation for Efficient Retrofit ================================== -The TEASER4 tool allows the creation of archetpye buidlings as well as the representation of existing buildings and the calculation +The TEASER tool allows the creation of archetpye buidlings as well as the representation of existing buildings and the calculation of simulation parameters for lumped parameter simulation models. It is being developed at the Institute for Energy Efficient Buildings and Indoor Climate (EBC) at RWTH Aachen University. -If you have any questions regarding TEASER4 feel free to contact us at teaser@eonerc.rwth-aachen.de. +If you have any questions regarding TEASER feel free to contact us at teaser@eonerc.rwth-aachen.de. This software is work-in-progress. Documentation will be incomplete or missing and the software may not run properly. License ================== -TEASER4 is released by RWTH Aachen University's Institute for Energy Efficient Buildings and Indoor Climate (EBC) under the +TEASER is released by RWTH Aachen University's Institute for Energy Efficient Buildings and Indoor Climate (EBC) under the MIT License(http://opensource.org/licenses/MIT). Acknowledgements ================== -Parts of TEASER4 have been developed within public funded projects and with financial support by BMWi (German Federal Ministry for Economic Affairs and 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). Description ================== -TEASER4 contains an archetype building generator as well as parameter calculation for the Low Order Model of the AixLib (https://github.com/RWTH-EBC/AixLib). TEASER4 is able to interface arbitrary data sources. +TEASER contains an archetype building generator as well as parameter calculation for the Low Order Model of the AixLib (https://github.com/RWTH-EBC/AixLib). TEASER is able to interface arbitrary data sources. Version ================== -The current version is 0.1.3. As the idea of TEASER came up at the Institute for Energy Efficient Buildings and Indoor Climate (EBC) at RWTH Aachen University in 2012 and this is the fourth "internal" version, we leave the number 4 as a reminder. +The current version is 0.2.0, which is a pre-release How to contribute to TEASER diff --git a/doc/_build/html/_sources/teaser.Logic.BuildingObjects.TypeBuildings.txt b/doc/_build/html/_sources/teaser.Logic.BuildingObjects.TypeBuildings.txt index e7b7d2e92..854910845 100644 --- a/doc/_build/html/_sources/teaser.Logic.BuildingObjects.TypeBuildings.txt +++ b/doc/_build/html/_sources/teaser.Logic.BuildingObjects.TypeBuildings.txt @@ -1,9 +1,75 @@ TypeBuildings package ================================================== +**Description** + +The TEASER4 typebuilding package contains different modules for the creation +and parametrisation of typebuildings. In TEASER4 these typebuildings are used to +set up datasets for buildings out of limited building information. For +this, the methods are based on the following principles according to Lichtmess +:cite:`Lichtme.2010`: + +#. The building envelope is a function based on the building's net leased area + +#. The building envelope can automatically be assigned to the thermal zones + +These principles are mainly used to handle the building envelopes. +In addition it is necessary to use statistic data for the following aspects: + +* number of thermal zones + +* division of net leased area into zone areas + +* wall constructions + +* properties of construction materials + +With the help of such statistical data, it is possible to create typebuildings + using five parameters: + +* type of building + +* net leased area + +* year of construction + +* number of floors + +* height of floors + +The number of zones and respective zone areas differ for different types of buildings. +Detailed information for specific types are given below. +The connection between the building envelope area and the +building net leased area is based on BMVBS :cite:`BundesministeriumfurVerkehrBauundStadtentwicklung.December2010` where various administrative +buildings were investigated. +In addition to this relationship, it is possible to refine the dataset with further +information about the structure of the building using a method from Kaag :cite:`Kaag.March2008`. +Wall construction is often a function of year of construction. Such relationships are provided by +BMVBS :cite:`BundesministeriumfurVerkehrBauundStadtentwicklung.30.07.2009` and +are enriched by data for materials from DIN 12524 and +DIN 4108-4 :cite:`DeutschesInstitutfurNormung.Juli2000` :cite:`DeutschesInstitutfurNormung.Februar2013`. + Office module -------------------------------------------------------- +**Description** + +The office module contains a multi zone building according to BMVBS :cite:`BundesministeriumfurVerkehrBauundStadtentwicklung.December2010`. +In detail the net leased area is divided into the following thermal zone +areas: + +#. Office (50% of net leased area) + +#. Floor (25% of net leased area) + +#. Storage (15% of net leased area) + +#. Meeting (4% of net leased area) + +#. Restroom (4% of net leased area) + +#. ICT (2% of net leased area) + .. automodule:: teaser.Logic.BuildingObjects.TypeBuildings.Office :members: :undoc-members: @@ -12,6 +78,15 @@ Office module Residential module ------------------------------------------------------------- +**Description** + +The residential module contains a single zone building where the envelopes are +computed based on a method from the IWU :cite:`KurzverfahrenIWU`. +In detail the net leased area is divided into the following thermal zone +area: + +#. Single dwelling (100% of net leased area) + .. automodule:: teaser.Logic.BuildingObjects.TypeBuildings.Residential :members: :undoc-members: @@ -20,6 +95,30 @@ Residential module Institute module ----------------------------------------------------------- +**Description** + +The institute module contains a multi zone building which is based on an office +building with an additional laboratory zone. The area of the laboratory zone is +based on the data from the Forschungszentrum Jülich :cite:`Abschlussbericht`. +According to the dataset from Jülich, the typebuilding institute is based on the +buildingsclass of BWZK with the number 2200 which represents all institute +buildings which are not institute type 4 or institute type 8 :cite:`Bauministerkonferenz.Dezember2010`. +In detail the net leased area is divided into the following thermal zone areas: + +#. Office (40% of net leased area) + +#. Floor (25% of net leased area) + +#. Storage (10% of net leased area) + +#. Meeting (4% of net leased area) + +#. Restroom (4% of net leased area) + +#. ICT (2% of net leased area) + +#. Laboratory (15% of the net leased area) + .. automodule:: teaser.Logic.BuildingObjects.TypeBuildings.Institute :members: :undoc-members: @@ -28,6 +127,30 @@ Institute module Institute4 module ------------------------------------------------------------ +**Description** + +The institute type 4 module contains a multi zone building which is based on an office +building with an additional laboratory zone. The area of the laboratory zone is +based on data from the Forschungszentrum Jülich :cite:`Abschlussbericht`. +According to the dataset from Jülich, the typebuilding institute type 4 is based on the +buildingsclass of BWZK with the number 2240 :cite:`Bauministerkonferenz.Dezember2010`. +In detail the net leased +area is divided in the following thermal zone areas: + +#. Office (37.5% of net leased area) + +#. Floor (22.5% of net leased area) + +#. Storage (10% of net leased area) + +#. Meeting (4% of net leased area) + +#. Restroom (4% of net leased area) + +#. ICT (2% of net leased area) + +#. Laboratory (20% of the net leased area) + .. automodule:: teaser.Logic.BuildingObjects.TypeBuildings.Institute4 :members: :undoc-members: @@ -36,6 +159,30 @@ Institute4 module Institute8 module ------------------------------------------------------------ +**Description** + +The institute type 8 module contains a multi zone building which is based on an office +building with an additional laboratory zone. The area of the laboratory zone is +based on data from the Forschungszentrum Jülich :cite:`Abschlussbericht`. +According to the dataset from Jülich, the typebuilding institute type 8 is based on the +buildingsclass of BWZK with the number 2240 :cite:`Bauministerkonferenz.Dezember2010`. +In detail the net leased +area is divided in the following thermal zone areas: + +#. Office (10% of net leased area) + +#. Floor (18% of net leased area) + +#. Storage (2% of net leased area) + +#. Meeting (4% of net leased area) + +#. Restroom (4% of net leased area) + +#. ICT (2% of net leased area) + +#. Laboratory (60% of the net leased area) + .. automodule:: teaser.Logic.BuildingObjects.TypeBuildings.Institute8 :members: :undoc-members: @@ -53,9 +200,31 @@ TypeBuilding module UseConditionsOffice18599 module -------------------------------------------------------------------------- -.. automodule:: teaser.Logic.BuildingObjects.TypeBuildings.UseConditionsOffice18599 +**Description** + +The UseConditionsOffice18599 module contains the useconditions for the +typebuildings according to the DIN V 18599 :cite:`DINV1859910` and the SIA 2024 :cite:`SwissSocietyofEngineersandArchitects.March2006`. +In detail the attributes are structured in the following sections: + +* Usage and operation times + +* Lighting (The hourly profiles here are based on the usage and operation times) + +* Room climate + +* Internal gains + +* Misc + + +.. automodule:: teaser.Logic.BuildingObjects.TypeBuildings.UseConditions18599 :members: :undoc-members: :show-inheritance: +Literature +----------------------------------------------------------------------------- +.. bibliography:: Literatur.bib + :style: unsrt + :encoding: latex+latin \ No newline at end of file diff --git a/doc/_build/html/_sources/teaser.txt b/doc/_build/html/_sources/teaser.txt index 9f3603c37..1b8d3365d 100644 --- a/doc/_build/html/_sources/teaser.txt +++ b/doc/_build/html/_sources/teaser.txt @@ -28,7 +28,7 @@ The source folder contains different subpackages and one Project module Project module ````````````` -TEASER4 API +TEASER API Data package ````````````` diff --git a/doc/_build/html/genindex.html b/doc/_build/html/genindex.html index e02da5ca1..beb403a19 100644 --- a/doc/_build/html/genindex.html +++ b/doc/_build/html/genindex.html @@ -7,7 +7,7 @@
-