teaser.logic.buildingobjects.calculation package

Submodules

teaser.logic.buildingobjects.calculation.aixlib module

This module includes AixLib calculation class.

class teaser.logic.buildingobjects.calculation.aixlib.AixLib(parent)

Bases: object

Class to calculate parameters for AixLib output.

This class holds functions to sort and partly rewrite zone and building attributes specific for AixLib MultizoneEquipped simulation. This includes the export of boundary conditions and AHU operation values.

Parameters

parent: Building()

The parent class of this object, the Building the attributes are calculated for. (default: None)

Attributes

file_set_tstr

Filename for set temperature file

file_ahustr

Filename for AHU boundary conditions file

file_internal_gainsstr

Filename for internal gains file

versionstr

Used AixLib version, default should always be current master version of GitHub

total_surface_areafloat [m2]

This is the total surface area of the building for interior and exterior surfaces. That includes: OuterWalls, Rooftops, GroundFloors, Windows for exterior surfaces, and InnerWalls, Ceilings, Floors for interior walls.

consider_heat_capacitybool

decides whether air capacity is considered or not for all thermal zones in the building. Default is True, you need to export your model again if changing this value

use_set_backbool

True if night set back should be used. In this case the function considers heating_time and temp_set_back defined in use_conditions of zone. Default is True, you need to export your model again if changing this value

use_set_point_temperature_profile_heatingbool

Standard is False. True if the set_point temperature profile heating should be used for the export. Then, the night set back and everything except the set point profile will be ignored.

calc_auxiliary_attr()

Call function to calculate all auxiliary attributes for AixLib.

modelica_AHU_boundary(path=None)

Create .txt file for AHU boundary conditions (building).

This function creates a txt for building AHU boundary conditions

1. Column : time step

2. Column : desired AHU profile temperature

3. Column : Desired minimal relative humidity

4. Column : desired maximal relative humidity

5. Column : AHU status (On/Off)

Parameters

pathstr

optional path, when matfile is exported separately

Attributes

temperature_profile[float]

timeline of temperatures requirements for AHU simulation

min_relative_humidity_profile[float]

timeline of relative humidity requirements for AHU simulation

max_relative_humidity_profile[float]

timeline of relative humidity requirements for AHU simulation

v_flow_profile[int]

timeline of desired relative v_flow of the AHU simulation (0..1)

modelica_gains_boundary(path=None)

Create .txt file for internal gains boundary conditions.

This function creates a matfile (-v4) for building internal gains boundary conditions. It collects all internal gain profiles of the zones and stores them into one file. The file is extended for each zone. Only applicable if zones are defined

1. Column : time step 2,5,8,… Column : profile_persons 3,6,9,… Column : profile_machines 4,7,10,… Column : profile_lighting

Parameters

pathstr

optional path, when matfile is exported separately

Notes

When time line is created, we need to add a 0 to first element of all boundaries. This is due to to expected format in Modelica.

modelica_set_temp(path=None)

Create .txt file for set temperatures for heating.

This function creates a txt for set temperatures of each zone, that are all saved into one matrix.

Parameters

pathstr

optional path, when matfile is exported separately

modelica_set_temp_cool(path=None)

Create .txt file for set temperatures cooling.

This function creates a txt for set temperatures for cooling of each zone, that are all saved into one matrix.

Parameters

pathstr

optional path, when matfile is exported separately

teaser.logic.buildingobjects.calculation.four_element module

class teaser.logic.buildingobjects.calculation.four_element.FourElement(thermal_zone, merge_windows, t_bt)

Bases: object

This class contains attributes and functions for four element model

This model adds another element for the roof. Roofs commonly exhibit the same excitations as exterior walls but have different coefficients of heat transfer due to their orientation. Thus the model distinguishes between internal thermal masses and exterior walls divided into outerwalls (vertical), rooftops and ground plates. While all exterior walls contribute to heat transfer to the ambient, adiabatic conditions apply to interior walls. This approach allows considering the dynamic behaviour induced by internal heat storage. This class calculates and holds all attributes given in documentation.

It treats OuterWalls, Rooftops and GroundFloors separate resulting in three RC-combination for these. Depending on the chosen method it will consider an extra resistance for windows or merge all windows into the RC-Combination for outer walls.

Parameters

thermal_zone: ThermalZone()

TEASER instance of ThermalZone

merge_windowsboolean

True for merging windows into the outer wall’s RC-combination, False for separate resistance for window, default is False. (Only supported for IBPSA)

t_btfloat [d]

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

Attributes

Interior Walls

area_iwfloat [m2]

Area of all interior walls.

alpha_conv_inner_iwfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of interior walls facing the inside of this thermal zone.

alpha_rad_inner_iwfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of interior walls facing the inside of this thermal zone.

alpha_comb_inner_iwfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of interior walls facing the inside of this thermal zone.

alpha_conv_outer_iwfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of interior walls facing the adjacent thermal zone. (Currently not supported)

alpha_rad_outer_iwfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of interior walls facing the adjacent thermal zone. (Currently not supported)

alpha_comb_outer_iwfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of interior walls facing the adjacent thermal zone. (Currently not supported)

ua_value_iwfloat [W/K]

U-Value times interior wall area. (Does not take adjacent thermal zones into account)

r_conv_inner_iwfloat [K/W]

Sum of convective resistances for all interior walls facing the inside of this thermal zone.

r_rad_inner_iwfloat [K/W]

Sum of radiative resistances for all interior walls facing the inside of this thermal zone

r_comb_inner_iwfloat [K/W]

