teaser.logic.archetypebuildings.bmvbs package

Subpackages

Submodules

teaser.logic.archetypebuildings.bmvbs.office module

class teaser.logic.archetypebuildings.bmvbs.office.Office(parent, name=None, year_of_construction=None, number_of_floors=None, height_of_floors=None, net_leased_area=None, with_ahu=False, internal_gains_mode=1, office_layout=None, window_layout=None, construction_type=None)[source]

Bases: NonResidential

Archetype Office Building according to BMVBS

Subclass from NonResidential archetype class to represent office buildings.

The office module contains a multi zone building according to BMVBS (see [1]). This German office building contains 6 usage zones (zones with similar thermal behaviour). Each zone has 4 outer walls, 4 windows, a roof and a ground floor. Depending on zone usage (typical length and width), an interior wall area is assigned. Exterior wall surfaces are estimated based on [1]. Refinements of the archetype follow the approach of [4]. number_of_floors and height_of_floors are mandatory parameters. Additional information can be passed to the archetype (e.g. floor layout and window layout).

All default values are given according to [1] and [4] if not stated otherwise.

In detail the net leased area is divided into the following thermal zone areas:

  1. Office (50% of net leased area)

  2. Floor (25% of net leased area)

  3. Storage (15% of net leased area)

  4. Meeting (4% of net leased area)

  5. Restroom (4% of net leased area)

  6. ICT (2% of net leased area)

Parameters
parent: Project()

The parent class of this object, the Project the Building belongs to. Allows for better control of hierarchical structures. If not None it adds this Building instance to Project.buildings. (default: None)

namestr

Individual name

year_of_constructionint

Year of first construction

height_of_floorsfloat [m]

Average height of the buildings’ floors

number_of_floorsint

Number of building’s floors above ground

net_leased_areafloat [m2]

Total net leased area of building. This is area is NOT the footprint of a building

with_ahuBoolean

If set to True, an empty instance of BuildingAHU is instantiated and assigned to attribute central_ahu. This instance holds information for central Air Handling units. Default is False.

internal_gains_mode: int [1, 2, 3]

mode for the internal gains calculation done in AixLib:

  1. Temperature and activity degree dependent heat flux calculation for persons. The calculation is based on SIA 2024 (default)

  2. Temperature and activity degree independent heat flux calculation for persons, the max. heatflowrate is prescribed by the parameter fixed_heat_flow_rate_persons.

  3. Temperature and activity degree dependent calculation with consideration of moisture and co2. The moisture calculation is based on SIA 2024 (2015) and regards persons and non-persons, the co2 calculation is based on Engineering ToolBox (2004) and regards only persons.

office_layoutint

Structure of the floor plan of office buildings, default is 1, which is representative for one elongated floor.

  1. elongated 1 floor

  2. elongated 2 floors

  3. compact (e.g. for a square base building)

window_layoutint

Structure of the window facade type, default is 0, which is a generic facade representing a statistical mean value of window area. This is the foundation for calculating the other window layouts with correction factors.

  1. generic facade

  2. punctuated facade (individual windows)

  3. banner facade (continuous windows)

  4. full glazing

construction_typestr

Construction type of used wall constructions default is “heavy”)

  • heavy: heavy construction

  • light: light construction

Notes

The listed attributes are just the ones that are set by the user calculated values are not included in this list. Changing these values is expert mode.

Attributes
zone_area_factorsdict

This dictionary contains the name of the zone (str), the zone area factor (float) and the zone usage from BoundaryConditions json (str). (Default see doc string above)

outer_wall_namesdict

This dictionary contains a random name for the outer walls, their orientation and tilt. Default is a building in north-south orientation)

roof_namesdict

This dictionary contains the name of the roofs, their orientation and tilt. Default is one flat roof.

ground_floor_namesdict

This dictionary contains the name of the ground floors, their orientation and tilt. Default is one ground floor.

window_namesdict

This dictionary contains the name of the window, their orientation and tilt. Default is a building in north-south orientation)

inner_wall_namesdict

This dictionary contains the name of the inner walls, their orientation and tilt. Default is one cumulated inner wall.

ceiling_namesdict

This dictionary contains the name of the ceilings, their orientation and tilt. Default is one cumulated ceiling.

floor_namesdict

This dictionary contains the name of the floors, their orientation and tilt. Default is one cumulated floor.

gross_factorfloat

gross factor used to correct the rooftop and floor area (default is 1.15)

est_factor_wall_areafloat

estimation factor to calculate outer wall area

est_exponent_wallfloat

estimation factor exponent to calculate outer wall area

est_factor_win_areafloat

estimation factor to calculate window area

est_exponent_winfloat

estimation factor exponent to calculate window area

property construction_type
generate_archetype()[source]

Generates an office building.

With given values, this class generates an office archetype building according to TEASER requirements.

property office_layout
property window_layout

teaser.logic.archetypebuildings.bmvbs.singlefamilydwelling module

