teaser.logic.buildingobjects.buildingphysics package

Submodules

teaser.logic.buildingobjects.buildingphysics.buildingelement module

This module contains the Base class for all building elements.

class teaser.logic.buildingobjects.buildingphysics.buildingelement.BuildingElement(parent=None)

Bases: object

Building element class.

This is the base class for all building elements. Building elements are all physical elements that may serve as boundaries for a thermal zone or building.

Parameters:

parentThermalZone()

The parent class of this object, the ThermalZone the BE belongs to. Allows for better control of hierarchical structures. Default is None.

Attributes:

internal_idfloat

Random id for the distinction between different elements.

namestr

Individual name

construction_datastr

Type of construction (e.g. “heavy” or “light”). Needed for distinction between different constructions types in the same building age period.

year_of_retrofitint

Year of last retrofit

year_of_constructionint

Year of first construction

building_age_grouplist

Determines the building age period that this building element belongs to [begin, end], e.g. [1984, 1994]

areafloat [m2]

Area of building element

tiltfloat [degree]

Tilt against horizontal

orientationfloat [degree]

Azimuth direction of building element (0 : north, 90: east, 180: south, 270: west)

inner_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection inner side (facing the zone)

inner_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation inner side (facing the zone)

outer_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

outer_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

layerlist

List of all layers of a building element (to be filled with Layer objects). Use element.layer = None to delete all layers of the building element

Calculated Attributes

r1float [K/W]

equivalent resistance R1 of the analogous model given in VDI 6007

r2float [K/W]

equivalent resistance R2 of the analogous model given in VDI 6007

r3float [K/W]

equivalent resistance R3 of the analogous model given in VDI 6007

c1float [J/K]

equivalent capacity C1 of the analogous model given in VDI 6007

c2float [J/K]

equivalent capacity C2 of the analogous model given in VDI 6007

c1_korrfloat [J/K]

corrected capacity C1,korr for building elements in the case of asymmetrical thermal load given in VDI 6007

u_valuefloat [W/m2K)

U-Value of building element

ua_valuefloat [W/K]

UA-Value of building element (Area times U-Value)

r_inner_convfloat [K/W]

Convective resistance of building element on inner side (facing the zone)

r_inner_radfloat [K/W]

Radiative resistance of building element on inner side (facing the zone)

r_inner_combfloat [K/W]

Combined convective and radiative resistance of building element on inner side (facing the zone)

r_outer_convfloat [K/W]

Convective resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_radfloat [K/W]

Radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_combfloat [K/W]

Combined convective and radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

wf_outfloat

Weightfactor of building element ua_value/ua_value_zone

add_layer(layer, position=None)

Adds a layer at a certain position

This function adds a Layer instance to the layer list at a given position

Parameters:

layerinstance of Layer

Layer instance of TEASER

positionint

position in the wall starting from 0 (inner side)

add_layer_list(layer_list)

Appends a layer set to the layer list

The layer list has to be in correct order

Parameters:

layer_listlist

list of sorted TEASER Layer instances

property area

calc_ua_value()

U*A value for building element.

Calculates the U*A value and resistances for radiative and convective heat transfer of a building element.

property construction_data

delete_type_element(data_class=None)

Deletes typical element.

Deletes typical building elements according to their construction year and their construction type in the the json file for type building elements. If the Project parent is set, it automatically saves it to the file given in Project.data. Alternatively you can specify a path to a file of TypeBuildingElements. If this file does not exist, a new file is created.

Parameters:

data_classDataClass()

