classVersion_9_1_0

Version 9.1.0

Extends from Modelica.Icons.ReleaseNotes (Icon for release notes in documentation).

Information

Version 9.1.0 is backward compatible with 9.0.0.

The library has been tested with Dymola 2023x, OpenModelica 1.20.0-dev (314-g3033f43-1), OPTIMICA (revision 2022-05-09-master-4b0cd2bf71) and recent versions of Impact.

The following major changes have been done:

  • The ASHRAE Guideline 36 air-side sequences have been updated to the official release. They are in the package Buildings.Controls.OBC.ASHRAE.G36. The previous public release draft is still distributed with this version.
  • Various new blocks for the Control Description Language have been added to the package Buildings.Controls.OBC.CDL.
  • The flow rate control in various examples has been improved to avoid large pump or fan heads if the mass flow rate is prescribed rather than computed based on the pump or fan curve.
  • Various models have been improved for robustness, for compatibility with the Modelica.Media library, and to correct errors.

The following new libraries have been added:

Buildings.Controls.OBC
Buildings.Controls.OBC.ASHRAE.G36 Package with sequences implemented according to ASHRAE Guideline 36 official release, May 2020.

The following new components have been added to existing libraries:

Buildings.BoundaryConditions
Buildings.BoundaryConditions.SolarIrradiation.Examples.GlobalPerezTiltedSurface Added model that outputs the global solar irradiation on a tilted surface.
This is for IBPSA, #1654.
Buildings.Controls.OBC.CDL
Buildings.Controls.OBC.CDL.Routing.BooleanExtractSignal
Buildings.Controls.OBC.CDL.Routing.BooleanExtractor
Buildings.Controls.OBC.CDL.Routing.IntegerExtractSignal
Buildings.Controls.OBC.CDL.Routing.IntegerExtractor
Added boolean and integer extract signals.
This is for #3125.
Buildings.DHC.Networks.Combined.BaseClasses
Buildings.DHC.Networks.Combined.BaseClasses.Validation.Pipe Test for comparing Buildings.DHC.Networks.Combined.BaseClasses.PipeAutosize
initialization of dh to Buildings.DHC.Networks.Combined.BaseClasses.PipeStandard.
This is for issue #2510.

The following existing components have been improved in a backward compatible way:

Buildings.Applications.DataCenter
Buildings.Applications.BaseClasses.Equipment.FlowMachine_m
Buildings.Applications.BaseClasses.Equipment.FlowMachine_y
Buildings.Applications.DataCenters.ChillerCooled.Equipment.BaseClasses.PartialCoolingCoilHumidifyingHeating
Buildings.Applications.DataCenters.ChillerCooled.Equipment.BaseClasses.PartialHeatExchanger
Buildings.Applications.DataCenters.ChillerCooled.Equipment.BaseClasses.PartialPumpParallel
Buildings.Applications.DataCenters.ChillerCooled.Equipment.BaseClasses.SignalFilterParameters
Buildings.Applications.DataCenters.ChillerCooled.Equipment.Validation.IntegratedPrimarySecondary
Buildings.Applications.DataCenters.ChillerCooled.Examples.BaseClasses.PartialDataCenter
Buildings.Applications.DataCenters.ChillerCooled.Examples.IntegratedPrimaryLoadSideEconomizer
Buildings.Applications.DataCenters.ChillerCooled.Examples.IntegratedPrimarySecondaryEconomizer
Buildings.Applications.DataCenters.ChillerCooled.Examples.NonIntegratedPrimarySecondaryEconomizer
Improved implementation to avoid high pressures due to pump with forced mass flow rate.
This is for IBPSA, #1659.
Buildings.Controls.OBC.ASHRAE.G36_PR1
Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.MultiZone.VAV.SetPoints.OutdoorAirFlow.AHU Replaced hysteresis with max function to avoid chattering when the fan switches on.
This is for #3106.
Buildings.DHC
Buildings.DHC.ETS.BaseClasses.Validation.CollectorDistributor
Buildings.DHC.ETS.Combined.Subsystems.HeatPump
Buildings.DHC.Examples.Combined.BaseClasses.PartialSeries
Buildings.DHC.Plants.Cooling.ElectricChillerParallel
Buildings.DHC.Plants.Cooling.Examples.ElectricChillerParallel
Buildings.DHC.Plants.Cooling.Subsystems.CoolingTowersParallel
Buildings.DHC.Plants.Cooling.Subsystems.CoolingTowersWithBypass
Buildings.DHC.Plants.Cooling.Subsystems.Examples.BaseClasses.PartialCoolingTowersSubsystem
Buildings.DHC.Plants.Cooling.Subsystems.Examples.CoolingTowersParallel
Improved implementation to avoid high pressures due to pump with forced mass flow rate.
This is for IBPSA, #1659.
Buildings.Fluid
Buildings.Fluid.Actuators.BaseClasses.PartialThreeWayValve Propagated parameter riseTime to valves. The value is not used as the filter is disabled, but it will show in the result file. Having a consistent value for all these parameters in the result filter helps during debugging.
This is for IBPSA, #1663.
Buildings.Fluid.Geothermal.Borefields.BaseClasses.HeatTransfer.ThermalResponseFactors.gFunction Initialized variable which otherwise lead to the simulation to fail in OpenModelica.
This is for IBPSA, #1664.
Buildings.Fluid.Interfaces.ConservationEquation
Buildings.Fluid.Interfaces.StaticTwoPortConservationEquation
Buildings.Fluid.MixingVolumes.MixingVolume
Buildings.Fluid.MixingVolumes.MixingVolume.MoistAir
Buildings.Fluid.Sensors.TemperatureWetBulbTwoPort
Improved implementation so that models also work with certain media from the Modelica Standard Library that may be used to model combustion gases.
This is for IBPSA, #1650.
Buildings.Fluid.Movers.FlowControlled_dp
Buildings.Fluid.Movers.FlowControlled_m_flow
Buildings.Fluid.Movers.SpeedControlled_Nrpm
Buildings.Fluid.Movers.SpeedControlled_y
Avoided negative flow work if the flow or pressure is forced in a way that the flow work would be negative.
This is for IBPSA, #1621.
Buildings.HeatTransfer.Windows
Buildings.HeatTransfer.Windows.Functions.glassTRExteriorIrradiationNoShading
Buildings.HeatTransfer.Windows.Functions.glassTRInteriorIrradiationNoShading
Added default value for output variables.
This is for #3111.
Buildings.Utilities.Math.Functions.regNonZeroPower Improved documentation and assertion.
This is for Buildings, issue #3135.
Buildings.ThermalZones.ReducedOrder
Buildings.ThermalZones.ReducedOrder.SolarGain.CorrectionGDoublePane Corrected units of protected variables to avoid warning during model check.
This is for IBPSA, issue #1644.
Buildings.Utilities.Math
Buildings.Utilities.Math.Functions.spliceFunction
Buildings.Utilities.Math.Functions.BaseClasses.der_spliceFunction
Improved implementation of transition limits.
This is for IBPSA, issue #1640.
Buildings.DHC.Networks.Combined.BaseClasses
Buildings.DHC.Networks.Combined.BaseClasses.PipeAutosize start attribute for parameter dh changed to 0.01.
min attribute for parameter dh changed to 0.001.
This is for issue #2510.

