Buildings.UsersGuide.ReleaseNotes

Release notes

Information

This section summarizes the changes that have been performed on the Buildings library.

• Version 8.1.1 (May 12, 2022)
• Version 8.1.0 (December 9, 2021)
• Version 8.0.0 (June 8, 2021)
• Version 7.0.2 (December 9, 2021)
• Version 7.0.1 (June 4, 2021)
• Version 7.0.0 (May 28, 2020)
• Version 6.0.0 (July 15, 2019)
• Version 5.1.0 (June 14, 2018)
• Version 5.0.1 (November 22, 2017)
• Version 5.0.0 (November 17, 2017)
• Version 4.0.0 (March 29, 2017)
• Version 3.0.0 (March 29, 2016)
• Version 2.1.0 (July 13, 2015)
• Version 2.0.0 (May 4, 2015)
• Version 1.6 build1 (June 19, 2014)
• Version 1.5 build3 (February 12, 2014)
• Version 1.5 build2 (December 13, 2013)
• Version 1.5 build1 (October 24, 2013)
• Version 1.4 build1 (May 15, 2013)
• Version 1.3 build1 (January 8, 2013)
• Version 1.2 build1 (July 26, 2012)
• Version 1.1 build1 (February 29, 2012)
• Version 1.0 build2 (December 8, 2011)
• Version 1.0 build1 (November 4, 2011)
• Version 0.12.0 (May 6, 2011)
• Version 0.11.0 (March 17, 2011)
• Version 0.10.0 (July 30, 2010)
• Version 0.9.1 (June 24, 2010)
• Version 0.9.0 (June 11, 2010)
• Version 0.8.0 (February 6, 2010)
• Version 0.7.0 (September 29, 2009)
• Version 0.6.0 (May 15, 2009)
• Version 0.5.0 (February 19, 2009)
• Version 0.4.0 (October 31, 2008)
• Version 0.3.0 (September 30, 2008)
• Version 0.2.0 (June 17, 2008)
• Version 0.1.0 (May 27, 2008)

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

Package Content

Name	Description
Version_8_1_1	Version 8.1.1
Version_8_1_0	Version 8.1.0
Version_8_0_0	Version 8.0.0
Version_7_0_2	Version 7.0.2
Version_7_0_1	Version 7.0.1
Version_7_0_0	Version 7.0.0
Version_6_0_0	Version 6.0.0
Version_5_1_0	Version 5.1.0
Version_5_0_1	Version 5.0.1
Version_5_0_0	Version 5.0.0
Version_4_0_0	Version 4.0.0
Version_3_0_0	Version 3.0.0
Version_2_1_0	Version 2.1.0
Version_2_0_0	Version 2.0.0
Version_1_6_build1	Version 1.6 build 1
Version_1_5_build3	Version 1.5 build 3
Version_1_5_build2	Version 1.5 build 2
Version_1_5_build1	Version 1.5 build 1
Version_1_4_build1	Version 1.4 build 1
Version_1_3_build1	Version 1.3 build 1
Version_1_2_build1	Version 1.2 build 1
Version_1_1_build1	Version 1.1 build 1
Version_1_0_build2	Version 1.0 build 2
Version_1_0_build1	Version 1.0 build 1
Version_0_12_0	Version 0.12.0
Version_0_11_0	Version 0.11.0
Version_0_10_0	Version 0.10.0
Version_0_9_1	Version 0.9.1
Version_0_9_0	Version 0.9.0
Version_0_8_0	Version 0.8.0
Version_0_7_0	Version 0.7.0
Version_0_6_0	Version 0.6.0
Version_0_5_0	Version 0.5.0
Version_0_4_0	Version 0.4.0
Version_0_3_0	Version 0.3.0
Version_0_2_0	Version 0.2.0
Version_0_1_0	Version 0.1.0

Buildings.UsersGuide.ReleaseNotes.Version_8_1_1