Sum of combined resistances for all interior walls facing the inside of this thermal zone

r1_iwfloat [K/W]

Lumped resistance of interior walls no heat transfer coefficients for convection and radiation are accounted in this resistance.

c1_iwfloat [J/K]

Lumped capacity of interior walls

Outer Walls

area_owfloat [m2]

Area of all outer walls .

alpha_conv_inner_owfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of outer walls facing the inside of this thermal zone .

alpha_rad_inner_owfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of outer walls facing the inside of this thermal zone .

alpha_comb_inner_owfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of outer walls facing the inside of this thermal zone .

alpha_conv_outer_owfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of outer walls facing the ambient.

alpha_rad_outer_owfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of outer walls facing the ambient .

alpha_comb_outer_owfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of outer walls facing the ambient.

ua_value_owfloat [W/K]

U-Value times outer wall area.

r_conv_inner_owfloat [K/W]

Sum of convective resistances for all outer walls facing the inside of this thermal zone .

r_rad_inner_owfloat [K/W]

Sum of radiative resistances for all outer walls facing the inside of this thermal zone .

r_comb_inner_owfloat [K/W]

Sum of combined resistances for all outer walls facing the inside of this thermal zone.

r_conv_outer_owfloat [K/W]

Sum of convective resistances for all outer walls facing the ambient.

r_rad_outer_owfloat [K/W]

Sum of radiative resistances for all outer walls facing the ambient.

r_comb_outer_owfloat [K/W]

Sum of combined resistances for all outer walls facing the ambient.

r1_owfloat [K/W]

Lumped resistance of outer walls no heat transfer coefficients for convection and radiation are accounted in this resistance.

r_rest_owfloat [K/W]

Lumped remaining resistance of outer walls between r1_ow and c1_ow no heat transfer coefficients for convection and radiation are accounted in this resistance.

c1_owfloat [J/K]

Lumped capacity of outer walls .

weightfactor_owlist of floats

Weightfactors of outer walls (UA-Value of walls with same orientation and tilt divided by ua_value_ow)

outer_wall_areaslist of floats [m2]

Area of all outer walls in one list.

ir_emissivity_outer_owfloat

Area-weighted ir emissivity of outer wall facing the ambient.

ir_emissivity_inner_owfloat

Area-weighted ir emissivity of outer walls facing the thermal zone.

solar_absorp_owfloat

Area-weighted solar absorption of outer walls facing the ambient.

Ground Floors

area_gffloat [m2]

Area of all ground floors.

alpha_conv_inner_gffloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of ground floors facing the inside of this thermal zone.

alpha_rad_inner_gffloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of ground floors facing the inside of this thermal zone.

alpha_comb_inner_gffloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of ground floors facing the inside of this thermal zone.

ua_value_gffloat [W/K]

U-Value times ground floor area.

r_conv_inner_gffloat [K/W]

Sum of convective resistances for all ground floors facing the inside of this thermal zone.

r_rad_inner_gffloat [K/W]

Sum of radiative resistances for all ground floors facing the inside of this thermal zone.

r_comb_inner_gffloat [K/W]

Sum of combined resistances for all ground floors facing the inside of this thermal zone.

r1_gffloat [K/W]

Lumped resistance of ground floors no heat transfer coefficients for convection and radiation are accounted in this resistance.

r_rest_gffloat [K/W]

Lumped remaining resistance of ground floors between r1_gf and c1_gf no heat transfer coefficients for convection and radiation are accounted in this resistance.

c1_gffloat [J/K]

Lumped capacity of ground floors.

weightfactor_gffloat

Weightfactor of ground floors (UA-Value of walls with same orientation and tilt divided by ua_value_gf)

ground_floor_areafloat [m2]

Area of all ground floors.

r_rad_gf_iwfloat [K/W]

Resistance for radiative heat transfer between walls. TODO: needs to be checked

ir_emissivity_inner_gffloat

Area-weighted ir emissivity of ground floors facing the thermal zone.

Rooftops

area_rtfloat [m2]

Area of all rooftops .

alpha_conv_inner_rtfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of rooftops facing the inside of this thermal zone .

alpha_rad_inner_rtfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of rooftops facing the inside of this thermal zone .

alpha_comb_inner_rtfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of rooftops facing the inside of this thermal zone .

alpha_conv_outer_rtfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of rooftops facing the ambient.

alpha_rad_outer_rtfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of rooftops facing the ambient .

alpha_comb_outer_rtfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of rooftops facing the ambient.

ua_value_rtfloat [W/K]

U-Value times outer wall area.

r_conv_inner_rtfloat [K/W]

Sum of convective resistances for all rooftops facing the inside of this thermal zone .

r_rad_inner_rtfloat [K/W]

Sum of radiative resistances for all rooftops facing the inside of this thermal zone .

r_comb_inner_rtfloat [K/W]

Sum of combined resistances for all rooftops facing the inside of this thermal zone.

r_conv_outer_rtfloat [K/W]

Sum of convective resistances for all rooftops facing the ambient.

r_rad_outer_rtfloat [K/W]

Sum of radiative resistances for all rooftops facing the ambient.

r_comb_outer_rtfloat [K/W]

Sum of combined resistances for all rooftops facing the ambient.

r1_rtfloat [K/W]

Lumped resistance of rooftops no heat transfer coefficients for convection and radiation are accounted in this resistance.

r_rest_rtfloat [K/W]

Lumped remaining resistance of rooftops between r1_rt and c1_rt no heat transfer coefficients for convection and radiation are accounted in this resistance.

c1_rtfloat [J/K]

Lumped capacity of rooftops .

weightfactor_rtlist of floats

Weightfactors of rooftops (UA-Value of walls with same orientation and tilt divided by ua_value_rt)

weightfactor_win_rtlist of floats

Weightfactors of windows in rooftop. CAUTION: this will be always a list full of zeors, as windows are always calculated separatly.

outer_wall_areaslist of floats [m2]

Area of all rooftops in one list.

r_rad_rt_iwfloat [K/W]

Resistance for radiative heat transfer between walls. TODO: needs to be checked

ir_emissivity_outer_rtfloat

Area-weighted ir emissivity of outer wall facing the ambient.

ir_emissivity_inner_rtfloat

Area-weighted ir emissivity of rooftops facing the thermal zone.

solar_absorp_rtfloat

Area-weighted solar absorption of rooftops facing the ambient.

tilt_rtlist of floats [degree]

Tilt of rooftops against the horizontal.

orientation_rtlist of floats [degree]

Orientation of rooftops (Azimuth). 0 - North 90 - East 180 - South 270 - West

Windows

area_winfloat [m2]

Area of all windows.

alpha_conv_inner_winfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of windows facing the inside of this thermal zone.

alpha_rad_inner_winfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of windows facing the inside of this thermal zone.

alpha_comb_inner_winfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of windows facing the inside of this thermal zone.

ratio_conv_rad_inner_winfloat [-]

Ratio for windows between convective and radiative heat emission, given in VDI 6007-3

alpha_conv_outer_winfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of windows facing the ambient.

alpha_rad_outer_winfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of windows facing the ambient.

alpha_comb_outer_winfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of windows facing the ambient.

ua_value_winfloat [W/K]

U-Value times outer wall area.

u_value_winfloat [W/(m2K)]

Area weighted U-Value of windows.

r_conv_inner_winfloat [K/W]

Sum of convective resistances for all windows facing the inside of this thermal zone.

r_rad_inner_winfloat [K/W]

Sum of radiative resistances for all windows facing the inside of this thermal zone.

r_comb_inner_winfloat [K/W]

Sum of combined resistances for all windows facing the inside of this thermal zone.

r_conv_outer_winfloat [K/W]

Sum of convective resistances for all windows facing the ambient.

r_rad_outer_winfloat [K/W]

Sum of radiative resistances for all windows facing the ambient.

r_comb_outer_winfloat [K/W]

Sum of combined resistances for all windows facing the ambient.

r1_winfloat [K/W]

Lumped resistance of windows, no heat transfer coefficients for convection and radiation are accounted in this resistance.

weightfactor_winlist of floats

Weightfactors of windows (UA-Value of windows with same orientation and tilt divided by ua_value_win or ua_value_win+ua_value_ow, depending if windows is lumped/merged into the walls or not)

window_areaslist of floats [m2]

Area of all windows in one list, if the windows are merged into the outer wall this list will be full of zeros

transparent_areaslist of floats [m2]

Area of all transparent elements (most likely windows) in one list, this list will be always filled with the areas, independent if windows are merged into walls or not.

solar_absorp_winfloat

Area-weighted solar absorption for windows. (typically 0.0)

ir_emissivity_winfloat

Area-weighted ir_emissivity for windows. Can be used for windows facing the thermal zone and the ambient.

weighted_g_valuefloat

Area-weighted g-Value of all windows.

shading_max_irrlist of float [W/m2]

Threshold value above which the sunblind becomes active for the whole zone. Threshold regards to the incoming irradiation level with the window direction. This value does not account for heat flux due to the outside temperature.

shading_g_totallist of float

Factor representing how much of the actual solar irradiation goes through the sunblind and enters the window element, for the case, that the sunblind is activated. Defaults to 1, i.e. no shading is active.

Misc values:

alpha_rad_inner_meanfloat [W/(m2K)]

Area-weighted radiative coefficient of all surfaces facing the inside of this thermal zone (OuterWalls, Windows, InnerWalls, …).

alpha_rad_outer_meanfloat [W/(m2K)]

Area-weighted radiative coefficient of all surfaces facing the ambient (OuterWalls, Windows, …).

heat_load[W]

Static heat load of the thermal zone.

facade_areaslist of floats [m2]

List containing the area of each facade (with same tilt and orientation) this includes also roofs and ground floors and windows.

n_outerint

Number of total facades with different combination of tilt and orientation, windows and outer walls

n_rtint

Number of total facades with different combination of tilt and orientation, Rooftops

tilt_facadelist of floats [degree]

Tilt of facades against the horizontal.

orientation_facadelist of floats [degree]

Orientation of facades (Azimuth). 0 - North 90 - East 180 - South 270 - West

calc_attributes()

Calls all necessary function to calculate model attributes

set_calc_default()

sets default calculation parameters

teaser.logic.buildingobjects.calculation.ibpsa module

This module includes IBPSA calculation class.

class teaser.logic.buildingobjects.calculation.ibpsa.IBPSA(parent)

Bases: object

Class to calculate parameters for AixLib output.

This class holds functions to sort and partly rewrite zone and building attributes specific for IBPSA simulation. This includes the export of boundary conditions.

Parameters

parent: Building()

The parent class of this object, the Building the attributes are calculated for. (default: None)

Attributes

file_internal_gainsstr

Filename for internal gains file

versiondict

Dictionary with supported libraries and their version numbers

consider_heat_capacitybool

decides whether air capacity is considered or not for all thermal zones in the building

