- usage: str
usage type
AixLib usage: String to distinguish usages of a zone
- typical_length: float [m]
typical length of a room in a usage zone. This value is taken from
SIA 2024. Archetype usage: division of usage zones in rooms
- typical width: float [m]
typical width of a usage zone. This value is taken from
SIA 2024. Archetype usage: division of usage zones in rooms
- with_heating: boolean
Sets if the zone is heated by ideal heater or not.
- with_cooling: boolean
Sets if the zone is cooled by ideal cooler or not.
- with_ideal_thresholds: boolean
Sets if the threshold temperatures for ideal heater and cooler are
used.
True = T_threshold_heating and T_threshold_cooling are used.
This can, in most cases, prevent simultaneous heating from AHU and
cooling from ideal heater and vice versa. This should only be turned
on if an AHU exists.
- T_threshold_heating: float [K]
Threshold for the outside temperature above which the ideal heater is
permanently shut down regardless the inside temperature.
Default is 15 °C which corresponds to the value for all buildings
that are not built
according to EnEV standard according to DIN EN 18599-5.
- T_threshold_cooling: float [K]
Threshold for the outside temperature below which the ideal cooler is
permanently shut down regardless the inside temperature.
Default is 22 °C, since there are no european standards
for cooling degree days this value is taken from the following paper:
“Heating Degree Days, Cooling Degree Days and Precipitation in Europe
—analysis for the CELECT-project” by Benestad, 2008.
- heating_profilelist [K]
Heating setpoint, regarding the zone temperature, of ideal static
heating for a day or similar. You can set a list of any
length, TEASER will multiplicate this list for one whole year.
- cooling_profilelist [K]
Cooling setpoint, regarding the zone temperature, of ideal static
cooling for a day or similar. You can set a list of any
length, TEASER will multiplicate this list for one whole year.
- fixed_heat_flow_rate_persons: float [W/person]
fixed heat flow rate for one person in case of temperature
independent calculation. Default value is 70
W/person and describes
the maximum heat flow rate depending on the schedule.
- personsfloat [Persons/m2]
Specific number of persons per square area.
Annex: Used for internal gains
- internal_gains_moisture_no_peoplefloat [g/(h m²)]
internal moisture production of plants, etc. except from people.
- activity_degree_personsfloat [met]
default value is 1.2 met
AixLib: used for heat flow rate calculation (internal_gains_mode=1)
or heat flow rate, moisture and co2 gains (internal_gains_mode=3). Both
are temperature and activity degree depending, calculation based
on SIA2024 (2015) and Engineering ToolBox (2004).
Annex: not used, heat flow rate is constant value
fixed_heat_flow_rate_persons
- ratio_conv_rad_persons: float
describes the ratio between convective and radiative heat transfer
of the persons [convective/radiative]. Default values are derived from
[12].
AixLib: Used in Zone record for internal gains
Annex: Used for internal gains
- persons_profile: list
Relative presence of persons 0-1 (e.g. 0.5 means that 50% of the total
number of persons are currently in the room). Given
for 24h. This value is taken from SIA 2024. You can set a list of any
length, TEASER will multiplicate this list for one whole year.
AixLib: Used for internal gains profile on top-level
Annex: Used for internal gains
- machines: float [W/m2]
area specific eletrical load of machines per m2. This value is taken
from SIA 2024 and DIN V 18599-10 for medium occupancy.
AixLib: Used in Zone record for internal gains,
internalGainsMachinesSpecific
Annex: Used for internal gains
- ratio_conv_rad_machines: float
describes the ratio between convective and radiative heat transfer
of the machines [convective/radiative]. Default values are derived from
[18].
AixLib: Used in Zone record for internal gains
Annex: Not used, all machines are convective (see Annex examples)
- machines_profile: list
Relative presence of machines 0-1 (e.g. 0.5 means that 50% of the total
number of machines are currently used in the room). Given
for 24h. This value is taken from SIA 2024. You can set a list of any
length, TEASER will multiplicate this list for one whole year.
AixLib: Used for internal gains profile on top-level
Annex: Used for internal gains
- use_maintained_illuminance: bool
decision variable to determine wether lighting_power will be given by
fixed_lighting_power or by calculation using the variables maintained_illuminance
and lighting_efficiency_lumen
- lighting_power: float [W/m2]
spec. electr. Power for lighting
Determined by use_maintained_illuminance
Not needed in input json file
AixLib: Used in Zone record for internal gains
Annex: Not used (see Annex examples)
- fixed_lighting_power: float [W/m2]
spec. fixed electrical power for lighting. This value is taken from SIA 2024.
- ratio_conv_rad_lightingfloat
describes the ratio between convective and radiative heat transfer
of the lighting [convective/radiative]. Default values are derived from
[19].
AixLib: Used in Zone record for internal gains, lighting
- maintained_illuminancefloat [Lx]
maintained illuminance value for lighting.
This value is partially taken from SIA 2024 (2015-10) and partially
from DIN V EN 18599-10 (2018-09).
- lighting_efficiency_lumen: float [lm/W_el]
lighting efficiency in lm/W_el, in german: Lichtausbeute
- lighting_profil[float]
Relative presence of lighting 0-1 (e.g. 0.5 means that 50% of the total
lighting power are currently used). Typically given for 24h. This is
aligned to the user profile.
AixLib: Used for internal gains profile on top-level
Annex: Not used (see Annex examples)
- min_ahu: float [m3/(m2*h)]
Zone specific minimum specific air flow supplied by the AHU.
AixLib: Used on Multizone level for central AHU to determine total
volume flow of each zone.
- max_ahufloat [m3/(m2*h)]
Zone specific maximum specific air flow supplied by the AHU.
AixLib: Used on Multizone level for central AHU to determine total
volume flow of each zone.
- with_ahuboolean
Zone is connected to central air handling unit or not
AixLib: Used on Multizone level for central AHU.
- use_constant_infiltrationboolean
choose whether window opening should be regarded.
true = natural infiltration + ventilation due to a AHU
false = natural infiltration + ventilation due to a AHU
+ window infiltration calculated by window opening model
AixLib: Used on Zone level for ventilation.
- normative_infiltration: float [1/h]
Infiltration rate for static heat load calculation.
Default is 0.5 based on the DIN EN 12831-1:2017 minimal air exchange rate reference value.
- base_infiltrationfloat [1/h]
base value for the natural infiltration without window openings
AixLib: Used on Zone level for ventilation.
- max_user_infiltrationfloat [1/h]
Additional infiltration rate for maximum persons activity
AixLib: Used on Zone level for ventilation.
- max_overheating_infiltrationlist [1/h]
Additional infiltration rate when overheating appears
AixLib: Used on Zone level for ventilation.
- max_summer_infiltrationlist
Additional infiltration rate in the summer with
[infiltration_rate [1/h], Tmin [K], Tmax [K]]. Default values are
aligned to [20].
AixLib: Used on Zone level for ventilation.
- winter_reduction_infiltrationlist
Reduction factor of userACH for cold weather with
[infiltration_rate [1/h], Tmin [K], Tmax [K]]
AixLib: Used on Zone level for ventilation.
Default values are
aligned to [20].
- schedules: pandas.DataFrame
All time dependent boundary attributes in one pandas DataFrame, used
for export (one year in hourly timestamps.) Derived from json.
Schedules can be adjusted by setting the following parameters:
adjusted_opening_times
first_saturday_of_year
profiles_weekend_factor
set_back_times
heating_set_back
cooling_set_back
To take adjustments into account you need to call calc_schedules()
function afterwards.
Note: python attribute, not customizable by user (derived from Json)
- adjusted_opening_times: list
Sets the first and last hour of opening. These will cut or extend the
existing profiles (machines, lights, persons).
[opening_hour, closing_hour]
- first_saturday_of_year: int
Weekday number of first saturday of the year [1:monday;7:tuesday].
Is needed to calc which days of profile should be reduced by
profiles_weekend_factor.
- profiles_weekend_factor: float
Factor to scale the existing profiles on weekends. For a reduction use
values between [0;1]. Increase is also possible.
- set_back_times: list
- Sets the first and last hour outside of which the offset is applied.
List of two integers [first_hour, last_hour]
- heating_set_back: float [K]
- Set back temperature offset for heating profile. Positive (+) values
increase the profile, negative (-) decrease.
- cooling_set_back: float [K]
Set back temperature offset for cooling profile. Positive (+) values
increase the profile, negative (-) decrease.