Version 8.1.1

Information

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

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

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):

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_8_1_0

Version 8.1.0

Information

The following new libraries have been added:

The following new components have been added to existing libraries:

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

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

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):

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_8_0_0

Version 8.0.0

Information

For more details, please see the release notes below.

The following new libraries have been added:

The following new components have been added to existing libraries:

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

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

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

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):

Note:

• This version also corrects a possible memory violation when reading weather data files that have very long lines, as reported in IBPSA, #1432.

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_7_0_2

Version 7.0.2

Information

The following new components have been added to existing libraries:

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

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

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):

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_7_0_1

Version 7.0.1

Information

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

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):

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_7_0_0

Version 7.0.0

Information

The following new libraries have been added:

The following new components have been added to existing libraries:

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

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

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

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):

The following components have become obsolete:

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_6_0_0

Version 6.0.0

Information

The following new libraries have been added:

The following new components have been added to existing libraries:

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

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

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

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):

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_5_1_0

Version 5.1.0

Information

The following new libraries have been added:

The following new components have been added to existing libraries:

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

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

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_5_0_1

Version 5.0.1

Information

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

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_5_0_0

Version 5.0.0

Information

The following new libraries have been added:

The following new components have been added to existing libraries:

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

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

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

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):

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_4_0_0

Version 4.0.0

Information

The following new libraries have been added:

The following new components have been added to existing libraries:

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

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

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

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):

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_3_0_0

Version 3.0.0

Information

The following new libraries have been added:

The following new components have been added to existing libraries:

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

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

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

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):

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_2_1_0

Version 2.1.0

Information

Version 2.1.0 is fully compatible with version 2.0.0. It adds the package Buildings.Fluid.FMI that provides containers for exporting thermofluid flow components as FMUs. It also updates the temperature sensor to optionally simulate heat losses, and it contains bug fixes for the trace substance sensor if used without flow reversal. Improvements have been made to various models to reduce the simulation time, and to Buildings.Examples.Tutorial.Boiler to simplify the control implementation.

The following new libraries have been added:

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

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

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):

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_2_0_0

Version 2.0.0

Information

Version 2.0.0 is a major release that contains various new packages, models and improvements.

The following major additions have been done in version 2.0:

• A CFD model that is embedded in a thermal zone has been added. This model is implemented in Buildings.ThermalZones.Detailed.CFD. The CFD model is an implementation of the Fast Fluid Dynamics code that allows three-dimensional CFD inside a thermal zone, coupled to building heat transfer, HVAC components and feedback control loops.
• A new package Buildings.Electrical has been added. This package allows studying buildings to electrical grid integration. It includes models for loads, transformers, cables, batteries, PV and wind turbines. Models exist for DC and AC systems with two- or three-phase that can be balanced and unbalanced. The models compute voltage, current, active and reactive power based on the quasi-stationary assumption or using the dynamic phasorial representation.
• The new package Buildings.Controls.DemandResponse contains models for demand response simulation.
• The new package Buildings.Controls.Predictors contains a data-driven model that predicts the electrical load of a building. The prediction can be done either using an average baseline or a linear regression with respect to outside temperature. For both, optionally a day-of adjustment can be made.

The tables below give more detailed information to the revisions of this library compared to the previous release 1.6 build 1.

The following new libraries have been added:

The following new components have been added to existing libraries:

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

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

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

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):

Note:

With version 2.0, we start using semantic versioning as described at http://semver.org/.

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_1_6_build1

Version 1.6 build 1

Information

Version 1.6 build 1 updates the Buildings library to the Modelica Standard Library 3.2.1 and to Modelica_StateGraph2 2.0.2.

This is the first version of the Buildings library that contains models from the IEA EBC Annex 60 library, a Modelica library for building and community energy systems that is collaboratively developed within the project "New generation computational tools for building and community energy systems based on the Modelica and Functional Mockup Interface standards", a project that is conducted under the Energy in Buildings and Communities Programme (EBC) of the International Energy Agency (IEA).

