classVersion_13_0_0
Version 13.0.0
Extends from Modelica.Icons.ReleaseNotes (Icon for release notes in documentation).
Information
Version 13.0.0 is a major release that adds various new packages and models.
The library has been tested with Dymola 2026x, OpenModelica 1.26.3, OPTIMICA 1.66 and recent versions of Impact.
The following major changes have been done compared to release 12.0.0:
-
The package
Buildings.Controls.OBC.ASHRAE.G36.FanCoilUnithas been added with control sequences for fan coil units. -
The package
Buildings.DHC.ETS.Combinedhas been replaced with improved models, and the old models have been moved to theBuildings.Obsoletepackage. -
The package
Buildings.Templateshas been refactored to use load-dependent 2D table data for chiller and heat pump models. -
The package
Buildings.Fluid.AirFiltershas been added with models for air filters. -
The package
Buildings.Fluid.HeatExchangers.ThermalWheelshas been added with models for heat recovery and enthalpy recovery wheels. -
The package
Buildings.Media.Antifreeze.Functionshas been added to enable calling glycol property functions without instantiating a package. -
The package
Buildings.Utilities.IO.Python_3_12has been added with models to call Python 3.12 modules from a Modelica block. This package replacesBuildings.Utilities.IO.Python_3_8which has been moved to theBuildings.Obsoletepackage. -
The models of cooling towers in
Buildings.Fluid.HeatExchangers.CoolingTowershave been refactored to use a data record for the performance data, and a new model of a dry cooler that uses the epsilon-NTU relation has been added.
Also, many models have been updated to improve performance, to improve compliance with the Modelica Language Standard and to correct model errors.
This version also changes the weather data conversion from using Java to Python.
This change was made when correcting an issue that caused a discontinuity in wind
direction interpolation when the direction changes between 0 and 360 degrees.
Users should update their existing weather files by running the Python script
Buildings/Resources/bin/convert_weather_data.py as
this requires a conversion of the wind direction data.
See IBPSA, #2068.
The following new libraries have been added:
| Buildings.Controls.OBC.ASHRAE.G36.FanCoilUnit | Package with control sequences for fan coil units. This is for issue 2885. |
| Buildings.Fluid.AirFilters | Package with models for air filters. This is for issue 3618. |
| Buildings.Fluid.HeatExchangers.ThermalWheels | Package with models for heat recovery and enthalpy recovery wheels. This is for #3538. |
| Buidings.Utilities.IO.Python_3_12 | Package with models to call Python 3.12 modules from a Modelica block. This package replaces Buidings.Utilities.IO.Python_3_8 which has
been moved to the Buildings.Obsolete package.This is for issue 4347. |
The following new components have been added to existing libraries:
| Buildings.Fluid | |
| Buildings.Fluid.HeatExchangers.CoolingTowers.DryCooler | Model of a dry cooler that uses the epsilon-NTU relation,
with convection coefficients varying with flow rates and temperature. This is for issue 4567. |
| Buildings.Media | |
| Buildings.Media.Antifreeze.Functions.EthyleneGlycolWater Buildings.Media.Antifreeze.Functions.PropyleneGlycolWater |
Packages that allows function calls of media properties without
having to instantiate a package. This allows calling the
functions from a Modelica record.This is for IBPSA, issue 2115. |
The following existing components have been improved in a backward compatible way:
| Buildings.BoundaryConditions.WeatherData | |
| Buildings.BoundaryConditions.WeatherData.ReaderTMY3 | Changed the class type from block to model. This is for IBPSA, #2091. Changed weather data interpolation to avoid a discontinuity in wind directory when it switches between 0 and 360 degrees. This is for IBPSA, #2068. |
| Buildings.Airflow | |
| Buildings.Airflow.Multizone | Optimized code to reduce computing time for interzonal air exchange models. This is for IBPSA, issue 2043. |
| Buildings.Controls.OBC.CDL | |
| Buildings.Controls.OBC.CDL.Logical.Latch | Reformulated initalization to avoid non-linear equations in when blocks.This is for IBPSA, issue 2064. |
| Buildings.Fluid.Examples | |
| Buildings.Fluid.Examples.ResistanceVolumeFlowReversal | Added two-port temperature sensors to replace vol[.].T
from reference results.This is for #4276. |
| Buildings.Fluid.FixedResistances | |
| Buildings.Fluid.FixedResistances.PlugFlowPipe Buildings.Fluid.FixedResistances.PlugFlowPipeDiscretized |
Added option to disable pressure drop calculation. This is for IBPSA, issue 2015. |
| Buildings.Fluid.FixedResistances.PlugFlowPipe | Removed stray Line annotation. Added if-then to conditional connections.This is for IBPSA, #2071. |
| Buildings.Fluid.Geothermal.Borefields | |
| Buildings.Fluid.Geothermal.Borefields.BaseClasses.HeatTransfer.ThermalResponseFactors.Validation.FiniteLineSource_Erfint | Added an assert-statement for err
and removed it from reference results.This is for #4277. |
| Buildings.Fluid.Geothermal.Borefields.BaseClasses.HeatTransfer.GroundTemperatureResponse Buildings.Fluid.Geothermal.ZonedBorefields.BaseClasses.HeatTransfer.GroundTemperatureResponse |
Reformulated when block to avoid continuous and discrete variable assignment in the same block.This is for #4321 |
| Buildings.Fluid.HeatExchangers | |
| Buildings.Fluid.HeatExchangers.ThermalWheels | Package of models for heat recovery and enthalpy recovery wheels. This is for issue 3538. |
| Buildings.Fluid.HeatPumps | |
| Buildings.Fluid.HeatPumps.ModularReversible | Improved implementation and diagnostics of safety checks. This is for IBPSA, issue 2035. |
| Buildings.Obsolete.Utilities.IO.Python_3_8 | |
| Buildings.Obsolete.Utilities.IO.Python_3_8.Functions.BaseClasses.exchange | Added missing header file. This is for issue 4343. |
| Buildings.ThermalZones.Detailed | |
| Buildings.ThermalZones.Detailed.BaseClasses.ExteriorBoundaryConditions | Explicitly assigned value to the roughness of the exterior constructions. This is for issue 4367. |
| Buildings.ThermalZones.EnergyPlus_24_2_0 | |
| Buildings.ThermalZones.EnergyPlus_24_2_0.BaseClasses.ThermalZoneAdapter | Added an assertion that stops the simulation if the air pressure is unreasonable, which may
be the case if a user provides fresh air but not exhaust air path. This is for issue 3319. |
| Buildings.Utilities.IO.Python_3_12 | |
| Buildings.Utilities.IO.Python_3_12.Functions.BaseClasses.exchange | Added missing header file. This is for issue 4343. |
| Buildings.Utilities.Math.Functions | |
| Buildings.Utilities.Math.Functions.bicubic Buildings.Utilities.Math.Functions.quadraticLinear Buildings.Utilities.Math.Functions.quinticHermite Buildings.Utilities.Math.Functions.smoothHeaviside Buildings.Utilities.Math.Functions.smoothLimit |
Declared the functions to be inlined. This is for issue 4278. |
The following existing components have been improved in a non-backward compatible way:
| Buildings.Controls.OBC.ASHRAE.G36.AHUs | |
| Buildings.Controls.OBC.ASHRAE.G36.AHUs.MultiZone.VAV.Controller Buildings.Controls.OBC.ASHRAE.G36.AHUs.MultiZone.VAV.SetPoints.FreezeProtection Buildings.Controls.OBC.ASHRAE.G36.AHUs.MultiZone.VAV.SetPoints.PlantRequests Buildings.Controls.OBC.ASHRAE.G36.AHUs.SingleZone.VAV.Controller Buildings.Controls.OBC.ASHRAE.G36.AHUs.SingleZone.VAV.SetPoints.FreezeProtection Buildings.Controls.OBC.ASHRAE.G36.AHUs.SingleZone.VAV.SetPoints.PlantRequests |
Renamed the parameter Thys to THys.This is for issue 4374. |
| Buildings.DHC | |
| Buildings.DHC.ETS.Combined.ChillerBorefield Buildings.DHC.ETS.Combined.Examples.ChillerBorefield Buildings.DHC.ETS.Combined.Examples.ChillerOnly Buildings.DHC.ETS.Combined.Validation.ChillerBorefield Buildings.DHC.ETS.Combined.Validation.ChillerOnly Buildings.DHC.ETS.Combined.Validation.ChillerWSE Buildings.DHC.ETS.Combined.Validation.BaseClasses.PartialChillerBorefield Buildings.DHC.ETS.Combined.Subsystems.Borefield Buildings.DHC.ETS.Combined.Subsystems.Chiller Buildings.DHC.ETS.Combined.Subsystems.Validation.Borefield Buildings.DHC.ETS.Combined.Subsystems.Validation.Chiller Buildings.DHC.ETS.Combined.Controls.Chiller Buildings.DHC.ETS.Combined.Controls.Borefield Buildings.DHC.ETS.Combined.Controls.Supervisory Buildings.DHC.ETS.Combined.Controls.SideHot Buildings.DHC.ETS.Combined.Controls.SideCold Buildings.DHC.ETS.Combined.Controls.BaseClasses.PartialSupervisory Buildings.DHC.ETS.Combined.Controls.HeatExchanger |
Moved to Buildings.Obsolete as these are replaced with improved models.This is for issue 4354. |
| Buildings.DHC.ETS.Combined.Controls.PIDWithEnable | Moved to Buildings.Controls.OBC.Utilities.PIDWithEnable as there were two identical implementations.
|
| Buildings.Fluid | |
| Buildings.Fluid.HeatExchangers.CoolingTowers | Refactored models to use a data record for the performance data. The old models were moved to the Buildings.Obsolete package,
and a conversion script updates old models to the new ones.This is for #4489. |
| Buildings.Fluid.Chillers.ModularReversible.RefrigerantCycle.TableData2DLoadDep Buildings.Fluid.Chillers.ModularReversible.TableData2DLoadDep Buildings.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.TableData2DLoadDep Buildings.Fluid.HeatPumps.ModularReversible.TableData2DLoadDep |
Refactored with two separate connectors for HW and CHW temperature setpoints. This is for #4507. |
| Buildings.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.BaseClasses.TableData2DLoadDepSHC Buildings.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.TableData2DLoadDepSHC Buildings.Fluid.HeatPumps.ModularReversible.TableData2DLoadDepSHC |
Refactored with two separate connectors for heating and cooling on/off commands. This is for #4507. |
| Buildings.Templates | |
| Buildings.Templates.Components.BaseClasses.PartialHeatPumpTableData2DLoadDep Buildings.Templates.Components.Chillers.Compression Buildings.Templates.Plants.Controls.HeatPumps.AirToWater Buildings.Templates.Plants.HeatPumps.AirToWater Buildings.Templates.Plants.HeatPumps.Components.Controls.AirToWater Buildings.Templates.Plants.HeatPumps.Components.Controls.OpenLoop |
Refactored with two separate connectors for HW and CHW temperature setpoints. This is for #4507. |
| Buildings.Templates.AirHandlersFans.Components.Controls.G36VAVMultiZone Buildings.Templates.AirHandlersFans.Components.Data.VAVMultiZoneController Buildings.Templates.AirHandlersFans.Configuration.PartialAirHandler Buildings.Templates.AirHandlersFans.Interfaces.PartialAirHandler Buildings.Templates.AirHandlersFans.Validation.VAVMultiZone |
Moved zoning parameter declarations into controller data record. This is for #4497. |
| Buildings.Templates.Components.Chillers.Compression Buildings.Templates.Components.HeatPumps.AirToWater Buildings.Templates.Components.HeatPumps.WaterToWater Buildings.Templates.Plants.HeatPumps.AirToWater Buildings.Templates.Plants.HeatPumps.Components.HeatPumpGroups.AirToWater Buildings.Templates.Plants.HeatPumps.Components.HeatRecoveryChiller |
Refactored with load-dependent 2D table data heat pump model. This is for #4152. |
| Buildings.Templates.Plants.Controls.Utilities.PIDWithEnable | Moved to Buildings.Controls.OBC.Utilities.PIDWithEnable as there were two identical implementations.
|
| Buildings.Utilities | |
| Buildings.Utilities.IO.Python_3_8 | Moved package to Buildings.Obsolete.Utilities.IO.Python_3_8
as it is replaced by Buildings.Utilities.IO.Python_3_12.This is for issue 4347. |
The following critical errors have been fixed (i.e., errors that can lead to wrong simulation results):
| Buildings.Controls.OBC.Utilities.PIDWithAutotuning | |
| Buildings.Controls.OBC.Utilities.PIDWithAutotuning.SystemIdentification.FirstOrderTimeDelay.BaseClasses.TimeConstantDelay Buildings.Controls.OBC.Utilities.PIDWithAutotuning.Relay.BaseClasses.NormalizedTimeDelay |
Add error-handling mechanism to capture negative control gains. This is for issue 4378. |
| Buildings.Templates | |
| Buildings.Templates.Plants.Controls.HeatPumps.AirToWater Buildings.Templates.Plants.Controls.StagingRotation.EquipmentAvailability |
Refactored to use "required to run" conditions in the equipment availability logic. This is for issue 4432. |
Note:
This version removes the packages
-
Buildings.Obsolete.ThermalZones.EnergyPlus_9_6_0 -
Buildings.Obsolete.Fluid.Movers.Validation -
Buildings.Obsolete.Fluid.SolarCollectors