DataClass containing the bindings for TypeBuildingElement and Material (typically this is the data class stored in prj.data, but the user can individually change that. Default is self.parent.parent.parent.data (which is data_class in current project)

gather_element_properties()

Helper function for matrix calculation.

Gathers all material properties of the building element and returns them as a np.array. Needed for the calculation of the matrix in equivalent_res(t_bt) especially for walls.

Returns:

number_of_layerint

number of layer (length of layer list)

densitynp.array

Numpy array with length of number of layer, filled with density of each layer

thermal_conducnp.array

Numpy array with length of number of layer, filled with thermal_conduc of each layer

heat_capacnp.array

Numpy array with length of number of layer, filled with heat_capac of each layer

thicknessnp.array

Numpy array with length of number of layer, filled with thickness of each layer

property inner_convection

property inner_radiation

property layer

load_type_element(year, construction, data_class=None)

Typical element loader.

Loads typical building elements according to their construction year and their construction type from a json.

This function will only work if the parents to Building are set.

Parameters:

yearint

Year of construction

constructionstr

Construction type, code list (‘heavy’, ‘light’)

data_classDataClass()

DataClass containing the bindings for TypeBuildingElement and Material (typically this is the data class stored in prj.data, but the user can individually change that. Default is self.parent.parent.parent.data (which is data_class in current project)

property name

property orientation

property outer_convection

property outer_radiation

save_type_element(data_class=None)

Typical element saver.

Saves typical building elements according to their construction year and their construction type in the the json file for type building elements. If the Project parent is set, it automatically saves it to the file given in Project.data. Alternatively you can specify a path to a file of TypeBuildingElements. If this file does not exist, a new file is created.

Parameters:

data_classDataClass()

DataClass containing the bindings for TypeBuildingElement and Material (typically this is the data class stored in prj.data, but the user can individually change that. Default is self.parent.parent.parent.data (which is data_class in current project)

set_calc_default()

Sets all calculated values of the Building Element to zero

property tilt

property year_of_construction

property year_of_retrofit

teaser.logic.buildingobjects.buildingphysics.ceiling module

class teaser.logic.buildingobjects.buildingphysics.ceiling.Ceiling(InnerWall)

Bases: InnerWall

This class represents a ceiling and is a child of InnerWall()

Parameters:

parentThermalZone()

The parent class of this object, the ThermalZone the BE belongs to. Allows for better control of hierarchical structures. If not None it adds this Ceiling to ThermalZone.ceilings. Default is None.

Attributes:

internal_idfloat

Random id for the distinction between different elements.

namestr

Individual name

construction_datastr

Type of construction (e.g. “heavy” or “light”). Needed for distinction between different constructions types in the same building age period.

year_of_retrofitint

Year of last retrofit

year_of_constructionint

Year of first construction

building_age_grouplist

Determines the building age period that this building element belongs to [begin, end], e.g. [1984, 1994]

areafloat [m2]

Area of building element

tiltfloat [degree]

Tilt against horizontal, default is 0.0

orientationfloat [degree]

Azimuth direction of building element (0 : north, 90: east, 180: south, 270: west), default is -1, for horizontal ceiling

inner_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection inner side (facing the zone), default is 1.7

inner_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation inner side (facing the zone), default is 5.0

outer_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

outer_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

layerlist

List of all layers of a building element (to be filled with Layer objects). Use element.layer = None to delete all layers of the building element

Calculated Attributes

r1float [K/W]

equivalent resistance R1 of the analogous model given in VDI 6007

r2float [K/W]

equivalent resistance R2 of the analogous model given in VDI 6007

r3float [K/W]

equivalent resistance R3 of the analogous model given in VDI 6007

c1float [J/K]

equivalent capacity C1 of the analogous model given in VDI 6007

c2float [J/K]

equivalent capacity C2 of the analogous model given in VDI 6007

c1_korrfloat [J/K]

corrected capacity C1,korr for building elements in the case of asymmetrical thermal load given in VDI 6007

ua_valuefloat [W/K]

UA-Value of building element (Area times U-Value)

r_inner_convfloat [K/W]

Convective resistance of building element on inner side (facing the zone)

r_inner_radfloat [K/W]

Radiative resistance of building element on inner side (facing the zone)

r_inner_convfloat [K/W]

Combined convective and radiative resistance of building element on inner side (facing the zone)

r_outer_convfloat [K/W]

Convective resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_radfloat [K/W]

Radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_convfloat [K/W]

Combined convective and radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

wf_outfloat

Weightfactor of building element ua_value/ua_value_zone

teaser.logic.buildingobjects.buildingphysics.door module

class teaser.logic.buildingobjects.buildingphysics.door.Door(parent=None)

Bases: OuterWall

Outer door class

This class holds information of an entrance door and is a child of OuterWall()

Will be treated exactly as OuterWalls, we need this distinction due to Door class in Tabula

Parameters:

parentThermalZone()

The parent class of this object, the ThermalZone the BE belongs to. Allows for better control of hierarchical structures. If not None it adds this OuterWall to ThermalZone.outer_walls. Default is None.

Attributes:

internal_idfloat

Random id for the distinction between different elements.

namestr

Individual name

construction_datastr

Type of construction (e.g. “heavy” or “light”). Needed for distinction between different constructions types in the same building age period.

year_of_retrofitint

Year of last retrofit

year_of_constructionint

Year of first construction

building_age_grouplist

Determines the building age period that this building element belongs to [begin, end], e.g. [1984, 1994]

areafloat [m2]

Area of building element

tiltfloat [degree]

Tilt against horizontal, default is 90.0

orientationfloat [degree]

Azimuth direction of building element (0 : north, 90: east, 180: south, 270: west)

inner_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection inner side (facing the zone), default 2.7

inner_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation inner side (facing the zone), default 5.0

outer_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection outer side (facing the ambient or adjacent zone), default 20.0

outer_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation outer side (facing the ambient or adjacent zone), default 5.0

layerlist

List of all layers of a building element (to be filled with Layer objects). Use element.layer = None to delete all layers of the building element

Calculated Attributes

r1float [K/W]

equivalent resistance R1 of the analogous model given in VDI 6007

r2float [K/W]

equivalent resistance R2 of the analogous model given in VDI 6007

r3float [K/W]

equivalent resistance R3 of the analogous model given in VDI 6007

c1float [J/K]

equivalent capacity C1 of the analogous model given in VDI 6007

c2float [J/K]

equivalent capacity C2 of the analogous model given in VDI 6007

c1_korrfloat [J/K]

corrected capacity C1,korr for building elements in the case of asymmetrical thermal load given in VDI 6007

ua_valuefloat [W/K]

UA-Value of building element (Area times U-Value)

r_inner_convfloat [K/W]

Convective resistance of building element on inner side (facing the zone)

r_inner_radfloat [K/W]

Radiative resistance of building element on inner side (facing the zone)

r_inner_convfloat [K/W]

Combined convective and radiative resistance of building element on inner side (facing the zone)

r_outer_convfloat [K/W]

Convective resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_radfloat [K/W]

Radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_convfloat [K/W]

Combined convective and radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

wf_outfloat

Weightfactor of building element ua_value/ua_value_zone

property parent

teaser.logic.buildingobjects.buildingphysics.floor module

class teaser.logic.buildingobjects.buildingphysics.floor.Floor(InnerWall)

Bases: InnerWall

This class represents a floor and is a child of InnerWall()

Parameters:

parentThermalZone()

The parent class of this object, the ThermalZone the BE belongs to. Allows for better control of hierarchical structures. If not None it adds this Floor to ThermalZone.floors. Default is None.

Attributes:

internal_idfloat

Random id for the distinction between different elements.

namestr

Individual name

construction_datastr

Type of construction (e.g. “heavy” or “light”). Needed for distinction between different constructions types in the same building age period.

year_of_retrofitint

Year of last retrofit

year_of_constructionint

Year of first construction

building_age_grouplist

Determines the building age period that this building element belongs to [begin, end], e.g. [1984, 1994]

areafloat [m2]

Area of building element

tiltfloat [degree]

Tilt against horizontal, default is 0.0

orientationfloat [degree]

Azimuth direction of building element (0 : north, 90: east, 180: south, 270: west), default is -2, for horizontal floor

inner_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection inner side (facing the zone), default is 1.7

inner_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation inner side (facing the zone), default is 5.0

outer_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

outer_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

layerlist

List of all layers of a building element (to be filled with Layer objects). Use element.layer = None to delete all layers of the building element

Calculated Attributes

r1float [K/W]

equivalent resistance R1 of the analogous model given in VDI 6007

r2float [K/W]

equivalent resistance R2 of the analogous model given in VDI 6007

r3float [K/W]

equivalent resistance R3 of the analogous model given in VDI 6007

c1float [J/K]

equivalent capacity C1 of the analogous model given in VDI 6007

c2float [J/K]

equivalent capacity C2 of the analogous model given in VDI 6007

c1_korrfloat [J/K]

corrected capacity C1,korr for building elements in the case of asymmetrical thermal load given in VDI 6007

ua_valuefloat [W/K]

UA-Value of building element (Area times U-Value)

r_inner_convfloat [K/W]

Convective resistance of building element on inner side (facing the zone)

r_inner_radfloat [K/W]

Radiative resistance of building element on inner side (facing the zone)

r_inner_convfloat [K/W]

Combined convective and radiative resistance of building element on inner side (facing the zone)

r_outer_convfloat [K/W]

Convective resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_radfloat [K/W]

Radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_convfloat [K/W]

Combined convective and radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

wf_outfloat

Weightfactor of building element ua_value/ua_value_zone

teaser.logic.buildingobjects.buildingphysics.groundfloor module

class teaser.logic.buildingobjects.buildingphysics.groundfloor.GroundFloor(parent=None)

Bases: OuterWall

GroundFloor class

This class holds information of a GroundFloor and is a child of OuterWall()

Parameters:

parentThermalZone()

The parent class of this object, the ThermalZone the BE belongs to. Allows for better control of hierarchical structures. If not None it adds this GroundFloor to ThermalZone.ground_floors. Default is None.

Attributes:

internal_idfloat

Random id for the distinction between different elements.

namestr

Individual name

construction_datastr

Type of construction (e.g. “heavy” or “light”). Needed for distinction between different constructions types in the same building age period.

year_of_retrofitint

Year of last retrofit

year_of_constructionint

Year of first construction

building_age_grouplist

Determines the building age period that this building element belongs to [begin, end], e.g. [1984, 1994]

areafloat [m2]

Area of building element

tiltfloat [degree]

Tilt against horizontal, default is 0.0

orientationfloat [degree]

Azimuth direction of building element (0 : north, 90: east, 180: south, 270: west), orientation -2.0

inner_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection inner side (facing the zone), default 1.7

inner_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation inner side (facing the zone), default 5.0

outer_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection outer side (facing the ambient or adjacent zone), default 0.0

outer_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation outer side (facing the ambient or adjacent zone), default 0.0

layerlist

List of all layers of a building element (to be filled with Layer objects). Use element.layer = None to delete all layers of the building element

Calculated Attributes

r1float [K/W]

equivalent resistance R1 of the analogous model given in VDI 6007

r2float [K/W]

equivalent resistance R2 of the analogous model given in VDI 6007

r3float [K/W]

equivalent resistance R3 of the analogous model given in VDI 6007

c1float [J/K]

equivalent capacity C1 of the analogous model given in VDI 6007

c2float [J/K]

equivalent capacity C2 of the analogous model given in VDI 6007

c1_korrfloat [J/K]

corrected capacity C1,korr for building elements in the case of asymmetrical thermal load given in VDI 6007

calc_u: Required area-specific U-value in retrofit cases [W/K]

ua_valuefloat [W/K]

UA-Value of building element (Area times U-Value)

r_inner_convfloat [K/W]

Convective resistance of building element on inner side (facing the zone)

r_inner_radfloat [K/W]

Radiative resistance of building element on inner side (facing the zone)

r_inner_convfloat [K/W]

Combined convective and radiative resistance of building element on inner side (facing the zone)

r_outer_convfloat [K/W]

Convective resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_radfloat [K/W]

Radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_convfloat [K/W]

Combined convective and radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

wf_outfloat

Weightfactor of building element ua_value/ua_value_zone

retrofit_wall(year_of_retrofit, material=None)

Retrofits wall to German refurbishment standards.

This function adds an additional layer of insulation and sets the thickness of the layer according to the retrofit standard in the year of refurbishment. Refurbishment year must be newer then 1977

Note: To Calculate thickness and U-Value, the standard TEASER coefficients for outer and inner heat transfer are used.

The used Standards are namely the Waermeschutzverordnung (WSVO) and Energieeinsparverordnung (EnEv)

Parameters:

materialstring

Type of material, that is used for insulation

year_of_retrofitint

Year of the retrofit of the wall/building

teaser.logic.buildingobjects.buildingphysics.innerwall module

class teaser.logic.buildingobjects.buildingphysics.innerwall.InnerWall(parent=None)

Bases: Wall

InnerWall class

This class holds information for an inner wall and is a child of Wall()

Parameters:

parentThermalZone()

The parent class of this object, the ThermalZone the BE belongs to. Allows for better control of hierarchical structures. If not None it adds this InnerWall to ThermalZone.inner_walls. Default is None.

Attributes:

internal_idfloat

Random id for the distinction between different elements.

namestr

Individual name

construction_datastr

Type of construction (e.g. “heavy” or “light”). Needed for distinction between different constructions types in the same building age period.

year_of_retrofitint

Year of last retrofit

year_of_constructionint

Year of first construction

building_age_grouplist

Determines the building age period that this building element belongs to [begin, end], e.g. [1984, 1994]

areafloat [m2]

Area of building element

tiltfloat [degree]

Tilt against horizontal, default is 90.0

orientationfloat [degree]

Azimuth direction of building element (0 : north, 90: east, 180: south, 270: west)

inner_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection inner side (facing the zone), default 1.7

inner_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation inner side (facing the zone), default 5.0

outer_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

outer_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

layerlist

List of all layers of a building element (to be filled with Layer objects). Use element.layer = None to delete all layers of the building element

Calculated Attributes

r1float [K/W]

equivalent resistance R1 of the analogous model given in VDI 6007

r2float [K/W]

equivalent resistance R2 of the analogous model given in VDI 6007

r3float [K/W]

equivalent resistance R3 of the analogous model given in VDI 6007

c1float [J/K]

equivalent capacity C1 of the analogous model given in VDI 6007

c2float [J/K]

equivalent capacity C2 of the analogous model given in VDI 6007

c1_korrfloat [J/K]

corrected capacity C1,korr for building elements in the case of asymmetrical thermal load given in VDI 6007

ua_valuefloat [W/K]

UA-Value of building element (Area times U-Value)

r_inner_convfloat [K/W]

Convective resistance of building element on inner side (facing the zone)

r_inner_radfloat [K/W]

Radiative resistance of building element on inner side (facing the zone)

r_inner_convfloat [K/W]

Combined convective and radiative resistance of building element on inner side (facing the zone)

r_outer_convfloat [K/W]

Convective resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_radfloat [K/W]

Radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_convfloat [K/W]

Combined convective and radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

wf_outfloat

Weightfactor of building element ua_value/ua_value_zone

property parent

teaser.logic.buildingobjects.buildingphysics.layer module

class teaser.logic.buildingobjects.buildingphysics.layer.Layer(parent=None, id=0)

Bases: object

Layer class

This class holds information of a layer of a specific building element.

Parameters:

parentBuildingElement

The parent class of this object, the Building Element the layer belongs to. Allows for better control of hierarchical structures. If not None this adds the Layer to BuildingElement.layers. Default is None

Attributes:

idint

Position (starting from 0 and the inner side)

materialMaterial()

Material class of TEASER

thicknessfloat [m]

Thickness of the layer

property material

property parent

property thickness

teaser.logic.buildingobjects.buildingphysics.material module

class teaser.logic.buildingobjects.buildingphysics.material.Material(parent=None)

Bases: object

Material class

This class holds information of Material used for building element layer.

Parameters:

parentLayer

The parent class of this object, the layer the material belongs to. Allows for better control of hierarchical structures. If not None this adds this Material to Layer.material. Default is None

Attributes:

namestr

Name of material

densityfloat [kg/m3]

Density of material

thermal_conducfloat [W/(m*K)]

Thermal conductivity of material

heat_capacfloat [kJ/(kg*K)]

Specific heat capacity of material

solar_absorpfloat [-]

Coefficient of absorption of solar short wave

ir_emissivityfloat [-]

Coefficient of longwave emissivity of material

transmittancefloat [-]

Coefficient of transmittance of material

thickness_defaultfloat [m]

Default value for material thickness

thickness_listlist

List of usual values for material thickness, float [m]

material_idstr(uuid)

UUID of material, this is used to have similar behaviour like foreign key in SQL data bases for use in TypeBuildingElements and Material json

property density

property heat_capac

property ir_emissivity

load_material_template(mat_name, data_class=None)

Material loader.

Loads Material specified in the json.

Parameters:

mat_namestr

Code list for Material

data_classDataClass()

DataClass containing the bindings for TypeBuildingElement and Material (typically this is the data class stored in prj.data, but the user can individually change that. Default is self.parent.parent.parent.parent.data which is data in project

property material_id

modify_material_template(data_class)

Material modifier.

Modify Material specified in the json.

Parameters:

data_classDataClass()

DataClass containing the bindings for TypeBuildingElement and Material (typically this is the data class stored in prj.data, but the user can individually change that. Default is self.parent.parent.parent.parent.data which is data in project

property name

property parent

save_material_template(data_class)

Material saver.

Saves Material specified in the json.

Parameters:

data_classDataClass()

DataClass containing the bindings for TypeBuildingElement and Material (typically this is the data class stored in prj.data, but the user can individually change that. Default is self.parent.parent.parent.parent.data which is data in project

property solar_absorp

property thermal_conduc

property thickness_default

property thickness_list

property transmittance

teaser.logic.buildingobjects.buildingphysics.outerwall module

class teaser.logic.buildingobjects.buildingphysics.outerwall.OuterWall(parent=None)

Bases: Wall

OuterWall class

This class holds information of an outer wall and is a child of Wall()

Parameters:

parentThermalZone()

The parent class of this object, the ThermalZone the BE belongs to. Allows for better control of hierarchical structures. If not None it adds this OuterWall to ThermalZone.outer_walls. Default is None.

Attributes:

internal_idfloat

Random id for the distinction between different elements.

namestr

Individual name

construction_datastr

Type of construction (e.g. “heavy” or “light”). Needed for distinction between different constructions types in the same building age period.

year_of_retrofitint

Year of last retrofit

year_of_constructionint

Year of first construction

building_age_grouplist

Determines the building age period that this building element belongs to [begin, end], e.g. [1984, 1994]

areafloat [m2]

Area of building element

tiltfloat [degree]

Tilt against horizontal, default is 90.0

orientationfloat [degree]

Azimuth direction of building element (0 : north, 90: east, 180: south, 270: west)

inner_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection inner side (facing the zone), default 2.7

inner_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation inner side (facing the zone), default 5.0

outer_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection outer side (facing the ambient or adjacent zone), default 20.0

outer_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation outer side (facing the ambient or adjacent zone), default 5.0

layerlist

List of all layers of a building element (to be filled with Layer objects). Use element.layer = None to delete all layers of the building element

Calculated Attributes

r1float [K/W]

equivalent resistance R1 of the analogous model given in VDI 6007

r2float [K/W]

equivalent resistance R2 of the analogous model given in VDI 6007

r3float [K/W]

equivalent resistance R3 of the analogous model given in VDI 6007

c1float [J/K]

equivalent capacity C1 of the analogous model given in VDI 6007

c2float [J/K]

equivalent capacity C2 of the analogous model given in VDI 6007

c1_korrfloat [J/K]

corrected capacity C1,korr for building elements in the case of asymmetrical thermal load given in VDI 6007

calc_u: Required area-specific U-value in retrofit cases [W/K]

ua_valuefloat [W/K]

UA-Value of building element (Area times U-Value)

r_inner_convfloat [K/W]

Convective resistance of building element on inner side (facing the zone)

r_inner_radfloat [K/W]

Radiative resistance of building element on inner side (facing the zone)

r_inner_convfloat [K/W]

Combined convective and radiative resistance of building element on inner side (facing the zone)

r_outer_convfloat [K/W]

Convective resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_radfloat [K/W]

Radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_convfloat [K/W]

Combined convective and radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

wf_outfloat

Weightfactor of building element ua_value/ua_value_zone

property parent

retrofit_wall(year_of_retrofit, material=None)

Retrofits wall to German refurbishment standards.

This function adds an additional layer of insulation and sets the thickness of the layer according to the retrofit standard in the year of refurbishment. Refurbishment year must be newer then 1977

Note: To Calculate thickness and U-Value, the standard TEASER coefficients for outer and inner heat transfer are used.

The used Standards are namely the Waermeschutzverordnung (WSVO) and Energieeinsparverordnung (EnEv)

Parameters:

materialstring

Type of material, that is used for insulation

year_of_retrofitint

Year of the retrofit of the wall/building

teaser.logic.buildingobjects.buildingphysics.rooftop module

class teaser.logic.buildingobjects.buildingphysics.rooftop.Rooftop(parent=None)

Bases: OuterWall

Rooftop class

This class holds information a roof top and is a child of OuterWall()

Parameters:

parentThermalZone()

The parent class of this object, the ThermalZone the BE belongs to. Allows for better control of hierarchical structures. If not None it adds this Rooftop to ThermalZone.rooftops. Default is None.

Attributes:

internal_idfloat

Random id for the distinction between different elements.

namestr

Individual name

construction_datastr

Type of construction (e.g. “heavy” or “light”). Needed for distinction between different constructions types in the same building age period.

year_of_retrofitint

Year of last retrofit

year_of_constructionint

Year of first construction

building_age_grouplist

Determines the building age period that this building element belongs to [begin, end], e.g. [1984, 1994]

areafloat [m2]

Area of building element

tiltfloat [degree]

Tilt against horizontal, default is 0.0

orientationfloat [degree]

Azimuth direction of building element (0 : north, 90: east, 180: south, 270: west), orientation -1.0

inner_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection inner side (facing the zone), default 1.7

inner_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation inner side (facing the zone), default 5.0

outer_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection outer side (facing the ambient or adjacent zone), default 20.0

outer_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation outer side (facing the ambient or adjacent zone), default 5.0

layerlist

List of all layers of a building element (to be filled with Layer objects). Use element.layer = None to delete all layers of the building element

Calculated Attributes

r1float [K/W]

equivalent resistance R1 of the analogous model given in VDI 6007

r2float [K/W]

equivalent resistance R2 of the analogous model given in VDI 6007

r3float [K/W]

equivalent resistance R3 of the analogous model given in VDI 6007

c1float [J/K]

equivalent capacity C1 of the analogous model given in VDI 6007

c2float [J/K]

equivalent capacity C2 of the analogous model given in VDI 6007

c1_korrfloat [J/K]

corrected capacity C1,korr for building elements in the case of asymmetrical thermal load given in VDI 6007

calc_u: Required area-specific U-value in retrofit cases [W/K]

ua_valuefloat [W/K]

UA-Value of building element (Area times U-Value)

r_inner_convfloat [K/W]

Convective resistance of building element on inner side (facing the zone)

r_inner_radfloat [K/W]

Radiative resistance of building element on inner side (facing the zone)

r_inner_convfloat [K/W]

Combined convective and radiative resistance of building element on inner side (facing the zone)

r_outer_convfloat [K/W]

Convective resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_radfloat [K/W]

Radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_convfloat [K/W]

Combined convective and radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

wf_outfloat

Weightfactor of building element ua_value/ua_value_zone

retrofit_wall(year_of_retrofit, material=None)

Retrofits wall to German refurbishment standards.

This function adds an additional layer of insulation and sets the thickness of the layer according to the retrofit standard in the year of refurbishment. Refurbishment year must be newer then 1977

Note: To Calculate thickness and U-Value, the standard TEASER coefficients for outer and inner heat transfer are used.

The used Standards are namely the Waermeschutzverordnung (WSVO) and Energieeinsparverordnung (EnEv)

Parameters:

materialstring

Type of material, that is used for insulation

year_of_retrofitint

Year of the retrofit of the wall/building

teaser.logic.buildingobjects.buildingphysics.wall module

asd

class teaser.logic.buildingobjects.buildingphysics.wall.Wall(parent=None)

Bases: BuildingElement

Wall class

This class holds functions and information for walls. It inherits for BuildingElement() and is a base class for all inner and outer walls.

Parameters:

parentThermalZone()

The parent class of this object, the ThermalZone the BE belongs to. Allows for better control of hierarchical structures. Default is None.

Attributes:

internal_idfloat

Random id for the distinction between different elements.

namestr

Individual name

construction_datastr

Type of construction (e.g. “heavy” or “light”). Needed for distinction between different constructions types in the same building age period.

year_of_retrofitint

Year of last retrofit

year_of_constructionint

Year of first construction

building_age_grouplist

Determines the building age period that this building element belongs to [begin, end], e.g. [1984, 1994]

areafloat [m2]

Area of building element

tiltfloat [degree]

Tilt against horizontal

orientationfloat [degree]

Azimuth direction of building element (0 : north, 90: east, 180: south, 270: west)

inner_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection inner side (facing the zone)

inner_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation inner side (facing the zone)

outer_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

outer_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

layerlist

List of all layers of a building element (to be filled with Layer objects). Use element.layer = None to delete all layers of the building element

Calculated Attributes

r1float [K/W]

equivalent resistance R1 of the analogous model given in VDI 6007

r2float [K/W]

equivalent resistance R2 of the analogous model given in VDI 6007

r3float [K/W]

equivalent resistance R3 of the analogous model given in VDI 6007

c1float [J/K]

equivalent capacity C1 of the analogous model given in VDI 6007

c2float [J/K]

equivalent capacity C2 of the analogous model given in VDI 6007

c1_korrfloat [J/K]

corrected capacity C1,korr for building elements in the case of asymmetrical thermal load given in VDI 6007

calc_u: Required area-specific U-value in retrofit cases [W/K]

ua_valuefloat [W/K]

UA-Value of building element (Area times U-Value)

r_inner_convfloat [K/W]

Convective resistance of building element on inner side (facing the zone)

r_inner_radfloat [K/W]

Radiative resistance of building element on inner side (facing the zone)

r_inner_convfloat [K/W]

Combined convective and radiative resistance of building element on inner side (facing the zone)

r_outer_convfloat [K/W]

Convective resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_radfloat [K/W]

Radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_convfloat [K/W]

Combined convective and radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

wf_outfloat

Weightfactor of building element ua_value/ua_value_zone

calc_equivalent_res(t_bt=7)

Equivalent resistance according to VDI 6007.

Calculates the equivalent resistance and capacity of a wall according to VDI 6007 guideline. (Analogous model).

Parameters:

t_btint

Time constant according to VDI 6007 (default t_bt = 7)

calc_ins_layer_thickness(calc_u)

Calculates the thickness of the fresh insulated layer from retrofit

initialize_retrofit(material, year_of_retrofit)

Checks the retrofit inputs and sets material and year of retrofit if needed.

insulate_wall(material=None, thickness=None)

Retrofit the walls with an additional insulation layer

Adds an additional layer on the wall, outer sight

Parameters:

materialstring

Type of material, that is used for insulation, default = EPS035

thicknessfloat

thickness of the insulation layer, default = None

retrofit_wall(year_of_retrofit, material=None)

Retrofits wall to German refurbishment standards.

This function adds an additional layer of insulation and sets the thickness of the layer according to the retrofit standard in the year of refurbishment. Refurbishment year must be newer then 1977

Note: To Calculate thickness and U-Value, the standard TEASER coefficients for outer and inner heat transfer are used.

The used Standards are namely the Waermeschutzverordnung (WSVO) and Energieeinsparverordnung (EnEv)

Parameters:

materialstring

Type of material, that is used for insulation

year_of_retrofitint

Year of the retrofit of the wall/building

set_insulation(material, calc_u, year_of_retrofit)

Sets the correct insulation thickness based on the given u-value

teaser.logic.buildingobjects.buildingphysics.window module

class teaser.logic.buildingobjects.buildingphysics.window.Window(parent=None)

Bases: BuildingElement

Window class

This class holds information of a window and is a child of BuildingElement().

Parameters:

parentThermalZone()

The parent class of this object, the ThermalZone the BE belongs to. Allows for better control of hierarchical structures. If not None it adds this Window to ThermalZone.windows. Default is None.

Attributes:

internal_idfloat

Random id for the distinction between different elements.

namestr

Individual name

construction_datastr

Type of construction (e.g. “heavy” or “light”). Needed for distinction between different constructions types in the same building age period.

year_of_retrofitint

Year of last retrofit

year_of_constructionint

Year of first construction

building_age_grouplist

Determines the building age period that this building element belongs to [begin, end], e.g. [1984, 1994]

areafloat [m2]

Area of building element

tiltfloat [degree]

Tilt against horizontal, default 90.0

orientationfloat [degree]

Azimuth direction of building element (0 : north, 90: east, 180: south, 270: west)

inner_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection inner side (facing the zone), default 2.7

inner_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation inner side (facing the zone), default 5.0

outer_convectionfloat [W/(m2*K)]

Constant heat transfer coefficient of convection outer side (facing the ambient or adjacent zone), default 20.0

outer_radiationfloat [W/(m2*K)]

Constant heat transfer coefficient of radiation outer side (facing the ambient or adjacent zone), default 5.0

layerlist

List of all layers of a building element (to be filled with Layer objects). Use element.layer = None to delete all layers of the building element

Specific Attributes for Window

g_valuefloat

solar heat gain coefficient of Window

a_convfloat

relative convective heat emission because of absorption of short wave irradiation of inner side of Window according to VDI 6007

shading_g_totalfloat

shaded g value of the window

shading_max_irrfloat

threshold for automatic shading

Calculated Attributes

r1float [K/W]

equivalent resistance R1 of the analogous model given in VDI 6007

r2float [K/W]

equivalent resistance R2 of the analogous model given in VDI 6007

r3float [K/W]

equivalent resistance R3 of the analogous model given in VDI 6007

c1float [J/K]

equivalent capacity C1 of the analogous model given in VDI 6007

c2float [J/K]

equivalent capacity C2 of the analogous model given in VDI 6007

c1_korrfloat [J/K]

corrected capacity C1,korr for building elements in the case of asymmetrical thermal load given in VDI 6007

ua_valuefloat [W/K]

UA-Value of building element (Area times U-Value)

r_inner_convfloat [K/W]

Convective resistance of building element on inner side (facing the zone)

r_inner_radfloat [K/W]

Radiative resistance of building element on inner side (facing the zone)

r_inner_convfloat [K/W]

Combined convective and radiative resistance of building element on inner side (facing the zone)

r_outer_convfloat [K/W]

Convective resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_radfloat [K/W]

Radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

r_outer_convfloat [K/W]

Combined convective and radiative resistance of building element on outer side (facing the ambient or adjacent zone). Currently for all InnerWalls and GroundFloors this value is set to 0.0

wf_outfloat

Weightfactor of building element ua_value/ua_value_zone

property a_conv

calc_equivalent_res()

Equivalent resistance VDI 6007

Calculates the equivalent resistance of a wall according to VDI 6007 guideline.

Parameters:

t_btint

time constant according to VDI 6007 (default t_bt = 7)

property g_value

property parent

replace_window(year_of_retrofit, window_type=None)

Replace a window, with a newer one.

Replaces all attributes from the window and replaces it with a high insulated one.

Parameters:

year_of_retrofit: int

The year, the building was refurbished

property shading_g_total

property shading_max_irr