.Buildings.UsersGuide.ReleaseNotes.Version_6_0_0 .Buildings.UsersGuide.ReleaseNotes.Version_6_0_0Version 6.0.0 is a major new release that contains various new packages, new models and improvements to existing models. The library has been tested with Dymola 2019FD01 and with JModelica (revision 12903).
The following major changes have been done:
Buildings.Controls.OBC.CDL.
The following new libraries have been added:
| Buildings.Controls.OBC.OutdoorLights | Package with outdoor lighting controllers. |
| Buildings.Controls.OBC.Shade | Package with shade controllers. |
| Buildings.Controls.OBC.UnitConversions | Package with blocks for unit conversion. Blocks in this package are meant to use when reading data from a building automation system, or writing data to a building automation system, that uses units that are different from the units used by Modelica. |
| Buildings.Fluid.Geothermal | Package with models for geothermal heat exchangers. This package has models for borefields with vertical boreholes, and for a single vertical borehole with a U-tube heat exchanger. The borefield models can have any geometrical configuration, and either one or two U-tube heat exchangers. |
| Buildings.Occupants | Package with occupant behavior models and functions to simulate the occupancy and the interaction of occupants with air-conditioning and heating systems, windows, blinds, and lighting in residential and office buildings. |
| Buildings.Utilities.Cryptographics | Package with a function to compute a SHA1 encrypted string. |
| Buildings.Utilities.IO.Files | Package with blocks to write CSV files, JSON files or combi time table files. |
| Buildings.Utilities.Plotters | Package with blocks that allow generating time series and scatter plots, and writing these plots to one or several html files. The plots can be deactivated based on an input signal and a time delay, for example, to plot data only while the HVAC system operates for at least 30 minutes. |
The following new components have been added to existing libraries:
| Buildings.Controls.OBC.CDL | |
| Buildings.Controls.OBC.CDL.Continuous.MultiOr | Block that outputs true boolean signal if and only if any element of the boolean input vector is true. |
| Buildings.Controls.OBC.CDL.Continuous.MatrixMin | Block that outputs vector of row- or column-wise minimum values. |
| Buildings.Controls.OBC.CDL.Continuous.MatrixMax | Block that outputs vector of row- or column-wise maximum values. |
| Buildings.Controls.OBC.CDL.Continuous.MatrixGain | Block that outputs the product of a gain matrix with the input signal vector. |
| Buildings.Controls.OBC.CDL.Discrete.MovingMean | Block that outputs the discrete moving mean of a sampled input signal. |
| Buildings.Controls.OBC.CDL.Integers.Change | Block that outputs whether its Integer input changed its value, and whether it increased or decreased. |
| Buildings.Controls.OBC.CDL.Logical.IntegerSwitch | Block that outputs one of two integer input signals based on a boolean input signal. |
| Buildings.Controls.OBC.CDL.Routing.RealExtractor | Block that extracts a scalar signal from a signal vector dependent on an Integer-valued input. |
| Buildings.Controls.OBC.CDL.Utilities.SunRiseSet | Block that outputs sunrise and sunset time for each day. |
| Buildings.Fluid | |
| Buildings.Fluid.HeatExchangers | Added Buildings.Fluid.HeatExchangers.PlateHeatExchangerEffectivenessNTU
which computes the effectiveness of a plate heat exchanger
based on design conditions and current mass flow rates.
|
| Buildings.Utilities | |
| Buildings.Utilities.Math | Added Bessel, exponential integral, factorial, falling factorial and binomial functions. |
| Buildings.Utilities.Psychrometrics.Functions.X_pTphi | Added function to compute humidity mass fraction for given pressure, temperature and relative humidity. |
The following existing components have been improved in a backward compatible way:
| Buildings.BoundaryConditions | |
| Buildings.BoundaryConditions.WeatherData.ReaderTMY3 | Updated implementation to allow for weather data file that span less than a year and cross New Year,
and for weather data files that span more than a year. This is for IBPSA, #842. |
| Buildings.Controls.OBC.CDL | |
| Buildings.Controls.OBC.CDL.Logical.Timer | Updated implementation to output accumulated time when input is true.This is for issue 1212. |
| Buildings.Controls.OBC.CDL.Logical.TrueDelay | Added parameter delayOnInit to optionally delay the initial true input.This is for issue 1346. |
| Buildings.Controls.OBC.ASHRAE.G36_PR1 | |
| Buildings.Controls.OBC.ASHRAE.G36_PR1/AHUs.SingleZone.VAV.SetPoints.OutsideAirFlow | Made input connector for occupancy conditionally removable to avoid having to set the
number of occupants as an input if there is no occupancy sensor. This is for issue 1270. |
| Buildings.Fluid | |
| Buildings.Fluid.Interfaces.ConservationEquation Buildings.Fluid.MixingVolumes.MixingVolume Buildings.Fluid.MixingVolumes.MixingVolumeMoistAir |
Changed model so that the volume is no longer fixed at compilation time. This is for issue 1411. |
| Buildings.Media | |
| Buildings.Media.Air Buildings.Media.Water Buildings.Media.Antifreeze.PropyleneGlycolWater Buildings.Media.Specialized.Air.PerfectGas |
Improved error message when temperature or mass fraction is outside the allowed range. This is for IBPSA, issue 1045. |
| Buildings.Utilities.IO.Python27 | |
| Buildings.Utilities.IO.Python27.Functions.exchange |
Refactored setting the PYTHONPATH environment variable.This is for issue 1421. |
The following existing components have been improved in a non-backward compatible way:
| Buildings.Airflow.Multizone | |
| Buildings.Airflow.Multizone.DoorDiscretizedOperable | Removed parameter CD.For Dymola, a conversion script makes this change. This is for IBPSA, #971. |
| Buildings.Airflow.Multizone.EffectiveAirLeakageArea | Removed parameters A, CD and lWet.For Dymola, a conversion script makes this change. This is for IBPSA, #932. |
| Buildings.Airflow.Multizone.MediumColumnDynamic | Removed parameter m_flow_nominal.For Dymola, a conversion script makes this change. This is for IBPSA, #970. |
| Buildings.Airflow.Multizone.Orifice | Removed parameter lWet.For Dymola, a conversion script makes this change. This is for IBPSA, #932. |
| Buildings.Airflow.Multizone.MediumColumnDynamic Buildings.Airflow.Multizone.MediumColumn Buildings.Airflow.Multizone.EffectiveAirLeakageArea Buildings.Airflow.Multizone.Orifice |
Removed parameter allowFlowReversal as this is not meaningful
for these models.For Dymola, a conversion script makes this change. This is for IBPSA, #877. |
| Buildings.BoundaryConditions | |
| Buildings.BoundaryConditions.WeatherData.BaseClasses.ConvertTime | Added new parameters needed for weather data files that span multiple years.
Models of users are not likely to be affected by this change as this model
is part of the weather data file reader that implements all required changes. This is for IBPSA, #842. |
| Buildings.Controls.OBC.ASHRAE | |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.SingleZone Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.MultiZone |
Renamed packages to
Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.SingleZone.VAV
and Buildings.Controls.OBC.ASHRAE.G36_PR1.AHUs.MultiZone.VAV,
and renamed various signals and parameters for consistency.For Dymola, a conversion script makes this change. |
| Buildings.Controls.OBC.CDL | |
| Buildings.Controls.OBC.CDL.RealExtractSignal | Changed block name from ExtractSignal.For Dymola, a conversion script makes this change. |
| Buildings.Controls.OBC.CDL.Continuous.MultiMax | Changed output variable name from yMax to y.For Dymola, a conversion script makes this change. This is for issue 1252. |
| Buildings.Controls.OBC.CDL.Continuous.MultiMin | Changed output variable name from yMin to y.For Dymola, a conversion script makes this change. This is for issue 1252. |
| Buildings.Fluid | |
| Buildings.Fluid.HeatExchangers.DryEffectivenessNTU | Renamed model to
Buildings.Fluid.HeatExchangers.DryCoilEffectivenessNTU
because the convective heat transfer coefficients are for air.For Dymola, a conversion script makes this change. Removed variable Z as it is not used.
|
| Buildings.Fluid.HeatExchangers.PlateHeatExchangerEffectivenessNTU | Removed variable Z as it is not used.
|
| Buildings.Fluid.HeatExchangers.Ground.Boreholes.BaseClasses.factorial | Renamed function to
Buildings.Utilities.Math.Functions.factorial
because it is also used by the new Geothermal package.For Dymola, a conversion script makes this change. |
| Buildings.Fluid.HeatExchangers.Ground.Boreholes | Renamed package to
Buildings.Fluid.Geothermal.Boreholes
due to the introduction of the new Geothermal package.For Dymola, a conversion script makes this change. |
| Buildings.Fluid.HeatExchangers.RadiantSlabs.BaseClasses.MassFlowRateMultiplier | Renamed model to
Buildings.Fluid.BaseClasses.MassFlowRateMultiplier
because it is also used by the new Geothermal package.For Dymola, a conversion script makes this change. |
| Buildings.Fluid.Sources.FixedBoundary | This model is now obsolete and will be removed in future releases.
The model has been renamed model to
Buildings.Obsolete.Fluid.Sources.FixedBoundary.
Use Buildings.Fluid.Sources.Boundary_pT instead.For Dymola, a conversion script makes this change. |
| Buildings.Media | |
| Buildings.Media.Refrigerants.R410A | Removed the function pressureSatLiq_T as it was not used.This is for IBPSA, #995. |
| Buildings.Utilities.Reports | |
| Buildings.Utilities.Reports.Printer Buildings.Utilities.Reports.printRealArray |
Moved Buildings.Utilities.Reports.Printer to
Buildings.Utilities.IO.Files.Printer and moved
Buildings.Utilities.Reports.printRealArray to
Buildings.Utilities.IO.Files.BaseClasses.printRealArray.For Dymola, a conversion script makes this change. This is due to the newly introduced package Buildings.Utilities.IO.Files.
|
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.Logical.Latch | Corrected implementation that causes wrong output at initial stage. This is for issue 1402. |
| Buildings.Controls.OBC.CDL.Logical.Toggle | Corrected implementation that causes wrong output at initial stage. This is for issue 1402. |
| Buildings.Fluid.Geothermal | |
| Buildings.Fluid.Geothermal.Borefields.Data.Soil.SandStone | Corrected wrong thermal properties. This is for IBPSA, #1062. |
| Buildings.Fluid.HeatExchangers | |
| Buildings.Fluid.HeatExchangers.Heater_T Buildings.Fluid.HeatExchangers.SensibleCooler_T |
Corrected missing propagation of initial conditions. This is for IBPSA, #1016. |
| Buildings.ThermalZones.Detailed | |
| Buildings.ThermalZones.Detailed.MixedAir | Propagated parameter mSenFac which
increased the thermal capacity of the room air, such as
to account for furniture.This is for issue 1405. |
| Buildings.ThermalZones.ReducedOrder | |
| Buildings.ThermalZones.ReducedOrder.RC.ThreeElements Buildings.ThermalZones.ReducedOrder.RC.FourElements |
The RC element of the roof roofRC
was flipped to have its port_b on the outside.
The resistances RRem and R
of the roof and floor have been switched
in the documentation.This is for IBPSA, #997. |
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.ASHRAE | |
| Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.OperationMode | Corrected wrong time in the documentation of the parameters. This is for issue 1409. |