TEASER release v0.7.0

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.

# 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 👍