The following new components have been added to existing libraries:

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

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

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

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):

The followings issues have been fixed:

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_1_5_build3

Version 1.5 build 3

Information

Version 1.5 build 3 is a maintenance release that corrects an error in Buildings.Fluid.MassExchangers.HumidifierPrescribed. It is fully compatible with version 1.5 build 2.

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

The following issues have been fixed:

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_1_5_build2

Version 1.5 build 2

Information

Version 1.5 build 2 is a maintenance release that corrects an error in Buildings.Fluid.HeatExchangers.DryCoilDiscretized and in Buildings.Fluid.HeatExchangers.WetCoilDiscretized. It is fully compatible with version 1.5 build 1.

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

The following issues have been fixed:

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_1_5_build1

Version 1.5 build 1

Information

Version 1.5 build 1 is a major release that contains new packages with models for solar collectors and for the Facility for Low Energy Experiments (FLEXLAB) at the Lawrence Berkeley National Laboratory.

This release also contains a major revision of all info sections to correct invalid html syntax. The package Buildings.HeatTransfer.Radiosity has been revised to comply with the Modelica language specification. The package Buildings.ThermalZones.Detailed has been revised to aid implementation of non-uniformly mixed room air models. This release also contains various corrections that avoid warnings during translation when used with Modelica 3.2.1. Various models have been revised to increase compatibility with OpenModelica. However, currently only a subset of the models work with OpenModelica.

The following new libraries have been added:

The following new components have been added to existing libraries:

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

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

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

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):

The following issues have been fixed:

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_1_4_build1

Version 1.4 build 1

Information

Version 1.4 build 1 contains the new package Buildings.Utilities.IO.Python27 that allows calling Python functions from Modelica. It also contains in the package Buildings.HeatTransfer.Conduction.SingleLayer a new model for heat conduction in phase change material. This model can be used as a layer of the room heat transfer model.

Non-backward compatible changes had to be introduced in the valve models Buildings.Fluid.Actuators.Valves to fully comply with the Modelica language specification, and in the models in the package Buildings.Utilities.Diagnostics as they used the cardinality function which is deprecated in the Modelica Language Specification.

See below for details.

The following new libraries have been added:

The following new components have been added to existing libraries:

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

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

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

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):

The following issues have been fixed:

TSup = TRoo_in_internal
          + ((TSup_nominal+TRet_nominal)/2-TRoo_in_internal) * qRel^(1/m)
          + (TSup_nominal-TRet_nominal)/2 * qRel;

TSup = TRoo_in_internal
          + ((TSup_nominal+TRet_nominal)/2-TRoo_nominal) * qRel^(1/m)
          + (TSup_nominal-TRet_nominal)/2 * qRel;

Note:

• This version contains various updates that allow the syntax of the example models to be checked in the pedantic mode in Dymola 2014.

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_1_3_build1

Version 1.3 build 1

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:

The following new components have been added to existing libraries:

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

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

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

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):

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_1_2_build1

Version 1.2 build 1

Information

In version 1.2 build 1, models for radiant slabs and window overhangs and sidefins have been added. This version also contains various improvements to existing models. A detailed list of changes is shown below.

The following new libraries have been added:

The following new components have been added to existing libraries:

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

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

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

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):

The following issues have been fixed:

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_1_1_build1

Version 1.1 build 1

Information

Version 1.1 build 1 contains improvements to models that address numerical problems. In particular, flow machines and actuators now have an optional filter that converts step changes in the input signal to a smooth change in speed or actuator position. Also, (Buildings.Examples.Tutorial) has been added to provide step-by-step instruction for how to build system models.

The following new libraries have been added:

The following new components have been added to existing libraries:

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

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

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

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):

The following issues have been fixed:

Note:

• The use of filters for actuator and flow machine input signals changes the dynamic response of feedback control loops. Therefore, control gains may need to be retuned. See Buildings.Fluid.Actuators.UsersGuide and Buildings.Fluid.Movers.UsersGuide for recommended control gains and further details.

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_1_0_build2

Version 1.0 build 2

Information

Version 1.0 build 2 has been released to correct model errors that were present in version 1.0 build 1. Both versions are compatible. In addition, version 1.0 build 2 contains improved documentation of various example models.

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

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

The following issues have been fixed:

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_1_0_build1

Version 1.0 build 1

Information

Version 1.0 is the first official release of the Buildings library. Compared to the last pre-release, which is version 0.12, this version contains new models as well as significant improvements to the model formulation that leads to faster and more robust simulation. A detailed list of changes is shown below.

Version 1.0 is not backward compatible to version 0.12, i.e., models developed with versions 0.12 will require some changes in their parameters to work with version 1.0. The conversion script Buildings/Resources/Scripts/Dymola/ConvertBuildings_from_0.12_to_1.0.mos can help in converting old models to this version of the library.

The following new libraries have been added:

The following new components have been added to existing libraries:

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

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

 pressure(V_flow_nominal={0,V_flow_nominal,2*V_flow_nominal},
          dp_nominal={2*dp_nominal,dp_nominal,0})

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

The following uncritical errors have been fixed (i.e., errors that do not lead to wrong simulation results, but, e.g., units are wrong or errors in documentation):

The following issues have been fixed:

Note:

• The version number scheme has been changed. It is now identical to the one used by the Modelica Standard Library. Versions are identified with two numbers x.y and a build number. The first official release of each version has the build number 1. For each released bug fix, the build number is incremented. See Modelica.UsersGuide.ReleaseNotes.VersionManagement for details.
• To allow adding scripts for multiple simulation environments, all scripts have been moved to the directory Buildings/Resources/Scripts/Dymola and the annotation that generates the entry in the Command pull down menu has been changed to __Dymola_Commands(file=...)

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_0_12_0

Version 0.12.0

Information

Note: The packages whose name ends with Beta are still being validated.

The following critical error has been fixed (i.e. error that can lead to wrong simulation results):

The following improvements and additions have been made:

• Updated library to Modelica 3.2.
• Added homotopy operator.
• Restructured package Buildings.HeatTransfer.
• Rewrote the models in Buildings.Fluid.Actuators to avoid having the flow coefficient k as an algebraic variable. This increases robustness.
• Rewrote energy, species and trace substance balance in Buildings.Fluid.Interfaces.StaticTwoPortHeatMassExchanger to better handle zero mass flow rate.
• Implemented functions enthalpyOfCondensingGas and saturationPressure in single substance media to allow use of the room model with media that do not contain water vapor.
• Revised Buildings.Fluid.Sources.Outside to allow use of the room model with media that do not contain water vapor.

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_0_11_0

Version 0.11.0

Information

Note: The packages whose name ends with Beta are still being validated.

