.Buildings.UsersGuide.ReleaseNotes.Version_12_1_0

Version 12.1.0

Information

Version 12.1.0 is backward compatible with 12.0.0.

The library has been tested with Dymola 2025x, OpenModelica 1.24.0, OPTIMICA 1.55.11 and recent versions of Impact.

This backward compatible version adds a new package with an autotuning PID controller.

Also, many models have been updated to improve performance, to ensure compliance with the Modelica Language Standard and to correct model errors.

The following new libraries have been added:

Buildings.Controls.OBC.Utilities.PIDWithAutotuning Package that contains an autotuning PID controller.

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

Buildings.Electrical
Buildings.Electrical.BaseClasses.WindTurbine.PartialWindTurbine Changed model to avoid a rounding error that occurs due to the revised definition of eps in the development version of the Modelica Standard Library 4.1.0.
This is for IBPSA, #1996.
Buildings.Fluid.Chillers
Buildings.Fluid.Chillers.ModularReversible.Modular Added assertion to avoid wrong parameter definition for reference temperatures in reverse operation mode. Improved parameter documentation.
This is for IBPSA, #2013.
Buildings.Fluid.Geothermal
Buildings.Utilities.Clustering.KMeans Improved code to avoid an error during initialization of certain borefield geometries.
This is for IBPSA, #1985 and IBPSA, #1976.
Buildings.Fluid.HeatPumps
Buildings.Fluid.HeatPumps.ModularReversible.Modular Added assertion to avoid wrong parameter definition for reference temperatures in reverse operation mode. Improved parameter documentation.
This is for IBPSA, #2013.
Buildings.HeatTransfer
Buildings.HeatTransfer.Conduction.BaseClasses.der_temperature_u Reformulated model to avoid warning about binding equation not being a parameter expression.
This is for #4215.
Buildings.Templates
Buildings.Templates.Components.Actuators.Damper
Buildings.Templates.Components.Actuators.Valve
Buildings.Templates.Plants.HeatPumps.Components.ValvesIsolation
Replaced direct fluid pass-through with fixed resistance in actuator components.
This is for #4227.
Buildings.ThermalZones.EnergyPlus_24_2_0
Buildings.ThermalZones.EnergyPlus_24_2_0 Updated the FMI library to version 3.0.3.
This is for #4189.
Buildings.Obsolete.ThermalZones.EnergyPlus_9_6_0
Buildings.Obsolete.ThermalZones.EnergyPlus_9_6_0 Updated the FMI library to version 3.0.3.
This is for #4189.
Buildings.Utilities
Buildings.Utilities.Clustering.KMeans Improved code to avoid an error during initialization of certain borefield geometries.
This is for IBPSA, #1985 and IBPSA, #1976.

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

Buildings.Fluid.Chillers
IBPSA.Fluid.Chillers.ModularReversible.Controls.Safety Corrected error that lead to the equipment safety counter to be increased, for example due to minimum flow rate, even if the compressor signal ySet is zero.
This is for IBPSA, #2011.
Buildings.Fluid.HeatExchanger
Buildings.Fluid.HeatExchanger.CoolingTowers.Merkel Corrected computation of nominal UA value, which did not include the correction for the latent heat in the design airflow calculation.
This is for #4189.
Buildings.Fluid.HeatPumps
IBPSA.Fluid.HeatPumps.ModularReversible.Controls.Safety Corrected error that lead to the equipment safety counter to be increased, for example due to minimum flow rate, even if the compressor signal ySet is zero.
This is for IBPSA, #2011.
IBPSA.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.Frosting Corrected unit error that led to wrong calculation of COP degradation due to frost building. Disabled the model unless air is used on the evaporator side.
This is for IBPSA, #1975.

Generated at 2025-06-06T18:20:43Z by OpenModelicaOpenModelica 1.25.0 using GenerateDoc.mos