modelica_gains_boundary(zone, path=None)

creates .mat file for internal gains boundary conditions

This function creates a matfile (-v4) for building internal gains boundary conditions. It collects internal gain profiles of a specific zones and stores them into one file. It also calculates the internal gains from relative presence and values for heat output into W for direct usage in Annex models.

Only person (convective and radiative) and machines (convective) are used in the simple Annex 60 examples.

1. Column : time step 2 Column : profile_persons, radiative 3 Column : profile_persons, convective 4 Column : profile_machines, convective

Parameters

zoneThermalZone()

TEASER instance of ThermalZone. As IBPSA computes single models for single zones, we need to generate individual files for zones and internal gains

pathstr

optional path, when matfile is exported separately

Notes

When time line is created, we need to add a 0 to first element of all boundaries. This is due to to expected format in Modelica.

teaser.logic.buildingobjects.calculation.one_element module

class teaser.logic.buildingobjects.calculation.one_element.OneElement(thermal_zone, merge_windows, t_bt)

Bases: object

This class contains attributes and functions for one element model

his model merges all thermal masses into one element, parameterized by the length of the RC-chain nExt, the vector of the capacities CExt[nExt] that is connected via the vector of resistances RExt[nExt] and RExtRem to the ambient and indoor air. By default, the model neglects all internal thermal masses that are not directly connected to the ambient.

It treats Rooftops, GroundFloors and OuterWalls as one type of outer walls and computes one RC-combination for these types.

Depending on the chosen method it will consider an extra resistance for windows or merge all windows into the RC-Combination for outer walls.

Parameters

thermal_zone: ThermalZone()

TEASER instance of ThermalZone

merge_windowsboolean

True for merging the windows into the outer wall’s RC-combination, False for separate resistance for window, default is False. (Only supported for IBPSA)

t_btfloat [d]

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

Attributes

Outer Walls (OuterWall, Rooftop, GroundFloor)

area_owfloat [m2]

Area of all outer walls.

n_outerint

Number of total outer walls with different combination of tilt and orientation, including Rooftops and GroundFloors

alpha_conv_inner_owfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of outer walls facing the inside of this thermal zone.

alpha_rad_inner_owfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of outer walls facing the inside of this thermal zone.

alpha_comb_inner_owfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of outer walls facing the inside of this thermal zone.

alpha_conv_outer_owfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of outer walls facing the ambient.

alpha_rad_outer_owfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of outer walls facing the ambient.

alpha_comb_outer_owfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of outer walls facing the ambient.

ua_value_owfloat [W/K]

U-Value times outer wall area.

r_conv_inner_owfloat [K/W]

Sum of convective resistances for all outer walls facing the inside of this thermal zone.

r_rad_inner_owfloat [K/W]

Sum of radiative resistances for all outer walls facing the inside of this thermal zone.

r_comb_inner_owfloat [K/W]

Sum of combined resistances for all outer walls facing the inside of this thermal zone.

r_conv_outer_owfloat [K/W]

Sum of convective resistances for all outer walls facing the ambient.

r_rad_outer_owfloat [K/W]

Sum of radiative resistances for all outer walls facing the ambient.

r_comb_outer_owfloat [K/W]

Sum of combined resistances for all outer walls facing the ambient.

r1_owfloat [K/W]

Lumped resistance of outer walls no heat transfer coefficients for convection and radiation are accounted in this resistance.

r_rest_owfloat [K/W]

Lumped remaining resistance of outer walls between r1_ow and c1_ow no heat transfer coefficients for convection and radiation are accounted in this resistance.

c1_owfloat [J/K]

Lumped capacity of outer walls.

weightfactor_owlist of floats

Weightfactors of outer walls (UA-Value of walls with same orientation and tilt divided by ua_value_ow)

weightfactor_groundlist of floats

Weightfactors of groundfloors (UA-Value of groundfloor divided by ua_value_ow).

tilt_facadelist of floats [degree]

Tilt of outer walls against the horizontal.

orientation_facadelist of floats [degree]

Orientation of outer walls (Azimuth). 0 - North 90 - East 180 - South 270 - West

outer_wall_areaslist of floats [m2]

Area of all outer walls in one list.

r_rad_ow_iwfloat [K/W]

Resistance for radiative heat transfer between walls. TODO: needs to be checked

ir_emissivity_outer_owfloat

Area-weighted ir emissivity of outer wall facing the ambient.

ir_emissivity_inner_owfloat

Area-weighted ir emissivity of outer walls facing the thermal zone.

solar_absorp_owfloat

Area-weighted solar absorption of outer walls facing the ambient.

Windows

area_winfloat [m2]

Area of all windows.

alpha_conv_inner_winfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of windows facing the inside of this thermal zone.

alpha_rad_inner_winfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of windows facing the inside of this thermal zone.

alpha_comb_inner_winfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of windows facing the inside of this thermal zone.

ratio_conv_rad_inner_winfloat [-]

Ratio for windows between convective and radiative heat emission, given in VDI 6007-3

alpha_conv_outer_winfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of windows facing the ambient.

alpha_rad_outer_winfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of windows facing the ambient.

alpha_comb_outer_winfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of windows facing the ambient.

ua_value_winfloat [W/K]

U-Value times window wall area.

u_value_winfloat [W/(m2K)]

Area weighted U-Value of windows.

r_conv_inner_winfloat [K/W]

Sum of convective resistances for all windows facing the inside of this thermal zone.

r_rad_inner_winfloat [K/W]