• Added the package Buildings.ThermalZones.Detailed to compute heat transfer in rooms and through the building envelope. Multiple instances of these models can be connected to create a multi-zone building model.
• Added the package Buildings.HeatTransfer.Windows to compute heat transfer (solar radiation, infrared radiation, convection and conduction) through glazing systems.
• In package Buildings.Fluid.Chillers, added the chiller models Buildings.Fluid.Chillers.ElectricReformulatedEIR and Buildings.Fluid.Cphillers.ElectricEIR, and added the package Buildings.Fluid.Chillers.Data that contains data sets of chiller performance data.
• Added package Buildings.BoundaryConditions with models to compute boundary conditions, such as solar irradiation and sky temperature.
• Added package Buildings.Utilities.IO.WeatherData with models to read weather data in the TMY3 format.
• Revised the package Buildings.Fluid.Sensors.
• Revised the package Buildings.Fluid.HeatExchangers.CoolingTowers.
• In Buildings.Fluid.Interfaces.StaticFourPortHeatMassExchanger and Buildings.Fluid.Interfaces.StaticFourPortHeatMassExchanger, fixed bug in energy and moisture balance that affected results if a component adds or removes moisture to the air stream. In the old implementation, the enthalpy and species outflow at port_b was multiplied with the mass flow rate at port_a. The old implementation led to small errors that were proportional to the amount of moisture change. For example, if the moisture added by the component was 0.005 kg/kg, then the error was 0.5%. Also, the results for forward flow and reverse flow differed by this amount. With the new implementation, the energy and moisture balance is exact.
• In Buildings.Fluid.Interfaces.ConservationEquation and in Buildings.Media.Interfaces.PartialSimpleMedium, set nominal attribute for medium to provide consistent normalization. Without this change, Dymola 7.4 uses different values for the nominal attribute based on the value of Advanced.OutputModelicaCodeWithJacobians=true/false; in the model Buildings.Examples.HydronicHeating.
• Fixed bug in energy balance of Buildings.Fluid.Chillers.Carnot.
• Fixed bug in efficiency curves in package Buildings.Fluid.Movers.BaseClasses.Characteristics.

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_0_10_0

Version 0.10.0

Information

• Added package Buildings.Airflow.Multizone with models for multizone airflow and contaminant transport.
• Added the model Buildings.Utilities.Comfort.Fanger for thermal comfort calculations.
• Rewrote Buildings.Fluid.Storage.BaseClasses.ThirdOrderStratifier, which is used in Buildings.Fluid.Storage.StratifiedEnhanced, to avoid state events when the flow reverses. This leads to faster and more robust simulation.
• In models of package Buildings.Fluid.MixingVolumes, added nominal value for mC to avoid wrong trajectory when concentration is around 1E-7. See also https://trac.modelica.org/Modelica/ticket/393.
• Fixed bug in fan and pump models that led to too small an enthalpy increase across the flow device.
• In model Buildings.Fluid.Movers.FlowControlled_dp, changed assert(dp_in ≥ 0, ...) to assert(dp_in ≥ -0.1, ...). The former implementation triggered the assert if dp_in was solved for in a nonlinear equation since the solution can be slightly negative while still being within the solver tolerance.
• Added model Buildings.Controls.SetPoints.Table that allows the specification of a floating setpoint using a table of values.
• Revised model Buildings.Fluid.HeatExchangers.Radiators.RadiatorEN442_2. The new version has exactly the same nominal power during the simulation as specified by the parameters. This also required a change in the parameters.

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_0_9_1

Version 0.9.1

Information

The following critical error has been fixed (i.e. error that can lead to wrong simulation results):

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_0_9_0

Version 0.9.0

Information

• Added the following heat exchanger models
  • Buildings.Fluid.HeatExchangers.DryEffectivenessNTU for a sensible heat exchanger that uses the epsilon-NTU relations to compute the heat transfer.
  • Buildings.Fluid.HeatExchangers.DryCoilCounterFlow and Buildings.Fluid.HeatExchangers.WetCoilCounterFlow to model a coil without and with water vapor condensation. These models approximate the coil as a counterflow heat exchanger.
