Component List for building definition elements

Building

Base component for the definition of a building. The building is made up of a set of spaces (Space component).

Parameters

The following figure shows the building's coordinate system:

Building coordinate system

Example:


...

building = osm.components.Building("building",project)
param = {
    "azimuth": 90
    "ref_point": [10,10,0]
}
building.set_parameters(param)

Space_type

Component used to define the type of space. This component will be referenced by all spaces that are of the same type. This component defines the internal loads and some of the functional characteristics of the space.

Parameters

Assuming that the variation of occupancy, lighting and other loads has been defined in a "Year_schedule" component, named "schedule" with values between 0 and 1, the following example would capture that variation.

Example:


...

office_space = osm.components.Space_type("office_space",project)
param = {
        "input_variables": ["f = schedule.values"]
        "people_density": "0.1*f",
        "light_density": "10*f",
        "other_gains_density": "4.2*f",
        "other_gains_radiant_fraction": 0.6,
        "infiltration": "0.5"
}
office_space.set_parameters(param)

Variables

After the simulation we will have the following variables of this component:

Space

Component used to define each of the building's spaces. The spaces of a building are each of the volumes of the building where we can find a different temperatures. The spaces will be referenced by the different surfaces that comprise them.

Parameters

Example:


...

space_1 = osm.components.Space("spaces_1",project)
param = {
        "building": "building",
        "spaces_type": "office_space",
        "floor_area": 30,
        "volume": 90
}
space_1.set_parameters(param)

Variables

After the simulation we will have the following variables of this component:

Load_space

A zone defined by its loads instead of by its building. It takes the place of a Space in the air systems (HVAC_perfect_system, HVAC_DX_system, HVAC_SZW_system and HVAC_MZW_system), so that an HVAC installation can be simulated from precalculated load records, for example a column of a File_data, a schedule or a Calculator, without the walls, windows and gains of the building. The project still needs its weather file (simulation_file_met): the equipment and the outdoor air depend on the outdoor conditions.

The loads are the heat that keeps the zone at the reference temperature and humidity, with the same sign as the variables system_sensible_heat and system_latent_heat of a Space: positive heating (or humidifying), negative cooling (or dehumidifying). The variables system_sensible_heat and system_latent_heat of a Space served by an HVAC_perfect_system with a fixed setpoint are such a record. The record already holds the dynamics of the building at constant temperature (the delay of the solar and internal gains stored in its walls); records calculated with a dead band (for example 20-25 °C) are not, since inside the band the load is 0 while the temperature floats, so it is better to calculate them with a fixed setpoint.

When the systems do not supply the load, the zone departs from the reference temperature following a model of two nodes, the air (with the furniture) and the thermal mass of the building, written in deviations θ = T - T_ref:

solved implicitly, so it is stable for any time step. All its parameters have default values: the mass of the building is given by its construction class (heat capacity C_m and area of the mass surfaces A_m per m² of floor, from ISO 13790), with H_am = 9.1 W/(m²·K)·A_m; the envelope conductance is split in two halves, one from the air to the outdoor (windows, H_ao) and the other from the mass (opaque elements, H_mo).

The infiltration the record was calculated with (load_infiltration) is taken out of both loads at the reference conditions, and the simulated one (infiltration) is added at the actual temperature and humidity of the zone, so that a record calculated with one infiltration can be used with another one, for example only while the system is off. It is assumed that the infiltration of the record enters at outdoor conditions, without heat recovery. With the same infiltration in both, and the reference held, the loads are those of the record.

Compared with the detailed model of the ASHRAE 140 boxes (Denver), with the record calculated at 24 °C:

Box Load_space Heating (MWh) Cooling (MWh) Free floating, rms difference
Heavy (case 900) building 1.64 2.61
MEDIUM 1.44 2.24 2.1 K
Light (case 600) building 4.31 5.97
VERY_LIGHT 3.25 4.71 7.1 K
CUSTOM 20 kJ/(m²·K), A_m 1.0 4.18 5.93 1.8 K

(heating and cooling with an ideal system at 20-27 °C; free floating against cases 600FF and 900FF; envelope conductance of the boxes 1.8 W/(m²·K) of floor). The light box of ASHRAE 140 is lighter than any real building and than the lightest ISO class: for it the mass has to be given as CUSTOM.

Parameters

Example:


...

office = osm.components.Load_space("office", project)
param = {
    "input_variables": ["Q = load_record.Q_sensible", "L = load_record.Q_latent"],
    "sensible_load": "Q",
    "latent_load": "L",
    "reference_temperature": "24",
    "floor_area": 48,
    "construction": "HEAVY",
}
office.set_parameters(param)

Variables

After the simulation we will have the following variables of this component:

Building_surface

Component to define the Building surfaces of the building: vertical or inclined walls,horizontal or inclined roofs, interior walls, slabs, underground walls, etc.

Parameters

The following figures show the surface coordinate system versus the building coordinate system for rectangular or polygonal surfaces.

Rectangular surface coordinate system

Polygon surface coordinate system

The simulation of slabs in contact with the ground is carried out for the “UNDERGROUND” surface_type in accordance with the provisions of standard UNE-EN ISO 13370:2017 in Appendix F: Application to dynamic calculation programs. The steady-state transmittance of the slab follows the characteristic dimension B' = 2A/P, and the annual oscillation of the ground is applied through the periodic external heat transfer coefficient of the standard, H_pe = 0.37·P·λ·ln(δ/d_t + 1), proportional to the exposed perimeter P (δ: periodic penetration depth of the ground for the annual cycle, d_t: equivalent thickness of the floor).

Example:


...

north_wall = osm.components.Building_surface("north_wall",project)
param = {
        "ref_point": [8,0,-6],
        "width": 8,
        "height": 2.7,
        "azimuth": 180,
        "altitude": 0,
        "surface_type": "EXTERIOR"
        "construction": "Multilayer_wall",
        "spaces": ["space_1"]
}
north_wall.set_parameters(param)

Variables

After the simulation we will have the following variables of this component, all variables ending in 0 refer to the outer surface and those ending in 1 to the inner surface:

These variables will be 0 for “VIRTUAL” surface_type, and some of the variables only make sense for exterior surfaces, such as E_dir, E_dif, or T_rm.

Opening

Component for defining openings in exterior surfaces or interior surfaces, e.g. windows or doors.

Parameters

The following figure show geometrical definition of the opening in the surface coordinate system.

Opening gemetrical definition

Example:


...

south_window = osm.components.Opening("south_window",project)
param = {
        "surface": "south_wall"
        "ref_point": [2,1],
        "width": 3,
        "height": 1.3,
        "opening_type": "double_glazed_window"
}
south_window.set_parameters(param)

Variables

After the simulation we will have the following variables of this component, all variables ending in 0 refer to the outer surface and those ending in 1 to the inner surface:

Solar_surface

Component for defining shading surfaces external to the building or surface on which we want to calculate incident solar radiation.

Parameters

Example:


...

overhang = osm.components.Solar_surface("overhang")
param = {
            "coordinate_system": "BUILDING"
            "building": "Building",
            "ref_point": [0,-1,2.7],
            "width": 8,
            "height": 1,
            "azimuth": 0,
            "altitude": 90
        },
overhang.set_parameters(param)

Building shadows example

Variables

After the simulation we will have the following variables of this component: