.Buildings.UsersGuide.ReleaseNotes.Version_1_3_build1

Information

In version 1.3 build 1, models for direct evaporative cooling coils with multiple stages or with a variable speed compressor have been added. This version also contains improvements to the fan and pump models to better treat zero mass flow rate. Various other improvements have been made to improve the numerics and to use consistent variable names. A detailed list of changes is shown below.

The following new libraries have been added:

Buildings.Fluid.DXSystems Library with direct evaporative cooling coils.

The following new components have been added to existing libraries:

Buildings.Examples
Buildings.Examples.ChillerPlant.DataCenterContinuousTimeControl Added chilled water plant model with continuous time control that replaces the discrete time control in Buildings.Examples.ChillerPlant.DataCenterDiscreteTimeControl.
Buildings.Utilities
Buildings.Utilities.Psychrometrics.Functions.X_pSatpphi Function that computes moisture concentration based on saturation pressure, total pressure and relative humidity.
Buildings.Utilities.Psychrometrics.TWetBul_TDryBulPhi Block that computes the wet bulb temperature for given dry bulb temperature, relative humidity and atmospheric pressure.
Buildings.Utilities.Psychrometrics.WetBul_pTX Block that computes the temperature and mass fraction at the wet bulb state for given dry bulb temperature, species concentration and atmospheric pressure.

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

Buildings.BoundaryConditions
Buildings.BoundaryConditions.WeatherData.ReaderTMY3 Added computation of the wet bulb temperature. Computing the wet bulb temperature introduces a nonlinear equation. As we have not observed an increase in computing time because of computing the wet bulb temperature, it is computed by default. By setting the parameter computeWetBulbTemperature=false, the computation of the wet bulb temperature can be removed.
Buildings.Controls
Buildings.Controls.SetPoints.OccupancySchedule Added pre operator and relaxed tolerance in assert statement.
Buildings.Fluid
Buildings.Fluid.Movers.FlowControlled_dp
Buildings.Fluid.Movers.FlowControlled_m_flow
Buildings.Fluid.Movers.SpeedControlled_Nrpm
Buildings.Fluid.Movers.SpeedControlled_y
Reformulated implementation of efficiency model to avoid a division by zero at zero mass flow rate for models in which a user specifies a power instead of an efficiency performance curve.
Buildings.Utilities
Buildings.Utilities.Psychrometrics.TWetBul_TDryBulXi Added option to approximate the wet bulb temperature using an explicit equation. Reformulated the original model to change the dimension of the nonlinear system of equations from two to one.

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

Buildings.BoundaryConditions
Buildings.BoundaryConditions.WeatherData.ReaderTMY3
Buildings.BoundaryConditions.Types
Improved the optional inputs for the radiation data global horizontal, diffuse horizontal and direct normal radiation. If a user specifies two of them, the third will be automatically calculated.
Buildings.BoundaryConditions.SkyTemperature.BlackBody Renamed radHor to radHorIR to indicate that the radiation is in the infrared spectrum.
Buildings.Fluid
Buildings.Airflow.Multizone.BaseClasses.DoorDiscretized
Buildings.Airflow.Multizone.DoorDiscretizedOpen
Buildings.Airflow.Multizone.DoorDiscretizedOperable
Buildings.Airflow.Multizone.Orifice
Buildings.Airflow.Multizone.ZonalFlow_ACS
Buildings.Fluid.Actuators.BaseClasses.PartialDamperExponential
Buildings.Fluid.Actuators.Dampers.MixingBox
Buildings.Fluid.Actuators.Dampers.VAVBoxExponential
Buildings.Fluid.BaseClasses.PartialResistance
Buildings.Fluid.Interfaces.TwoPortHeatMassExchanger
Buildings.Fluid.Movers.BaseClasses.PowerInterface
Buildings.Fluid.Storage.BaseClasses.Buoyancy
Buildings.Fluid.HeatExchangers.BaseClasses.MassExchange
Renamed protected parameters for consistency with the naming conventions. In previous releases, fluid properties had the suffix 0 or _nominal instead of _default when they where computed based on the medium default properties.
Buildings.Fluid.Sensors.SensibleEnthalpyFlowRate
Buildings.Fluid.Sensors.LatentEnthalpyFlowRate
Moved computation of parameter i_w to new base class Buildings.Fluid.BaseClasses.IndexWater The value of this parameter is now assigned dynamically and does not require to be specified by the user.
Buildings.Fluid.Storage.BaseClasses.ThirdOrderStratifier Removed unused protected parameters sta0 and cp0.
Buildings.Examples
Buildings.Examples.ChillerPlant.DataCenterDiscreteTimeControl
Buildings.Examples.ChillerPlant.BaseClasses.Controls.TrimAndRespond
Buildings.Examples.ChillerPlant.BaseClasses.Controls.ZeroOrderHold
Re-implemented the controls for setpoint reset. Revised the model TrimAndRespond and deleted the model ZeroOrderHold. Improved the documentation.

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

Buildings.Examples
Buildings.Examples.ChillerPlant.DataCenterDiscreteTimeControl Fixed error in wet bulb temperature. The previous version used a model to compute the wet bulb temperature that takes as an input the relative humidity, but required mass fraction as an input.

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.BoundaryConditions
Buildings.BoundaryConditions.WeatherData.ReaderTMY3
Buildings.BoundaryConditions.SkyTemperature.BlackBody
Renamed radHor to radHorIR.
Buildings.Fluid
Buildings.Fluid.BaseClasses.FlowModels.Examples.InverseFlowFunction Fixed error in the documentation.
Buildings.Fluid.Interfaces.TwoPortHeatMassExchanger Fixed broken link in the documentation.
Buildings.Fluid.Movers.BaseClasses.Characteristics.powerParameters Fixed wrong displayUnit and max attribute for power.
Buildings.Fluid.MixingVolumes In documentation, removed reference to the parameter use_HeatTransfer which no longer exists.
Buildings.HeatTransfer
Buildings.HeatTransfer.Windows.Functions.glassPropertyUncoated Improved the documentation for implementation and added comments for model limitations.

Generated at 2024-11-22T19:25:38Z by OpenModelicaOpenModelica 1.24.2 using GenerateDoc.mos