• Revised air damper Buildings.Fluid.Actuators.BaseClasses.exponentialDamper. The new implementation avoids warnings and leads to faster convergence since the solver does not attempt anymore to solve for a variable that needs to be strictly positive.
• Revised package Buildings.Fluid.Movers to allow zero flow for some pump or fan models. If the input to the model is the control signal y, then the flow is equal to zero if y=0. This change required rewriting the package to avoid division by the rotational speed.
• Revised package Buildings.HeatTransfer to include a model for a multi-layer construction, and to allow individual material layers to be computed steady-state or transient.
• In package Buildings.Fluid, changed models so that if the parameter dp_nominal is set to zero, then the pressure drop equation is removed. This allows, for example, to model a heating and a cooling coil in series, and lump there pressure drops into a single element, thereby reducing the dimension of the nonlinear system of equations.
• Added model Buildings.Controls.Continuous.LimPID, which is identical to Modelica.Blocks.Continuous.LimPID, except that it allows reverse control action. This simplifies use of the controller for cooling applications.
• Added model Buildings.Fluid.Actuators.Dampers.MixingBox for an outside air mixing box with air dampers.
• Changed implementation of flow resistance in Buildings.Fluid.Actuators.Dampers.MixingBoxMinimumFlow. Instead of using a fixed resistance and a damper model in series, only one model is used that internally adds these two resistances. This leads to smaller systems of nonlinear equations.
• Changed Buildings.Media.PerfectGases.MoistAir.T_phX (and by inheritance all other moist air medium models) to first compute T in closed form assuming no saturation. Then, a check is done to determine whether the state is in the fog region. If the state is in the fog region, then Internal.solve is called. This new implementation can lead to significantly shorter computing time in models that frequently call T_phX.
• Added package Buildings.Media.GasesConstantDensity which contains medium models for dry air and moist air. The use of a constant density avoids having pressure as a state variable in mixing volumes. Hence, fast transients introduced by a change in pressure are avoided. The drawback is that the dimensionality of the coupled nonlinear equation system is typically larger for flow networks.
• In Buildings.Fluid.Actuators.BaseClasses.PartialDamperExponential, added default value for parameter A to avoid compilation error if the parameter is disabled but not specified.
• Simplified the mixing volumes in Buildings.Fluid.MixingVolumes by removing the port velocity, pressure drop and height.

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_0_8_0

Version 0.8.0

Information

• In Buildings.Fluid.Interfaces.ConservationEquation, added to Medium.BaseProperties the initialization X(start=X_start[1:Medium.nX]). Previously, the initialization was only done for Xi but not for X, which caused the medium to be initialized to reference_X, ignoring the value of X_start.
• Renamed Buildings.Media.PerfectGases.MoistAirNonSaturated to Buildings.Media.PerfectGases.MoistAirUnsaturated and Buildings.Media.GasesPTDecoupled.MoistAirNoLiquid to Buildings.Media.Air, and added assert statements if saturation occurs.
• Added regularizaation near zero flow to Buildings.Fluid.HeatExchangers.ConstantEffectiveness and Buildings.Fluid.MassExchangers.ConstantEffectiveness.
• Fixed bug regarding temperature offset in Buildings.Media.PerfectGases.MoistAirUnsaturated.T_phX.
• Added implementation of function Buildings.Media.Air.enthalpyOfNonCondensingGas and its derivative.
• In Buildings.Media.PerfectGases.MoistAir, fixed bug in implementation of Buildings.Media.PerfectGases.MoistAir.T_phX. In the previous version, it computed the inverse of its parent class, which gave slightly different results.
• In Buildings.Utilities.IO.BCVTB.BCVTB, added parameter to specify the value to be sent to the BCVTB at the first data exchange, and added parameter that deactivates the interface. Deactivating the interface is sometimes useful during debugging.
• In Buildings.Media.GasesPTDecoupled.MoistAir and in Buildings.Media.PerfectGases.MoistAir, added function enthalpyOfNonCondensingGas and its derivative.
• In Buildings.Media, fixed bug in implementations of derivatives.
• Added model Buildings.Fluid.Storage.ExpansionVessel.
• Added Wrapper function Buildings.Fluid.Movers.BaseClasses.Characteristics.solve for Modelica.Math.Matrices.solve. This is currently needed since Modelica.Math.Matrices.solve does not specify a derivative.
• Fixed bug in Buildings.Fluid.Storage.Stratified. In the previous version, for computing the heat conduction between the top (or bottom) segment and the outside, the whole thickness of the water volume was used instead of only half the thickness.
• In Buildings.Media.ConstantPropertyLiquidWater, added the option to specify a compressibility. This can help reducing the size of the coupled nonlinear system of equations, at the expense of introducing stiffness. This change required to change the inheritance tree of the medium. Its base class is now Buildings.Media.Interfaces.PartialSimpleMedium, which contains the equation for the compressibility. The default setting will model the flow as incompressible.
• In Buildings.Controls.Continuous.Examples.PIDHysteresis and Buildings.Controls.Continuous.Examples.PIDHysteresisTimer, fixed error in default parameter eOn. Fixed error by introducing parameter Td, which used to be hard-wired in the PID controller.
• Added more models for fans and pumps to the package Buildings.Fluid.Movers. The models are similar to the ones in Modelica.Fluid.Machines but have been adapted for air-based systems, and to include more characteristic curves in Buildings.Fluid.Movers.BaseClasses.Characteristics. The new models are better suited than the existing fan model Buildings.Fluid.Movers.FlowMachinePolynomial for zero flow rate.
• Added an optional mixing volume to Buildings.Fluid.BaseClasses.PartialThreeWayResistance and hence to the flow splitter and to the three-way valves. This often breaks algebraic loops and provides a state for the temperature if the mass flow rate goes to zero.

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_0_7_0