class teaser.logic.archetypebuildings.bmvbs.singlefamilydwelling.SingleFamilyDwelling(parent, name=None, year_of_construction=None, number_of_floors=None, height_of_floors=None, net_leased_area=None, with_ahu=False, internal_gains_mode=1, residential_layout=None, neighbour_buildings=None, attic=None, cellar=None, dormer=None, construction_type=None)[source]

Bases: Residential

Archetype Residential Building according

Subclass from Residential archetype class to represent SingleFamilyDwelling according to IWU [3].

The SingleFamilyDwelling module contains a single zone building. It has 4 outer walls, 4 windows, a flat roof and a ground floor. Interior wall areas are assigned related to typical width and depth of zones according to [13]. It makes number_of_floors and height_of_floors mandatory parameters. Additional information can be passed to the archetype (e.g. floor layout and number of neighbors).

Default values are given according to IWU.

In detail the net leased area is divided into the following thermal zone area:

  1. Single dwelling (100% of net leased area)

Parameters
parent: Project()

The parent class of this object, the Project the Building belongs to. Allows for better control of hierarchical structures. If not None it adds this Building instance to Project.buildings. (default: None)

namestr

Individual name

year_of_constructionint

Year of first construction

height_of_floorsfloat [m]

Average height of the buildings’ floors

number_of_floorsint

Number of building’s floors above ground

net_leased_areafloat [m2]

Total net leased area of building. This is area is NOT the footprint of a building

with_ahuBoolean

If set to True, an empty instance of BuildingAHU is instantiated and assigned to attribute central_ahu. This instance holds information for central Air Handling units. Default is False.

internal_gains_mode: int [1, 2, 3]

mode for the internal gains calculation done in AixLib:

  1. Temperature and activity degree dependent heat flux calculation. The calculation is based on SIA 2024 (default)

  2. Temperature and activity degree independent heat flux calculation, the max. heatflowrate is prescribed by the parameter fixed_heat_flow_rate_persons.

  3. Temperature and activity degree dependent calculation with consideration of moisture and co2. The moisture calculation is based on SIA 2024 (2015), the co2 calculation is based on Engineering ToolBox (2004)

residential_layoutint

Structure of floor plan (default = 0)

  1. compact

  2. elongated/complex

neighbour_buildingsint

Number of neighbour buildings. CAUTION: this will not change the orientation of the buildings wall, but just the overall exterior wall and window area(!) (default = 0)

  1. no neighbour

  2. one neighbour

  3. two neighbours

atticint

Design of the attic. CAUTION: this will not change the orientation or tilt of the roof instances, but just adapt the roof area(!) (default = 0)

  1. flat roof

  2. non heated attic

  3. partly heated attic

  4. heated attic

cellarint

Design of the of cellar CAUTION: this will not change the orientation, tilt of GroundFloor instances, nor the number or area of ThermalZones, but will change GroundFloor area(!) (default = 0)

  1. no cellar

  2. non heated cellar

  3. partly heated cellar

  4. heated cellar

dormerstr

Is a dormer attached to the roof? CAUTION: this will not change roof or window orientation or tilt, but just adapt the roof area(!) (default = 0)

  1. no dormer

  2. dormer

construction_typestr

Construction type of used wall constructions default is “heavy”

  • heavy: heavy construction

  • light: light construction

Notes

The listed attributes are just the ones that are set by the user calculated values are not included in this list. Changing these values is expert mode.

Attributes
zone_area_factorsdict

This dictionary contains the name of the zone (str), the zone area factor (float) and the zone usage from BoundaryConditions json (str). (Default see doc string above)

outer_wall_namesdict

This dictionary contains a random name for the outer walls, their orientation and tilt. Default is a building in north-south orientation)

roof_namesdict

This dictionary contains the name of the roofs, their orientation and tilt. Default is one flat roof.

ground_floor_namesdict

This dictionary contains the name of the ground floors, their orientation and tilt. Default is one ground floor.

window_namesdict

This dictionary contains the name of the window, their orientation and tilt. Default is a building in north-south orientation)

inner_wall_namesdict

This dictionary contains the name of the inner walls, their orientation and tilt. Default is one cumulated inner wall.

ceiling_namesdict

This dictionary contains the name of the ceilings, their orientation and tilt. Default is one cumulated ceiling.

floor_namesdict

This dictionary contains the name of the floors, their orientation and tilt. Default is one cumulated floor.

est_living_area_factorfloat

Estimation factor for calculation of number of heated floors

est_bottom_building_closurefloat

Estimation factor to calculate ground floor area

est_upper_building_closurefloat

Estimation factor to calculate attic area

est_factor_win_areafloat

Estimation factor to calculate window area

est_factor_cellar_areafloat

Estimation factor to calculate heated cellar area

property attic
property cellar
property construction_type
property dormer
generate_archetype()[source]

Generates a SingleFamilyDwelling building.

With given values, this class generates a archetype building for single family dwellings according to TEASER requirements

property neighbour_buildings
property residential_layout