Sum of radiative resistances for all windows facing the inside of this thermal zone.

r_comb_inner_winfloat [K/W]

Sum of combined resistances for all windows facing the inside of this thermal zone.

r_conv_outer_winfloat [K/W]

Sum of convective resistances for all windows facing the ambient.

r_rad_outer_winfloat [K/W]

Sum of radiative resistances for all windows facing the ambient.

r_comb_outer_winfloat [K/W]

Sum of combined resistances for all windows facing the ambient.

r1_winfloat [K/W]

Lumped resistance of windows, no heat transfer coefficients for convection and radiation are accounted in this resistance.

weightfactor_winlist of floats

Weightfactors of windows (UA-Value of windows with same orientation and tilt divided by ua_value_win or ua_value_win+ua_value_ow, depending if windows is lumped/merged into the walls or not)

window_areaslist of floats [m2]

Area of all windows in one list, if the windows are merged into the outer wall this list will be full of zeros

transparent_areaslist of floats [m2]

Area of all transparent elements (most likely windows) in one list, this list will be always filled with the areas, independent if windows are merged into walls or not.

solar_absorp_winfloat

Area-weighted solar absorption for windows. (typically 0.0)

ir_emissivity_winfloat

Area-weighted ir_emissivity for windows. Can be used for windows facing the thermal zone and the ambient.

weighted_g_valuefloat

Area-weighted g-Value of all windows.

shading_max_irrlist of float [W/m2]

Threshold value above which the sunblind becomes active for the whole zone. Threshold regards to the incoming irradiation level with the window direction. This value does not account for heat flux due to the outside temperature.

shading_g_totallist of float

Factor representing how much of the actual solar irradiation goes through the sunblind and enters the window element, for the case, that the sunblind is activated. Defaults to 1, i.e. no shading is active.

Misc values:

alpha_rad_inner_meanfloat [W/(m2K)]

Area-weighted radiative coefficient of all surfaces facing the inside of this thermal zone (OuterWalls, Windows, InnerWalls, …).

alpha_rad_outer_meanfloat [W/(m2K)]

Area-weighted radiative coefficient of all surfaces facing the ambient (OuterWalls, Windows, …).

heat_load[W]

Static heat load of the thermal zone.

facade_areaslist of floats [m2]

List containing the area of each facade (with same tilt and orientation) this includes also roofs and ground floors and windows.

n_outerint

Number of total facades with different combination of tilt and orientation, including Rooftops and GroundFloors

tilt_facadelist of floats [degree]

Tilt of facades against the horizontal.

orientation_facadelist of floats [degree]

Orientation of facades (Azimuth). 0 - North 90 - East 180 - South 270 - West

calc_attributes()

Calls all necessary function to calculate model attributes

set_calc_default()

sets default calculation parameters

teaser.logic.buildingobjects.calculation.three_element module

class teaser.logic.buildingobjects.calculation.three_element.ThreeElement(thermal_zone, merge_windows, t_bt)

Bases: object

This class contains attributes and functions for three element model

This model adds one further element for the floor plate. Long-term effects dominate the excitation of the floor plate and thus the excitation differs from excitation of outer walls. Thus the model distinguishes between internal thermal masses and exterior walls divided into those who are exposed to the sun and ground plates. While exterior walls contribute to heat transfer to the ambient, adiabatic conditions apply to interior walls. This approach allows considering the dynamic behaviour induced by internal heat storage. This class calculates and holds all attributes given in documentation.

It treats Rooftops and OuterWalls as one type of outer walls and distinguishes GroundFloors as a separately resulting in two RC-combination for these types.

Depending on the chosen method it will consider an extra resistance for windows or merge all windows into the RC-Combination for outer walls.

Parameters

thermal_zone: ThermalZone()

TEASER instance of ThermalZone

merge_windowsboolean

True for merging windows into the outer wall’s RC-combination, False for separate resistance for window, default is False. (Only supported for IBPSA)

t_btfloat [d]

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

Attributes

Interior Walls

area_iwfloat [m2]

Area of all interior walls.

alpha_conv_inner_iwfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of interior walls facing the inside of this thermal zone.

alpha_rad_inner_iwfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of interior walls facing the inside of this thermal zone.

alpha_comb_inner_iwfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of interior walls facing the inside of this thermal zone.

alpha_conv_outer_iwfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of interior walls facing the adjacent thermal zone. (Currently not supported)

alpha_rad_outer_iwfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of interior walls facing the adjacent thermal zone. (Currently not supported)

alpha_comb_outer_iwfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of interior walls facing the adjacent thermal zone. (Currently not supported)

ua_value_iwfloat [W/K]

U-Value times interior wall area. (Does not take adjacent thermal zones into account)

r_conv_inner_iwfloat [K/W]

Sum of convective resistances for all interior walls facing the inside of this thermal zone.

r_rad_inner_iwfloat [K/W]

Sum of radiative resistances for all interior walls facing the inside of this thermal zone

r_comb_inner_iwfloat [K/W]

Sum of combined resistances for all interior walls facing the inside of this thermal zone

r1_iwfloat [K/W]

Lumped resistance of interior walls no heat transfer coefficients for convection and radiation are accounted in this resistance.

c1_iwfloat [J/K]

Lumped capacity of interior walls

Outer Walls (OuterWall, Rooftop)

area_owfloat [m2]

Area of all outer walls (OuterWall, Rooftop).

alpha_conv_inner_owfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of outer walls facing the inside of this thermal zone (OuterWall, Rooftop).

alpha_rad_inner_owfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of outer walls facing the inside of this thermal zone (OuterWall, Rooftop).

alpha_comb_inner_owfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of outer walls facing the inside of this thermal zone (OuterWall, Rooftop).

alpha_conv_outer_owfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of outer walls facing the ambient (OuterWall, Rooftop).

alpha_rad_outer_owfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of outer walls facing the ambient (OuterWall, Rooftop).

alpha_comb_outer_owfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of outer walls facing the ambient (OuterWall, Rooftop).

ua_value_owfloat [W/K]

U-Value times outer wall area (OuterWall, Rooftop).

r_conv_inner_owfloat [K/W]

Sum of convective resistances for all outer walls facing the inside of this thermal zone (OuterWall, Rooftop).

r_rad_inner_owfloat [K/W]

Sum of radiative resistances for all outer walls facing the inside of this thermal zone (OuterWall, Rooftop).

r_comb_inner_owfloat [K/W]

Sum of combined resistances for all outer walls facing the inside of this thermal zone (OuterWall, Rooftop).

r_conv_outer_owfloat [K/W]

Sum of convective resistances for all outer walls facing the ambient (OuterWall, Rooftop).

r_rad_outer_owfloat [K/W]

Sum of radiative resistances for all outer walls facing the ambient (OuterWall, Rooftop).

r_comb_outer_owfloat [K/W]

Sum of combined resistances for all outer walls facing the ambient (OuterWall, Rooftop).

r1_owfloat [K/W]

Lumped resistance of outer walls no heat transfer coefficients for convection and radiation are accounted in this resistance (OuterWall, Rooftop).

r_rest_owfloat [K/W]

Lumped remaining resistance of outer walls between r1_ow and c1_ow no heat transfer coefficients for convection and radiation are accounted in this resistance (OuterWall, Rooftop).

c1_owfloat [J/K]

Lumped capacity of outer walls (OuterWall, Rooftop).

weightfactor_owlist of floats

Weightfactors of outer walls (UA-Value of walls with same orientation and tilt divided by ua_value_ow) (OuterWall, Rooftop)

outer_wall_areaslist of floats [m2]

Area of all outer walls in one list (OuterWall, Rooftop).

ir_emissivity_outer_owfloat

Area-weighted ir emissivity of outer wall facing the ambient (OuterWall, Rooftop).

ir_emissivity_inner_owfloat

Area-weighted ir emissivity of outer walls facing the thermal zone (OuterWall, Rooftop).

solar_absorp_owfloat

Area-weighted solar absorption of outer walls facing the ambient (OuterWall, Rooftop).

Ground Floors

area_gffloat [m2]

Area of all ground floors.

alpha_conv_inner_gffloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of ground floors facing the inside of this thermal zone.

alpha_rad_inner_gffloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of ground floors facing the inside of this thermal zone.

alpha_comb_inner_gffloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of ground floors facing the inside of this thermal zone.

ua_value_gffloat [W/K]

U-Value times ground floor area.

r_conv_inner_gffloat [K/W]

Sum of convective resistances for all ground floors facing the inside of this thermal zone.

r_rad_inner_gffloat [K/W]

Sum of radiative resistances for all ground floors facing the inside of this thermal zone.

r_comb_inner_gffloat [K/W]

Sum of combined resistances for all ground floors facing the inside of this thermal zone.

r1_gffloat [K/W]

Lumped resistance of ground floors no heat transfer coefficients for convection and radiation are accounted in this resistance.

r_rest_gffloat [K/W]

Lumped remaining resistance of ground floors between r1_gf and c1_gf no heat transfer coefficients for convection and radiation are accounted in this resistance.

c1_gffloat [J/K]

Lumped capacity of ground floors.

weightfactor_gffloat

Weightfactor of ground floors (UA-Value of walls with same orientation and tilt divided by ua_value_gf)

ground_floor_areafloat [m2]

Area of all ground floors.

r_rad_gf_iwfloat [K/W]

Resistance for radiative heat transfer between walls. TODO: needs to be checked

ir_emissivity_inner_gffloat

Area-weighted ir emissivity of ground floors facing the thermal zone.

Windows

area_winfloat [m2]

Area of all windows.

alpha_conv_inner_winfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of windows facing the inside of this thermal zone.

alpha_rad_inner_winfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of windows facing the inside of this thermal zone.

alpha_comb_inner_winfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of windows facing the inside of this thermal zone.

ratio_conv_rad_inner_winfloat [-]

Ratio for windows between convective and radiative heat emission, given in VDI 6007-3

alpha_conv_outer_winfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of windows facing the ambient.

alpha_rad_outer_winfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of windows facing the ambient.

alpha_comb_outer_winfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of windows facing the ambient.

ua_value_winfloat [W/K]

U-Value times outer wall area.

u_value_winfloat [W/(m2K)]

Area weighted U-Value of windows.

r_conv_inner_winfloat [K/W]

Sum of convective resistances for all windows facing the inside of this thermal zone.

r_rad_inner_winfloat [K/W]

Sum of radiative resistances for all windows facing the inside of this thermal zone.

r_comb_inner_winfloat [K/W]

Sum of combined resistances for all windows facing the inside of this thermal zone.

r_conv_outer_winfloat [K/W]

Sum of convective resistances for all windows facing the ambient.

r_rad_outer_winfloat [K/W]

Sum of radiative resistances for all windows facing the ambient.

r_comb_outer_winfloat [K/W]

Sum of combined resistances for all windows facing the ambient.

r1_winfloat [K/W]