Version 0.7.0

Information

• Updated library from Modelica_Fluid to Modelica.Fluid 1.0
• Merged sensor and source models from Modelica.Fluid to Buildings.Fluid.
• Added sensor for sensible and latent enthalpy flow rate, Buildings.Fluid.Sensors.SensibleEnthalpyFlowRate and Buildings.Fluid.Sensors.LatentEnthalpyFlowRate. These sensors are needed, for example, to interface air-conditioning systems that are modeled with Modelica with the Building Controls Virtual Test Bed.

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_0_6_0

Version 0.6.0

Information

• Added the package Buildings.Utilities.IO.BCVTB which contains an interface to the Building Controls Virtual Test Bed.
• Updated license to Modelica License 2.
• Replaced Buildings.Utilities.Psychrometrics.HumidityRatioPressure by Buildings.Utilities.Psychrometrics.HumidityRatio_pWat and Buildings.Utilities.Psychrometrics.VaporPressure_X because the old model used RealInput ports, which are obsolete in Modelica 3.0.
• Changed the base class Buildings.Fluid.Interfaces.StaticTwoPortHeatMassExchanger to enable computation of pressure drop of mechanical equipment.
• Introduced package Buildings.Fluid.BaseClasses.FlowModels to model pressure drop, and rewrote Buildings.Fluid.BaseClasses.PartialResistance.
• Redesigned package Buildings.Utilities.Math to allow having blocks and functions with the same name. Functions are now in Buildings.Utilities.Math.Functions.
• Fixed sign error in Buildings.Fluid.Storage.BaseClasses.Stratifier which caused a wrong energy balance in Buildings.Fluid.Storage.StratifiedEnhanced.
• Renamed Buildings.Fluid.HeatExchangers.HeaterCoolerIdeal to Buildings.Fluid.HeatExchangers.HeaterCoolerPrescribed to have the same nomenclatures as is used for Buildings.Fluid.MassExchangers.HumidifierPrescribed
• In Buildings.Fluid/Actuators/BaseClasses/PartialDamperExponential, added option to compute linearization near zero based on the fraction of nominal flow instead of the Reynolds number. This was set as the default, as it leads most reliably to a model parametrization that leads to a derivative d m_flow/d p near the origin that is not too steep for a Newton-based solver.
• In damper and VAV box models, added optional parameters to allow specifying the nominal face velocity instead of the area.
• Set nominal attribute for pressure drop dp in Buildings.Fluid.BaseClasses.PartialResistance and in its child classes.
• Added models for chiller (Buildings.Fluid.Chillers.Carnot), for occupancy (Buildings.Controls.SetPoints.OccupancySchedule) and for blocks that take a vector as an argument (Buildings.Utilities.Math.Min, Buildings.Utilities.Math.Max, and Buildings.Utilities.Math.Average).
• Changed various variable names to be consistent with naming convention used in Modelica.Fluid 1.0.

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_0_5_0

