.Buildings.UsersGuide.ReleaseNotes.Version_7_0_0 .Buildings.UsersGuide.ReleaseNotes.Version_7_0_0Version 7.0.0 is a major release that contains various new packages, new models and improvements to existing models. The library has been tested with Dymola 2020x and 2021, JModelica (revision 14023), and OPTIMICA (revision OCT-stable-r12473_JM-r14295).
The following major changes have been done:
Buildings.Controls.OBC.Utilities) and to support the
creation of emulators that compare the performance of building
control sequences in the Building Optimization Performance Tests
framework BOPTEST.Buildings.Controls.OBC.CDL.Buildings.ThermalZones.Detailed.Validation.BESTEST.UsersGuide.The following new libraries have been added:
| Buildings.Controls.OBC.Utilities | Package with utility blocks, base classes and validation models for the OpenBuildingControl (OBC) library. |
| Buildings.Utilities.IO.SignalExchange | Package with blocks that can be used to identify and activate control signal overwrites, and to identify and read sensor signals. This package is used by the Building Optimization Performance Test software BOPTEST. |
| Buildings.Utilities.IO.Python36 | Upgraded from
Buildings.Utilities.IO.Python27 since Python2.7 has
been deprecated.This is for issue #1760. |
The following new components have been added to existing libraries:
| Buildings.Controls | |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.MultiZone.VAV.SetPoints.OutdoorAirFlow | Package of sequences for specifying the minimum
outdoor airflow rate. This replaces
Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.MultiZone.VAV.SetPoints.OutsideAirFlow.
The new implemented sequences separate zone level calculation from
the system level calculation. It avoids vector-valued
calculations.This is for #1829. |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.ZoneStatus | Block that outputs zone temperature status by
comparing it with setpoint temperatures, with the maximum and
minimum temperature of the group which the zone is in. This allows
separating the vector-valued calculations from control
sequences. This is for #1709. |
| Buildings.Controls.OBC.CDL.Discrete.TriggeredMovingMean | Block that outputs the triggered discrete moving
mean of an input signal. This replaces
Buildings.Controls.OBC.CDL.Discrete.MovingMean, which
has been moved to Buildings.Obsolete.This is for #1588. |
| Buildings.Controls.OBC.Utilities.OptimalStart | Block that outputs optimal start time for an HVAC system prior to the occupancy. This is for #1589. |
| Buildings.Fluid | |
| Buildings.Fluid.Actuators.Valves.ThreeWayTable | Three way valves with opening characteristics based on a user-provided table. |
| Buildings.Fluid.CHPs | Package with model for combined heat and power device. |
| Buildings.Fluid.Chillers.AbsorptionIndirectSteam | Indirect steam heated absorption chiller based on performance curves. |
| Buildings.Fluid.FixedResistances.CheckValve | Check valve that prevents backflow, except for a
small leakage flow rate. This is for IBPSA, #1198 |
| Buildings.Fluid.HeatPumps.EquationFitReversible | Heat pump model that can be reversed between heating and cooling mode, that takes as a set point the leaving fluid temperature, and that computes its performance based on an equation fit. |
| Buildings.Examples.Tutorial | |
| Buildings.Examples.Tutorial.CDL | Tutorial that explains how to implement control sequences using the Control Description Language. |
The following existing components have been improved in a backward compatible way:
| Buildings.BoundaryConditions.WeatherData | |
| Buildings.BoundaryConditions.WeatherData.ReaderTMY3 | Refactored weather data reader and changed
implementation to allow exactly zero radiation rather than a small
positive value. This was required to allow simulating buildings at
steady-state, which is needed for some controls design. For
examples in which buildings are simulated at steady-state, see
Buildings.ThermalZones.Detailed.Validation.MixedAirFreeResponseSteadyState,
Buildings.Examples.VAVReheat.Validation.Guideline36SteadyState
and
Buildings.ThermalZones.ReducedOrder.Validation.RoomSteadyState.This is for IBPSA, #1340. |
| Buildings.Controls.Continuous | |
| Buildings.Controls.Continuous.LimPID | Removed homotopy that may be used during
initialization to ensure that outputs are bounded. This is for IBPSA, #1221. |
| Buildings.Controls.OBC.CDL | |
| Buildings.Controls.OBC.CDL.Continuous.Derivative | Removed parameter initType and
x_start.This is for IBPSA, #1887. For Dymola, a conversion script makes this change. |
| Buildings.Controls.OBC.CDL.Continuous.IntegratorWithReset | Removed parameter initType.This is for IBPSA, #1887. For Dymola, a conversion script makes this change. |
| Buildings.Controls.OBC.CDL.Continuous.LimPID | Removed homotopy that may be used during
initialization to ensure that outputs are bounded. This is for IBPSA, #1221. |
|
Buildings.Controls.OBC.CDL.Continuous.Sources.CalendarTime Buildings.Controls.OBC.CDL.Types.ZeroTime |
Revised implementation such that the meaning of
time is better explained and unix time stamps are
correctly defined with respect to GMT. Added option unix time stamp
GMT.This is for IBPSA, #1232. |
|
Buildings.Controls.OBC.CDL.Continuous.Sources.CalendarTime Buildings.Controls.OBC.CDL.Types.ZeroTime |
Revised implementation such that the meaning of
time is better explained and unix time stamps are
correctly defined with respect to GMT. Added option unix time stamp
GMT.This is for IBPSA, #1232. |
| Buildings.Controls.OBC.CDL.Logical.Latch Buildings.Controls.OBC.CDL.Logical.Toggle |
Simplified implementation, which makes them work
with OpenModelica. This is for #1823. |
| Buildings.Controls.OBC.CDL.Logical.Timer | Added a boolean input to reset the accumulated
timer. This is for #1221. |
| Buildings.Controls.OBC.CDL.Types.Init | Removed this enumeration because it is no longer
used. This is for #1887. |
| Buildings.Controls.OBC.ASHRAE.G36_PR1 | |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.TrimAndRespond | Corrected to delay the true initial device
status. This is for #1876 |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.TerminalUnits.Reheat.DamperValves | Replaced multisum block with add blocks, replaced
gain block used for normalization with division block. This is for #1830 |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.SingleZone.VAV.Controller | Replaced the mode and setpoint calculation block
with
Buildings.Controls.OBC.ASHRAE.G36_PR1.TerminalUnits.ModeAndSetPoints.This is for #1709 |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.TerminalUnits.Reheat.SetPoints.ActiveAirFlow | Used hysteresis to check occupancy. This is for #1788. |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.MultiZone.VAV.SetPoints.OutsideAirFlow | Applied hysteresis for checking ventilation
efficiency. This is for #1787. |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.TrimAndRespond | Added assertions and corrected implementation when
respond amount is negative. This is for #1503. |
| Buildings.Examples.Tutorial | |
| Buildings.Examples.Tutorial.Boiler Buildings.Examples.Tutorial.SpaceCooling |
Updated examples to use the control blocks from
the Control Description Language package
Buildings.Controls.OBC.CDL. |
| Buildings.Examples.VAVReheat | |
| Buildings.Examples.VAVReheat.BaseClasses.VAVBranch | Added output connector for returned damper position. |
| Buildings.Fluid | |
|
Buildings.Fluid.Actuators.BaseClasses.ActuatorSignal Buildings.Fluid.Actuators.Dampers.PressureIndependent |
Added the computation of the damper opening. |
|
Buildings.Fluid.Actuators.BaseClasses.PartialTwoWayValve Buildings.Fluid.Actuators.Valves.TwoWayEqualPercentage Buildings.Fluid.Actuators.Valves.TwoWayLinear Buildings.Fluid.Actuators.Valves.TwoWayPolynomial Buildings.Fluid.Actuators.Valves.TwoWayPressureIndependent Buildings.Fluid.Actuators.Valves.TwoWayQuickOpening Buildings.Fluid.Actuators.Valves.TwoWayTable |
Improved implementation to guard against control
input that is negative. The new implementation constrains the input
to be bigger than 0. This is for IBPSA, #1233. |
| Buildings.Fluid.Geothermal.Borefields.BaseClasses.HeatTransfer.ThermalResponseFactors.shaGFunction | Declared string as a constant due to JModelica's
tigther type checking. This is for IBPSA, #1230. |
|
Buildings.Fluid.DXSystems.AirCooled.MultiStage Buildings.Fluid.DXSystems.AirCooled.SingleSpeed Buildings.Fluid.DXSystems.AirCooled.VariableSpeed Buildings.Fluid.DXSystems.WaterCooled.MultiStage Buildings.Fluid.DXSystems.WaterCooled.SingleSpeed Buildings.Fluid.DXSystems.WaterCooled.VariableSpeed |
Corrected wrong min and
max attribute for change in humidity.This is for #1933. |
| Buildings.Fluid.Storage.Stratified Buildings.Fluid.Storage.StratifiedEnhanced Buildings.Fluid.Storage.StratifiedEnhancedInternalHex |
Provided option to initialize the tank temperature
at different values across the height of the tank. This is for IBPSA, #1246. |
| Buildings.Fluid.SolarCollectors.BaseClasses.PartialSolarCollector | In volume, set
prescribedHeatFlowRate=false.This is for #1636. |
| Buildings.HeatTransfer | |
| Buildings.HeatTransfer.Convection.Exterior | Set wind direction modifier to a constant as wind
speed approaches zero. This is for #1923. |
| Buildings.ThermalZones.Detailed.Validation.BESTEST.Cases6xx | |
|
Buildings.ThermalZones.Detailed.Validation.BESTEST.Cases6xx.Case600 Buildings.ThermalZones.Detailed.Validation.BESTEST.Cases6xx.Case600FF |
Changed computation of time averaged values to
avoid a time event every hour. This is for #1714. |
| Buildings.ThermalZones.ReducedOrder | |
|
Buildings.ThermalZones.ReducedOrder.RC.OneElement Buildings.ThermalZones.ReducedOrder.RC.TwoElements Buildings.ThermalZones.ReducedOrder.RC.ThreeElements Buildings.ThermalZones.ReducedOrder.RC.FourElements |
Added option to also simulate moisture balance in
room air volume. This can be enabled by setting the parameter
use_moisture_balance = true.This is for IBPSA, #1209. |
| Buildings.Utilities | |
| Buildings.Utilities.IO.Files.CSVWriter Buildings.Utilities.IO.Files.CombiTimeTableWriter Buildings.Utilities.IO.Files.CombiTimeTableWriter |
Revised to avoid overflow of string buffer in
Dymola. This is for IBPSA, #1219. |
| Buildings.Utilities.Math.SmoothHeaviside Buildings.Utilities.Math.Functions.SmoothHeaviside |
This function is now twice instead of only once
Lipschitz continuously differentiable. This is for IBPSA, #1202. |
| Buildings.Utilities.Time.CalendarTime Buildings.Utilities.Time.Types.ZeroTime |
Revised implementation such that the meaning of
time is better explained and unix time stamps are
correctly defined with respect to GMT. Added option unix time stamp
GMT.This is for IBPSA, #1192. |
| Buildings.Utilities.Comfort.Fanger | Updated the model from ASHRAE 1997 to ANSI/ASHRAE
55-2017 and added a validation model which compares the PMV with an
implementation from the University of California at Berkeley. This is for #1936. |
| Buildings.Examples | |
|
Buildings.Examples.VAVReheat.BaseClasses.Floor Buildings.Examples.VAVReheat.ASHRAE2006 Buildings.Examples.VAVReheat.Guideline36 Buildings.Examples.DualFanDualDuct |
Updated core zone geometry parameters related to
room heat and mass balance. This change was done in
Buildings.Examples.VAVReheat.BaseClasses.Floor.This is for #1719. |
The following existing components have been improved in a non-backward compatible way:
| Buildings.Airflow | |
| Buildings.Airflow.Multizone | Set parameters m_flow_small,
m1_flow_small and m2_flow_small to
final so that they do no longer appear on the GUI.
These parameters are not used by models in this package. This is
for IBPSA,
#1362.For Dymola, a conversion script makes this change. |
| Buildings.Controls.OBC.CDL | |
| Buildings.Controls.OBC.CDL.Continuous.LimPID | Refactored model so that it is itself a CDL
conformant composite block. This refactoring removes the no longer
use parameters xd_start that was used to initialize
the state of the derivative term. This state is now initialized
based on the requested initial output yd_start which
is a new parameter with a default of 0. Also, removed
the parameters y_start and initType
because the initial output of the controller can be set by using
xi_start and yd_start. This refactoring
also removes the parameter strict that was used in the
output limiter. The new implementation enforces a strict check by
default.This is for #1878. For Dymola, a conversion script makes this change. |
| Buildings.Controls.OBC.CDL.Continuous.LimPID | Changed the default values for the output limiter
from yMin=-yMax to yMin=0 and from
yMax being unspecified to yMax=1.This is for #1888. For Dymola, a conversion script makes this change. |
| Buildings.Controls.OBC.CDL.Discrete.MovingMean | This block became obsolete, use
Buildings.Controls.OBC.CDL.Discrete.TriggeredMovingMean
instead.For Dymola, a conversion script makes this change. |
| Buildings.Controls.OBC.Utilities.SetPoints.SupplyReturnTemperatureReset | Changed name from
HotWaterTemperatureReset to
SupplyReturnTemperatureReset.This is for #860. For Dymola, a conversion script makes this change. |
| Buildings.Controls.OBC.ASHRAE.G36_PR1 | |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.MultiZone.VAV.Controller | Reimplemented to add new block for specifying the
minimum outdoor airfow setpoint. The new block avoids vector-valued
calculations. The reimplemented controller needs to work with Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.MultiZone.VAV.SetPoints.OutdoorAirFlow.Zone
and
Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.MultiZone.VAV.SetPoints.OutdoorAirFlow.SumZone,
to calculate the zone level minimum outdoor airflow setpoints and
then find the sum, the minimum and the maximum of these setpoints.
See Buildings.Examples.VAVReheat.Guideline36.This is for #1829. |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.OperationMode | Reimplemented to remove the vector-valued
calculations. This is for #1709 |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.SingleZone.VAV.ModeAndSetPoints | Removed from the library as it can be replaced by
Buildings.Controls.OBC.ASHRAE.G36_PR1.TerminalUnits.ModeAndSetPoints.This is for #1709 |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.SingleZone.VAV.Controller | Added cooling coil control and the controller
validation model. This is for #1265 |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.SingleZone.VAV.Economizers.Subsequences.Enable | Added the option to allow fixed plus differential dry bulb temperature cutoff. |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.SingleZone.VAV.Economizers.Subsequences.Modulation | Added heating coil control sequences. |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.SingleZone.VAV.SetPoints.Supply | Added a switch for fan control. |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.SingleZone.VAV.ZoneState | Improved the implementation to avoid issues when heating and cooling controls occur at the same time. |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.TerminalUnits.Reheat.SystemRequests | Changed the actual damper position name from
uDam to yDam_actual.This is for #1873 |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.TerminalUnits.Controller | Added actual VAV damper position as the input for
generating system request. This is for #1873 |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.TerminalUnits.Reheat.DamperValves | Added option to check if the VAV damper is
pressure independent. This is for #1873 |
| Buildings.Controls.SetPoints | |
| Buildings.Controls.SetPoints.SupplyReturnTemperatureReset | Changed name from
HotWaterTemperatureReset to
SupplyReturnTemperatureReset.This is for #860. For Dymola, a conversion script makes this change. |
| Buildings.Fluid.Actuators | |
|
Buildings.Fluid.Actuators.BaseClasses.PartialDamperExponential Buildings.Fluid.Actuators.Dampers.Exponential Buildings.Fluid.Actuators.Dampers.MixingBox Buildings.Fluid.Actuators.Dampers.MixingBoxMinimumFlow Buildings.Fluid.Actuators.Dampers.PressureIndependent Buildings.Fluid.Actuators.Dampers.VAVBoxExponential |
Merged VAVBoxExponential into
Exponential.Exponential now provides all modeling capabilities
previously implemented in VAVBoxExponential which is
no more needed and has been removed from the library.New parameters dpDamper_nominal and
dpFixed_nominal have been introduced in
Exponential, consistent with the valve models.Parameter k0 has been replaced by a leakage
coefficient.For Dymola, a conversion script makes this change. However the script will not make the each keyword persist in array
declarations. The keyword will have to be manually reintroduced
after applying the script.This is for IBPSA, #1188. |
| Buildings.ThermalZones.ReducedOrder | |
|
Buildings.ThermalZones.ReducedOrder.RC.OneElement Buildings.ThermalZones.ReducedOrder.RC.OneElement Buildings.ThermalZones.ReducedOrder.RC.OneElement Buildings.ThermalZones.ReducedOrder.RC.OneElement Buildings.ThermalZones.ReducedOrder.RC.ThreeElements Buildings.ThermalZones.ReducedOrder.RC.ThreeElements Buildings.ThermalZones.ReducedOrder.RC.TwoElements Buildings.ThermalZones.ReducedOrder.RC.TwoElements Buildings.ThermalZones.ReducedOrder.RC.FourElements Buildings.ThermalZones.ReducedOrder.RC.FourElements Buildings.ThermalZones.ReducedOrder.RC.OneElement Buildings.ThermalZones.ReducedOrder.EquivalentAirTemperature.BaseClasses.PartialVDI6007 Buildings.ThermalZones.ReducedOrder.EquivalentAirTemperature.BaseClasses.PartialVDI6007 Buildings.ThermalZones.ReducedOrder.EquivalentAirTemperature.VDI6007WithWindow |
Renamed convection coefficient from
alpha* to hCon*.For Dymola, a conversion script makes this change. This is for IBPSA, #1168. |
The following critical errors have been fixed (i.e., errors that can lead to wrong simulation results):
| Buildings.Controls.OBC.CDL | |
| Buildings.Controls.OBC.CDL.Continuous.Sources.TimeTable | Corrected implementation so that it gives the
correct periodicity of the table if the simulation starts at a
negative time. This is for 1834. |
| Buildings.Electrical | |
|
Buildings.Electrical.AC.OnePhase.Sources.PVSimple Buildings.Electrical.AC.OnePhase.Sources.PVSimpleOriented Buildings.Electrical.AC.ThreePhasesBalanced.Sources.PVSimple Buildings.Electrical.AC.ThreePhasesBalanced.Sources.PVSimpleOriented Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.PVsimple Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.PVsimpleOriented Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.PVsimpleOriented_N Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.PVsimple_N Buildings.Electrical.Interfaces.PartialPV |
Corrected model so that reported power
P also includes the DCAC conversion. Note that the
power added to the elecrical system was correct, but the power
reported in the output connector P did not include
this conversion factor.This is for 1577. |
|
Buildings.Electrical.AC.OnePhase.Storage.Battery Buildings.Electrical.AC.ThreePhasesBalanced.Storage.Battery |
Corrected model and improved the documentation.
The previous model extracted from the AC connector the input power
P plus the AC/DC conversion losses, but P
should be the power exchanged at the AC connector. Conversion
losses are now only accounted for in the energy exchange at the
battery.This is for 1865. |
| Buildings.Examples.VAVReheat | |
| Buildings.Examples.VAVReheat.ASHRAE2006 Buildings.Examples.VAVReheat.Guideline36 |
Connected actual VAV damper position as the
measured input data for defining duct static pressure
setpoint. This is for #1873. |
| Buildings.Examples.VAVReheat.Controls.DuctStaticPressureSetpoint | Reverse action changed to true for
the pressure set-point controller. |
| Buildings.Examples.VAVReheat.Controls.RoomVAV | Refactored the model to implement a single maximum
control logic. The previous implementation led to a maximum air
flow rate in heating demand. The input connector TDis is removed. This is non
backward compatible.This is for #1873. |
| Buildings.Fluid | |
|
Buildings.Fluid.HeatExchangers.CoolingTowers.YorkCalc Buildings.Fluid.HeatExchangers.CoolingTowers.BaseClasses.Characteristics.normalizedPower |
Corrected error in computing the cooling tower fan
power consumption. This is for 1691. |
| Buildings.Utilities | |
|
Buildings/Resources/Python-Sources/KalmanFilter.py Buildings.Utilities.IO.Python27.Examples.KalmanFilter |
Changed the temporary file format from
pickle to json as the former can trigger
a segfault with JModelica simulation run in a subprocess.This is for Buildings, #1587. |
The following uncritical errors have been fixed (i.e., errors that do not lead to wrong simulation results, e.g., units are wrong or errors in documentation):
| Buildings.Controls.OBC.CDL | |
| Buildings.Controls.OBC.CDL.Continuous.LimPID | Removed wrong unit declaration for gain
k.This is for Buildings, #1821. |
| Buildings.Fluid.Sources | |
| Buildings.Fluid.Sources.Boundary_pT Buildings.Fluid.Sources.Boundary_ph Buildings.Fluid.Sources.MassFlowSource_T Buildings.Fluid.Sources.MassFlowSource_h |
Refactored handling of mass fractions which was
needed to handle media such as
Modelica.Media.IdealGases.MixtureGases.FlueGasSixComponents
and
Modelica.Media.IdealGases.MixtureGases.SimpleNaturalGas.Prior to this change, use of these media led to a translation error. This is for IBPSA, #1205. |
| Buildings.ThermalZones.Detailed | |
|
Buildings.ThermalZones.Detailed.Constructions.Examples.ExteriorWallTwoWindows Buildings.ThermalZones.Detailed.Constructions.Examples.ExteriorWallWithWindow |
Corrected wrong assignment of a parameter. This is for IBPSA, #1766. |
| Buildings/Resources | |
| Buildings/Resources/C-Sources/cryptographicsHash.c | Add a #ifndef clause.This is for IBPSA, #1278. |
The following components have become obsolete:
| Buildings.Obsolete | |
| Buildings.Obsolete.Controls.OBC.CDL.Discrete.MovingMean | The block
Buildings.Controls.OBC.CDL.Discrete.TriggeredMovingMean
replaced the original MovingMean block.For Dymola, a conversion script makes this change. This is for #1588. |
| Buildings.Obsolete.Utilities.IO.Python27 | The package
Buildings.Utilities.IO.Python27 has been upgraded to
Buildings.Utilities.IO.Python36.For Dymola, a conversion script moves the Python27 package to here. This is for issue #1760. |