Pre-release status
We want to state, that this release is a pre release and so a (maybe) non stable version with bugs. It is not that havily tested as the other releases. As the enhancements are great we have nevertheless decided to publish this release. So apologies for that.
Non-backwards compatibility
We no longer support python 2.7!
A lot of functions have been deleted in this release (e. g. all XML and GML interactions and old Project() functions for generating archetypes. We highly recommend to use this version.
New classes, parameters and name changes
We deleted the package module `boundaryconditions` all parameters moved to the class `UseConditions`. In particular if you changed the use conditions settings manually you will experience a lot of changes, among these are renamed parameters and additional parameters.
python
Parameters for heating or cooling
with_heating: boolean
Sets if the zone is heated by ideal heater or not.
with_cooling: boolean
Sets if the zone is cooloed by ideal cooler or not.
with_ideal_thresholds: boolean
Sets if the threshold temperatures for ideal heater and cooler should
be used to 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 temperature below ideal heater is used. 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 temperature above ideal cooler is used. 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_profile : list [K]
Heating setpoint for a day or similar. You can set a list of any
length, TEASER will multiplicate this list for one whole year.
cooling_profile : list [K]
Cooling setpoint for a day or similar. You can set a list of any
length, TEASER will multiplicate this list for one whole year.
Internal Gains
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.
persons : float [Persons/m2]
Specific number of persons per square area.
Annex: Used for internal gains
internal_gains_moisture_no_people : float [g/(h m²)]
internal moisture production of plants, etc. except from people.
activity_degree_persons : float [met]
default value is 1.2 met
AixLib: used for heat flow rate calculation (internal_gains_mode=1)
or heat flow rate and moisture gains (internal_gains_mode=3). Both
are temperature and activity degree depending, calculation based
on SIA2024.
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. Default values are derived from
:cite:`VereinDeutscherIngenieure.2015c`.
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. Default values are derived from
:cite:`Davies.2004`.
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
lighting_power: float [W/m2]
spec. electr. Power for lighting. This value is taken from SIA 2024.
AixLib: Used in Zone record for internal gains
Annex: Not used (see Annex examples)
ratio_conv_rad_lighting : float
describes the ratio between convective and radiative heat transfer
of the lighting. Default values are derived from
:cite:`DiLaura.2011`.
AixLib: Used in Zone record for internal gains, lighting
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)
New features
- TEASER goes international! :) Thanks to amaccarini we integrated dansih TABULA archetypes into TEASER
- schedules are now saved as *.txt instead of *.mat
- a lot of fixes and small features 👍