Lumped resistance of windows, no heat transfer coefficients for convection and radiation are accounted in this resistance.

weightfactor_winlist of floats

Weightfactors of windows (UA-Value of windows with same orientation and tilt divided by ua_value_win or ua_value_win+ua_value_ow, depending if windows is lumped/merged into the walls or not)

window_areaslist of floats [m2]

Area of all windows in one list, if the windows are merged into the outer wall this list will be full of zeros

transparent_areaslist of floats [m2]

Area of all transparent elements (most likely windows) in one list, this list will be always filled with the areas, independent if windows are merged into walls or not.

solar_absorp_winfloat

Area-weighted solar absorption for windows. (typically 0.0)

ir_emissivity_winfloat

Area-weighted ir_emissivity for windows. Can be used for windows facing the thermal zone and the ambient.

weighted_g_valuefloat

Area-weighted g-Value of all windows.

shading_max_irrlist of float [W/m2]

Threshold value above which the sunblind becomes active for the whole zone. Threshold regards to the incoming irradiation level with the window direction. This value does not account for heat flux due to the outside temperature.

shading_g_totallist of float

Factor representing how much of the actual solar irradiation goes through the sunblind and enters the window element, for the case, that the sunblind is activated. Defaults to 1, i.e. no shading is active.

Misc values:

alpha_rad_inner_meanfloat [W/(m2K)]

Area-weighted radiative coefficient of all surfaces facing the inside of this thermal zone (OuterWalls, Windows, InnerWalls, …).

alpha_rad_outer_meanfloat [W/(m2K)]

Area-weighted radiative coefficient of all surfaces facing the ambient (OuterWalls, Windows, …).

heat_load[W]

Static heat load of the thermal zone.

facade_areaslist of floats [m2]

List containing the area of each facade (with same tilt and orientation) this includes also roofs and ground floors and windows.

n_outerint

Number of total facades with different combination of tilt and orientation, windows and outer walls rooftops

tilt_facadelist of floats [degree]

Tilt of facades against the horizontal.

orientation_facadelist of floats [degree]

Orientation of facades (Azimuth). 0 - North 90 - East 180 - South 270 - West

calc_attributes()

Calls all necessary function to calculate model attributes

set_calc_default()

sets default calculation parameters

teaser.logic.buildingobjects.calculation.two_element module

class teaser.logic.buildingobjects.calculation.two_element.TwoElement(thermal_zone, merge_windows, t_bt)

Bases: object

This class contains attributes and functions for two element model

This model distinguishes between internal thermal masses and exterior walls. While exterior walls contribute to heat transfer to the ambient, adiabatic conditions apply to interior walls. This approach allows considering the dynamic behaviour induced by internal heat storage. This class calculates and holds all attributes given in documentation.

It treats Rooftops, GroundFloors and OuterWalls as one type of outer walls and computes one RC-combination for these types.

Depending on the chosen method it will consider an extra resistance for windows or merge all windows into the RC-Combination for outer walls.

Parameters

thermal_zone: ThermalZone()

TEASER instance of ThermalZone

merge_windowsboolean

True for merging the windows into the outer wall’s RC-combination, False for separate resistance for window, default is False. (Only supported for IBPSA)

t_btfloat [d]

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

Attributes

Interior Walls

area_iwfloat [m2]

Area of all interior walls.

alpha_conv_inner_iwfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of interior walls facing the inside of this thermal zone.

alpha_rad_inner_iwfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of interior walls facing the inside of this thermal zone.

alpha_comb_inner_iwfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of interior walls facing the inside of this thermal zone.

alpha_conv_outer_iwfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of interior walls facing the adjacent thermal zone. (Currently not supported)

alpha_rad_outer_iwfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of interior walls facing the adjacent thermal zone. (Currently not supported)

alpha_comb_outer_iwfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of interior walls facing the adjacent thermal zone. (Currently not supported)

ua_value_iwfloat [W/K]

U-Value times interior wall area. (Does not take adjacent thermal zones into account)

r_conv_inner_iwfloat [K/W]

Sum of convective resistances for all interior walls facing the inside of this thermal zone.

r_rad_inner_iwfloat [K/W]

Sum of radiative resistances for all interior walls facing the inside of this thermal zone

r_comb_inner_iwfloat [K/W]

Sum of combined resistances for all interior walls facing the inside of this thermal zone

r1_iwfloat [K/W]

Lumped resistance of interior walls no heat transfer coefficients for convection and radiation are accounted in this resistance.

c1_iwfloat [J/K]

Lumped capacity of interior walls

Outer Walls (OuterWall, Rooftop, GroundFloor)

area_owfloat [m2]

Area of all outer walls.

n_outerint

Number of total outer walls with different combination of tilt and orientation, including Rooftops and GroundFloors

alpha_conv_inner_owfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of outer walls facing the inside of this thermal zone.

alpha_rad_inner_owfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of outer walls facing the inside of this thermal zone.

alpha_comb_inner_owfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of outer walls facing the inside of this thermal zone.

alpha_conv_outer_owfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of outer walls facing the ambient.

alpha_rad_outer_owfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of outer walls facing the ambient.

alpha_comb_outer_owfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of outer walls facing the ambient.

ua_value_owfloat [W/K]

U-Value times outer wall area.

r_conv_inner_owfloat [K/W]

Sum of convective resistances for all outer walls facing the inside of this thermal zone.

r_rad_inner_owfloat [K/W]

Sum of radiative resistances for all outer walls facing the inside of this thermal zone.