Version 0.5.0

Information

• Updated library to Modelica.Fluid 1.0.
• Moved most examples from package Buildings.Fluid.Examples to the example directory in the package of the individual model.
• Renamed package Buildings.Utilites.Controls to Buildings.Utilites.Diagnostics.
• Introduced packages Buildings.Controls, Buildings.HeatTransfer (which contains models for heat transfer that generally does not involve modeling of the fluid flow), Buildings.Fluid.Boilers and Buildings.Fluid.HeatExchangers.Radiators.
• Changed valve models in Buildings.Fluid.Actuators.Valves so that Kv or Cv can be used as the flow coefficient (in [m3/h] or [USG/min]).

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_0_4_0

Version 0.4.0

Information

• Added package Buildings.Fluid.Storage with models for thermal energy storage.
• Added a steady-state model for a heat and moisture exchanger with constant effectiveness. See Buildings.Fluid.MassExchangers.ConstantEffectiveness
• Added package Buildings.Utilities.Reports. The package contains models that facilitate reporting.

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_0_3_0

Version 0.3.0

Information

• Added package Buildings.Fluid.Sources. The package contains models for modeling species that do not affect the medium balance of volumes. This can be used to track for example carbon dioxide or other species that have a small concentration.
• The package Buildings.Fluid.Actuators.Motors has been added. The package contains a motor model for valves and dampers.
• The package Buildings.Media has been reorganized and the new medium model Buildings.Media.GasesPTDecoupled.MoistAir has been added.
  In addition, this package now contains a bug fix that is needed for Modelica 2.2.1 and 2.2.2. The bugs are fixed by using a new base class Buildings.Media.Interfaces.PartialSimpleIdealGasMedium (that fixes the bugs) instead of Modelica.Media.Interfaces.PartialSimpleIdealGasMedium. In the original implementation, initial states of fluid volumes can be far away from the steady-state value because of an inconsistent implementation of the enthalpy and internal energy. When the Buildings library is upgraded to to Modelica 3.0.0, it should be safe to remove this bug fix.
• The package Buildings.Fluid.HeatExchangers has been revised and several models have been renamed. The heat exchanger models have been revised to allow computing the fluid volumes either dynamically, or in steady-state.
• The damper with exponential opening characteristic has been revised to allow control signals over the whole range between 0 and 1. This was in earlier versions restricted. In the same model, a bug was fixed that caused the flow to be largest for y=0, i.e., when the damper is closed.
• Additional models for psychrometric equations have been added. The new models contain equations that convert dew point temperature and water vapor pressure, as well as water vapor concentration and water vapor pressure.
• A new mixing volume has been added that allows latent heat exchange with the volume. This model can be used to model a volume of moist air with water vapor condensation inside the volume. The condensate is removed from the volume in its liquid phase.

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_0_2_0

Version 0.2.0

Information

New in this version are models for two and three way valves. In addition, the Fluids package has been slightly revised. The package Fluid.BaseClasses has been added because in the previous version, partial models for fixed resistances where part of the Actuator package.

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

Modelica definition

Buildings.UsersGuide.ReleaseNotes.Version_0_1_0

Version 0.1.0

Information

First release of the library.

This version contains basic models for modeling building HVAC systems. It also contains new medium models in the package Buildings.Media. These medium models have simpler property functions than the ones from Modelica.Media. For example, there is medium model with constant heat capacity which is often sufficiently accurate for building HVAC simulation, in contrast to the more detailed models from Modelica.Media that are valid in a larger temperature range, at the expense of introducing non-linearities due to the medium properties.

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

Modelica definition