From dff251c2a154412386ce4dab02a1631766b4ad23 Mon Sep 17 00:00:00 2001
From: Michael Wetter
Date: Sat, 28 May 2022 04:01:07 -0700
Subject: [PATCH] Issue3046 - Update release notes for 9.0.0 (#3050)
* Added release information for version 9.0.0
* Updated date
* Added 8.1.3 release notes
---
Buildings/package.mo | 195 +++++++++++++++++++++++++++++++++++++++----
README.md | 2 +-
2 files changed, 180 insertions(+), 17 deletions(-)
diff --git a/Buildings/package.mo b/Buildings/package.mo
index b5fb20b8671..0936e0bee63 100644
--- a/Buildings/package.mo
+++ b/Buildings/package.mo
@@ -208,16 +208,66 @@ Each class (i.e., model, block and function) must be used in an example or valid
annotation (Documentation(info="
-Version 9.0.0 is ... xxx
+Version 9.0.0 is a major release that updates the Modelica version from 3.2.3 to 4.0.0.
-This release updates the Modelica version from 3.2.3 to 4.0.0.
+The library has been tested with Dymola 2022x,
+OpenModelica 1.19.0-dev (613-gd6e04c0-1),
+OPTIMICA (revision 2022-05-09-master-4b0cd2bf71) and recent versions of Impact.
-This release also updates almost all fluid component models to remove the parameter massDynamics
,
-which is now set to the same value as the parameter energyDynamics
. This simplifies use of the models.
-A conversion script will update this setting when updating from Buildings 8 to 9.
+The following major changes have been done:
+
+-
+The Modelica version has been updated from version 3.2.3 to 4.0.0.
+
+-
+Most fluid component models have been updated to remove the parameter
massDynamics
,
+which is now set to the same value as the parameter energyDynamics
.
+
+-
+The models for coupling with EnergyPlus have been moved to the package
+
Buildings.ThermalZones.EnergyPlus_9_6_0
to allow
+support for more than one EnergyPlus version
+in future releases.
+
+-
+The BESTEST validation in the package
+
Buildings.ThermalZones.Detailed.Validation.BESTEST
+has been updated to the latest BESTEST version, and new tests have been added.
+
+-
+The package
Buildings.Fluid.Geothermal.BuriedPipes
+has been added to model heat transfer between buried pipes and the ground,
+such as for district energy systems.
+
+-
+The package
Buildings.Media.Steam
for modeling steam has been added.
+
+-
+Various new models have been added to the package
Buildings.Airflow.Multizone
+for modeling multizone air exchange.
+
+-
+Models for ice tanks have been added to the package
+
Buildings.Fluid.Storage.Ice
.
+
+-
+Various models, such as for PV, solar collectors and thermal zones have been
+improved to obtain the latitude of the building from the weather data bus,
+rather than requiring the user to specify it.
+
+-
+The run-time coupling with Python has been updated to Python version 3.8,
+and it has been renamed to
Buildings.Utilities.IO.Python_3_8
.
+
+-
+Various other models have been improved or added, in particular for modeling of
+control sequences using the Control Description Language that has been developed
+in the OpenBuildingControl project at https://obc.lbl.gov.
+
+
@@ -1217,18 +1267,125 @@ units are wrong or errors in documentation):
+"));
+ end Version_9_0_0;
+
+
+ class Version_8_1_3 "Version 8.1.3"
+ extends Modelica.Icons.ReleaseNotes;
+ annotation (Documentation(info="
+
-Note:
+Version 8.1.3 is a patch that has backward compatible bug fixes.
+It is backwards compatible with versions 8.0.0, 8.1.0, 8.1.1 and 8.1.2.
-
+
+The library has been tested with Dymola 2022,
+JModelica (revision 14023),
+OpenModelica 1.19.0-dev (449+g4f16e6af22),
+OPTIMICA (revision OCT-dev-r26446_JM-r14295) and recent versions of Impact.
+
+
+
+
+
+
+
+
+The following critical errors have been fixed (i.e., errors
+that can lead to wrong simulation results):
+
+
+Buildings.Fluid.HeatExchangers
+ |
+
+ Buildings.Fluid.HeatExchangers.WetCoilCounterFlow
+ Buildings.Fluid.HeatExchangers.WetCoilDiscretized
+ |
+ Corrected removal of latent heat from component.
+ This is for #3027.
+ |
+
+
+
"));
- end Version_9_0_0;
+ end Version_8_1_3;
+ class Version_8_1_2 "Version 8.1.2"
+ extends Modelica.Icons.ReleaseNotes;
+ annotation (Documentation(info="
+
+
+Version 8.1.2 is a patch that has backward compatible bug fixes.
+It is backwards compatible with versions 8.0.0, 8.1.0 and 8.1.1.
+
+
+The library has been tested with Dymola 2022,
+JModelica (revision 14023),
+OpenModelica 1.19.0-dev (449+g4f16e6af22),
+OPTIMICA (revision OCT-dev-r26446_JM-r14295) and recent versions of Impact.
+
+
+
+
+
+
+The following existing components
+have been improved in a
+backward compatible way:
+
+
+Buildings.HeatTransfer
+ |
+
+Buildings.HeatTransfer.Windows.BaseClasses.CenterOfGlass
+ |
+ Changed the gas layer to be conditional.
+ This is for
+ #3026.
+ |
+
+Buildings.Fluid
+ |
+
+Buildings.Fluid.Boilers.Data.Lochinvar
+ |
+ Added annotation defaultComponentPrefixes = \"parameter\" .
+ |
+
+Buildings.Fluid.HeatPumps.Data.EquationFitReversible.Generic
+ |
+ Removed protected declaration inside the record as the Modelica Language Specification
+ only allows public sections in a record.
+ This is for #3009.
+ |
+
+
+
+
+
+
+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
+ |
+
+Buildings.Controls.OBC.CDL.Conversions.BooleanToInteger
+ Buildings.Controls.OBC.CDL.Conversions.BooleanToReal
+ |
+ Corrected documentation texts where the variables were described with wrong types.
+ This is for
+ #3016.
+ |
+
+
+"));
+ end Version_8_1_2;
+
class Version_8_1_1 "Version 8.1.1"
extends Modelica.Icons.ReleaseNotes;
annotation (Documentation(info="
@@ -10476,7 +10633,13 @@ on the Buildings library.
-
-Version 9.0.0 (xxx, 2021)
+Version 9.0.0 (May 31, 2022)
+
+-
+Version 8.1.3 (May 31, 2022)
+
+-
+Version 8.1.2 (May 26, 2022)
-
Version 8.1.1 (May 12, 2022)
@@ -11017,11 +11180,11 @@ end UsersGuide;
annotation (
preferredView="info",
version="9.0.0",
-versionDate="2021-06-08",
-dateModified="2021-06-08",
+versionDate="2022-05-31",
+dateModified="2022-05-31",
uses(Modelica(version="4.0.0")),
conversion(
- from(version={"8.0.0", "8.1.0", "8.1.1"},
+ from(version={"8.0.0", "8.1.0", "8.1.1", "8.1.2", "8.1.3"},
script="modelica://Buildings/Resources/Scripts/Conversion/ConvertBuildings_from_8_to_9.0.0.mos")),
preferredView="info",
Documentation(info="
diff --git a/README.md b/README.md
index 3196133cdf7..5f5e8e9b2e9 100644
--- a/README.md
+++ b/README.md
@@ -29,7 +29,7 @@ The main project site is http://simulationresearch.lbl.gov/modelica.
## Current release
-Download [Buildings Library 8.1.1 (2022-05-12)](https://github.com/lbl-srg/modelica-buildings/releases/download/v8.1.1/Buildings-v8.1.1.zip)
+Download [Buildings Library 9.0.0 (2022-05-31)](https://github.com/lbl-srg/modelica-buildings/releases/download/v9.0.0/Buildings-v9.0.0.zip)
## License