The following existing components have been improved in a non-backward compatible way:

Buildings.Fluid.Examples
Buildings.Fluid.Examples.SimpleHouse Changed conDam.yMin from 0.1 to 0.25.
This is for IBPSA, #1624.
Buildings.Examples.ScalableBenchmarks
Buildings.Examples.ScalableBenchmarks.BuildingVAV.Examples.OneFloor_OneZone Changed fan[].m_flow_nominal from 10 to 0.1.
This is for #3067

The following critical errors have been fixed (i.e., errors that can lead to wrong simulation results):

Buildings.Electrical.DC
Buildings.Electrical.DC.Storage.BaseClasses.Charge Corrected calculation of power taken from the battery when it is discharged.
This is for issue 3095.
Buildings.DHC.Plants.Cooling
Buildings.DHC.Plants.Cooling.ElectricChillerParallel Corrected wrong assignments for chiller system mulChiSys which assigned chilled water to condenser water parameters and vice versa.
Buildings.Controls.OBC
Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.OperationMode Corrected input for enabling freeze protection setback mode.
This is for issue 3084.
Buildings.Examples
Buildings.Examples.HydronicHeating.TwoRoomsWithStorage Corrected outdoor temperature in instance TOutSwi at which system switches on and off.
This is for issue 3059.
Buildings.Fluid.HeatExchangers
Buildings.Fluid.HeatExchangers.BaseClasses.PartialEffectivenessNTU Corrected wrong temperature in assignment of sta2_default. For Buildings.Media.Air and Buildings.Media.Water this error does not affect the results.
This is for Buildings, issue 3151
Buildings.Fluid.DXSystems.AirCooled.MultiStage
Buildings.Fluid.DXSystems.AirCooled.SingleStage
Buildings.Fluid.DXSystems.AirCooled.VariableSpeed
Buildings.Fluid.DXSystems.WaterCooled.MultiStage
Buildings.Fluid.DXSystems.WaterCooled.SingleStage
Buildings.Fluid.DXSystems.WaterCooled.VariableSpeed
Buildings.Fluid.DXSystems.Cooling.BaseClasses.CapacityWaterCooled
Buildings.Fluid.DXSystems.BaseClasses.PartialCoolingCapacity
Corrected performance calculation as a function of mass flow rates.
This is for #3146.
Buildings.Fluid.HeatExchangers.WetCoilCounterFlow
Buildings.Fluid.HeatExchangers.WetCoilDiscretized
Reverted the correction on latent heat from component.
This is for #3065.
Buildings.Fluid.HeatExchangers.Validation.WetCoilCounterFlowLowWaterFlowRate
Modify air source boundary condition so air enters coil at 99.5% relative humidity.
This is for #3065.