r_comb_inner_owfloat [K/W]

Sum of combined resistances for all outer walls facing the inside of this thermal zone.

r_conv_outer_owfloat [K/W]

Sum of convective resistances for all outer walls facing the ambient.

r_rad_outer_owfloat [K/W]

Sum of radiative resistances for all outer walls facing the ambient.

r_comb_outer_owfloat [K/W]

Sum of combined resistances for all outer walls facing the ambient.

r1_owfloat [K/W]

Lumped resistance of outer walls no heat transfer coefficients for convection and radiation are accounted in this resistance.

r_rest_owfloat [K/W]

Lumped remaining resistance of outer walls between r1_ow and c1_ow no heat transfer coefficients for convection and radiation are accounted in this resistance.

c1_owfloat [J/K]

Lumped capacity of outer walls.

weightfactor_owlist of floats

Weightfactors of outer walls (UA-Value of walls with same orientation and tilt divided by ua_value_ow)

weightfactor_groundlist of floats

Weightfactors of groundfloors (UA-Value of groundfloor divided by ua_value_ow).

tilt_facadelist of floats [degree]

Tilt of outer walls against the horizontal.

orientation_facadelist of floats [degree]

Orientation of outer walls (Azimuth). 0 - North 90 - East 180 - South 270 - West

outer_wall_areaslist of floats [m2]

Area of all outer walls in one list.

ir_emissivity_outer_owfloat

Area-weighted ir emissivity of outer wall facing the ambient.

ir_emissivity_inner_owfloat

Area-weighted ir emissivity of outer walls facing the thermal zone.

solar_absorp_owfloat

Area-weighted solar absorption of outer walls facing the ambient.

Windows

area_winfloat [m2]

Area of all windows.

alpha_conv_inner_winfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of windows facing the inside of this thermal zone.

alpha_rad_inner_winfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of windows facing the inside of this thermal zone.

alpha_comb_inner_winfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of windows facing the inside of this thermal zone.

ratio_conv_rad_inner_winfloat [-]

Ratio for windows between convective and radiative heat emission, given in VDI 6007-3

alpha_conv_outer_winfloat [W/(m2K)]

Area-weighted convective coefficient of heat transfer of windows facing the ambient.

alpha_rad_outer_winfloat [W/(m2K)]

Area-weighted radiative coefficient of heat transfer of windows facing the ambient.

alpha_comb_outer_winfloat [W/(m2K)]

Area-weighted combined coefficient of heat transfer of windows facing the ambient.

ua_value_winfloat [W/K]

U-Value times window wall area.

u_value_winfloat [W/(m2K)]

Area weighted U-Value of windows.

r_conv_inner_winfloat [K/W]

Sum of convective resistances for all windows facing the inside of this thermal zone.

r_rad_inner_winfloat [K/W]

Sum of radiative resistances for all windows facing the inside of this thermal zone.

r_comb_inner_winfloat [K/W]

Sum of combined resistances for all windows facing the inside of this thermal zone.

r_conv_outer_winfloat [K/W]

Sum of convective resistances for all windows facing the ambient.

r_rad_outer_winfloat [K/W]

Sum of radiative resistances for all windows facing the ambient.

r_comb_outer_winfloat [K/W]

Sum of combined resistances for all windows facing the ambient.

r1_winfloat [K/W]

Lumped resistance of windows, no heat transfer coefficients for convection and radiation are accounted in this resistance.

weightfactor_winlist of floats

Weightfactors of windows (UA-Value of windows with same orientation and tilt divided by ua_value_win or ua_value_win+ua_value_ow, depending if windows is lumped/merged into the walls or not)

window_areaslist of floats [m2]

Area of all windows in one list, if the windows are merged into the outer wall this list will be full of zeros

transparent_areaslist of floats [m2]

Area of all transparent elements (most likely windows) in one list, this list will be always filled with the areas, independent if windows are merged into walls or not.

solar_absorp_winfloat

Area-weighted solar absorption for windows. (typically 0.0)

ir_emissivity_winfloat

Area-weighted ir_emissivity for windows. Can be used for windows facing the thermal zone and the ambient.

weighted_g_valuefloat

Area-weighted g-Value of all windows.

shading_max_irrlist of float [W/m2]

Threshold value above which the sunblind becomes active for the whole zone. Threshold regards to the incoming irradiation level with the window direction. This value does not account for heat flux due to the outside temperature.

shading_g_totallist of float

Factor representing how much of the actual solar irradiation goes through the sunblind and enters the window element, for the case, that the sunblind is activated. Defaults to 1, i.e. no shading is active.

Misc values:

alpha_rad_inner_meanfloat [W/(m2K)]

Area-weighted radiative coefficient of all surfaces facing the inside of this thermal zone (OuterWalls, Windows, InnerWalls, …).

alpha_rad_outer_meanfloat [W/(m2K)]

Area-weighted radiative coefficient of all surfaces facing the ambient (OuterWalls, Windows, …).

heat_load[W]

Static heat load of the thermal zone.

facade_areaslist of floats [m2]

List containing the area of each facade (with same tilt and orientation) this includes also roofs and ground floors and windows.

n_outerint

Number of total facades with different combination of tilt and orientation, including Rooftops and GroundFloors

tilt_facadelist of floats [degree]

Tilt of facades against the horizontal.

orientation_facadelist of floats [degree]

Orientation of facades (Azimuth). 0 - North 90 - East 180 - South 270 - West

calc_attributes()

Calls all necessary function to calculate model attributes

set_calc_default()

sets default calculation parameters