.Buildings.UsersGuide.ReleaseNotes.Version_1_5_build1 .Buildings.UsersGuide.ReleaseNotes.Version_1_5_build1Version 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:
| Buildings.Fluid.SolarCollectors | Library with solar collectors. |
| Buildings.ThermalZones.Detailed.FLEXLAB | Package with models for test cells of LBNL's FLEXLAB (Facility for Low Energy Experiments in Buildings). |
| Buildings.Utilities.IO.FLEXLAB | Package that demonstrates two-way data exchange between Modelica and LBNL's FLEXLAB (Facility for Low Energy Experiments in Buildings). |
The following new components have been added to existing libraries:
| Buildings.Fluid.Storage | |
| Buildings.Fluid.Storage.StratifiedEnhancedInternalHex | Added a model of a tank with built-in heat exchanger. This model may be used together with solar thermal plants. |
| Buildings.Resources | |
| Buildings.Resources.Include | Added an Include folder and the
bcvtb.h header file to it to fix compilation errors in
BCVTB example files. |
The following existing components have been improved in a backward compatible way:
| Buildings.BoundaryConditions | |
|
Buildings.BoundaryConditions.WeatherData.ReaderTMY3 Buildings.BoundaryConditions.WeatherData.BaseClasses.getAbsolutePath |
Improved the algorithm that determines the
absolute path of the file. Now weather files are searched in the
path specified, and if not found, the urls file://,
modelica:// and modelica://Buildings are
added in this order to search for the weather file. This allows
using the data reader without having to specify an absolute path,
as long as the Buildings library is on the
MODELICAPATH. |
| Buildings.Fluid | |
| Buildings.Fluid.Interfaces.StaticTwoPortConservationEquation | Reformulated computation of outlet properties to avoid an event at zero mass flow rate. |
| Buildings.Fluid.HeatExchangers.CoolingTowers.YorkCalc | Simplified the implementation for the situation if
allowReverseFlow=false. Avoided the use of the
conditionally enabled variables sta_a and
sta_b as this was not proper use of the Modelica
syntax. |
| Buildings.Fluid.Interfaces.Examples.ReverseFlowHumidifier | Changed one instance of
Modelica.Fluid.Sources.MassFlowSource_T, that was
connected to the two fluid streams, to two instances, each having
half the mass flow rate. This is required for the model to work
with Modelica 3.2.1 due to the change introduced in ticket #739. |
| Buildings.Fluid.Sensors.EnthalpyFlowRate Buildings.Fluid.Sensors.SensibleEnthalpyFlowRate Buildings.Fluid.Sensors.LatentEnthalpyFlowRate Buildings.Fluid.Sensors.VolumeFlowRate |
Removed default value tau=0 as the
base class already sets tau=1. This change was made so
that all sensors use the same default value. |
| Buildings.Fluid.Sensors.TraceSubstancesTwoPort | Added default value C_start=0. |
| Buildings.HeatTransfer | |
| Buildings.HeatTransfer.Data.OpaqueConstructions.Generic | Changed the annotation of the instance
material from Evaluate=true to
Evaluate=false. This is required to allow changing the
material properties after compilation. Note, however, that the
number of state variables in
Buildings.HeatTransfer.Data.BaseClasses.Material are
only computed when the model is translated, because the number of
state variables is fixed at compilation time. |
| Buildings.Utilities | |
|
Buildings.Utilities.Diagnostics.AssertEquality Buildings.Utilities.Diagnostics.AssertInequality |
Added time in print statement as
OpenModelica, in its error message, does not output the time when
the assert is triggered. |
The following existing components have been improved in a non-backward compatible way:
| Buildings.Airflow | |
| Buildings.Airflow.Multizone.Orifice Buildings.Airflow.Multizone.EffectiveAirLeakageArea Buildings.Airflow.Multizone.ZonalFlow_ACS |
Changed the parameter
useConstantDensity to
useDefaultProperties to use consistent names within
this package. A conversion script in
Resources/Scripts/Dymola can be used to update old
models that use this parameter. |
| Buildings.Fluid | |
| Buildings.Fluid.BaseClasses.IndexWater | Renamed class to
Buildings.Fluid.BaseClasses.IndexMassFraction as it is
applicable for all mass fraction sensors. |
|
Buildings.Fluid.HeatExchangers.ConstantEffectiveness Buildings.Fluid.HeatExchangers.DryEffectivenessNTU Buildings.Fluid.Interfaces.ConservationEquation Buildings.Fluid.Interfaces.StaticFourPortHeatMassExchanger Buildings.Fluid.Interfaces.StaticTwoPortConservationEquation Buildings.Fluid.Interfaces.StaticTwoPortHeatMassExchanger Buildings.Fluid.MassExchangers.ConstantEffectiveness Buildings.Fluid.MassExchangers.HumidifierPrescribed Buildings.Fluid.MixingVolumes.BaseClasses.PartialMixingVolumeWaterPort Buildings.Fluid.MixingVolumes.MixingVolume Buildings.Fluid.MixingVolumes.MixingVolumeDryAir Buildings.Fluid.MixingVolumes.MixingVolumeMoistAir Buildings.Fluid.Storage.ExpansionVessel |
Changed the input connector mXi_flow
(or mXi1_flow and mXi2_flow) to
mWat_flow (or mWat1_flow and
mWat2_flow). This change has been done as declaring
mXi_flow is ambiguous because it does not specify what
other species are added unless a mass flow rate m_flow
is also known. To avoid this confusion, the connector variables
have been renamed. The equations that were used were, however,
correct. This addresses issue #165. |
|
Buildings.Fluid.Storage.BaseClasses.IndirectTankHeatExchanger Buildings.Fluid.BaseClasses.PartialResistance Buildings.Fluid.FixedResistances.BaseClasses.Pipe Buildings.Fluid.FixedResistances.FixedResistanceDpM Buildings.Fluid.FixedResistances.LosslessPipe Buildings.Fluid.Geothermal.Boreholes.BaseClasses.BoreholeSegment Buildings.Fluid.Geothermal.Boreholes.UTube Buildings.Fluid.HeatExchangers.RadiantSlabs.ParallelCircuitsSlab Buildings.Fluid.Interfaces.FourPortHeatMassExchanger Buildings.Fluid.Interfaces.PartialFourPortInterface Buildings.Fluid.Interfaces.PartialTwoPortInterface Buildings.Fluid.Interfaces.StaticFourPortHeatMassExchanger Buildings.Fluid.Interfaces.StaticTwoPortHeatMassExchanger Buildings.Fluid.Interfaces.TwoPortHeatMassExchanger Buildings.Fluid.MixingVolumes.BaseClasses.PartialMixingVolume Buildings.Fluid.Movers.BaseClasses.FlowControlled Buildings.Fluid.Movers.BaseClasses.IdealSource Buildings.Fluid.Movers.BaseClasses.PrescribedFlowMachine |
Removed the computation of V_flow and
removed the parameter show_V_flow. The reason is that
the computation of V_flow required the use of
sta_a (to compute the density), but sta_a
is also a variable that is conditionally enabled. However, this was
not correct Modelica syntax as conditional variables can only be
used in a connect statement, not in an assignment.
Dymola 2014 FD01 beta3 is checking for this incorrect syntax.
Hence, V_flow was removed as its conditional
implementation would require a rather cumbersome implementation
that uses a new connector that carries the state of the
medium. |
| Buildings.Fluid.MixingVolumes | Removed
Buildings.Fluid.MixingVolumes.MixingVolumeDryAir as
this model is no longer used. The model
Buildings.Fluid.MixingVolumes.MixingVolume can be used
instead of.Removed base class Buildings.Fluid.MixingVolumes.BaseClasses.PartialMixingVolumeWaterPort
as this model is no longer used. |
| Buildings.Fluid.Sensors.Examples.TraceSubstances | Renamed example from ExtraProperty to
TraceSubstances in order to use the same name as the
sensor. |
| Buildings.Fluid.Sources.PrescribedExtraPropertyFlowRate | Renamed model
toTraceSubstancesFlowRate to use the same terminology
than the Modelica Standard Library.The conversion script updates existing models that instantiate this model. |
| Buildings.Fluid.Sources.Examples.PrescribedExtraPropertyFlow | Renamed example
toTraceSubstancesFlowRate in order to use the same
name as the source model. |
|
Buildings.Fluid.MixingVolumes.BaseClasses.PartialMixingVolume Buildings.Fluid.FixedResistances.Pipe Buildings.Fluid.HeatExchangers.RadiantSlabs.ParallelCircuitsSlab Buildings.Fluid.HeatExchangers.RadiantSlabs.SingleCircuitSlab Buildings.Fluid.Movers.BaseClasses.FlowControlled |
Renamed X_nominal to
X_default or X_start, where
X may be state, rho, or
mu, depending on whether the medium default values or
the start values are used in the computation of the state and
derived quantities. |
| Buildings.HeatTransfer Buildings.ThermalZones |
|
|
Buildings.HeatTransfer.Interfaces.RadiosityInflow Buildings.HeatTransfer.Interfaces.RadiosityOutflow Buildings.HeatTransfer.Radiosity.BaseClasses.ParametersTwoSurfaces Buildings.HeatTransfer.Radiosity.Constant Buildings.HeatTransfer.Radiosity.Examples.OpaqueSurface Buildings.HeatTransfer.Radiosity.Examples.OutdoorRadiosity Buildings.HeatTransfer.Radiosity.IndoorRadiosity Buildings.HeatTransfer.Radiosity.OpaqueSurface Buildings.HeatTransfer.Radiosity.OutdoorRadiosity Buildings.HeatTransfer.Radiosity.RadiositySplitter Buildings.HeatTransfer.Radiosity.package Buildings.HeatTransfer.Windows.BaseClasses.Examples.CenterOfGlass Buildings.HeatTransfer.Windows.BaseClasses.Examples.GlassLayer Buildings.HeatTransfer.Windows.BaseClasses.Examples.Shade Buildings.HeatTransfer.Windows.BaseClasses.GlassLayer Buildings.HeatTransfer.Windows.BaseClasses.Shade Buildings.HeatTransfer.Windows.Examples.BoundaryHeatTransfer Buildings.HeatTransfer.Windows.ExteriorHeatTransfer Buildings.HeatTransfer.Windows.InteriorHeatTransfer Buildings.ThermalZones.Detailed.BaseClasses.InfraredRadiationExchange Buildings.ThermalZones.Detailed.BaseClasses.InfraredRadiationGainDistribution Buildings.ThermalZones.Detailed.BaseClasses.MixedAir Buildings.ThermalZones.Detailed.BaseClasses.Overhang Buildings.ThermalZones.Detailed.BaseClasses.SideFins |
Changed the connectors for the radiosity model.
The previous implemenation declared the radiosity as a
flow variables, but the implementation did not use a
potential variable.Therefore, the radiosity was the only variable in the connector, which is not allowed for flow variables. This change
required a reformulation of models because with the new
formulation, the incoming and outcoming radiosity are both
non-negative values. This addresses issue #158. |
| Buildings.HeatTransfer Buildings.ThermalZones |
|
|
Buildings.HeatTransfer.Windows.BaseClasses.PartialConvection Buildings.HeatTransfer.Windows.BaseClasses.PartialWindowBoundaryCondition Buildings.HeatTransfer.Windows.BaseClasses.Shade Buildings.HeatTransfer.Windows.BaseClasses.ShadeConvection Buildings.HeatTransfer.Windows.BaseClasses.ShadeRadiation Buildings.HeatTransfer.Windows.InteriorHeatTransfer Buildings.HeatTransfer.Windows.InteriorHeatTransferConvective Buildings.ThermalZones.Detailed.ExteriorBoundaryConditionsWithWindow Buildings.ThermalZones.Detailed.PartialSurfaceInterface Buildings.ThermalZones.Detailed.InfraredRadiationExchange Buildings.ThermalZones.Detailed.AirHeatMassBalanceMixed Buildings.ThermalZones.Detailed.SolarRadiationExchange Buildings.ThermalZones.Detailed.RadiationTemperature Buildings.ThermalZones.Detailed.InfraredRadiationGainDistribution |
Redesigned the implementation of the room model and its base classes. This redesign separates convection from radiation, and it provides one composite model for the convection and the heat and mass balance in the room. This change was done to allow an implementation of the room air heat and mass balance that does not assume uniformly mixed room air. |
| Buildings.HeatTransfer | |
| Buildings.HeatTransfer.Convection.Functions.HeatFlux.rayleigh | Renamed function from raleigh to
rayleigh. |
The following critical errors have been fixed (i.e., errors that can lead to wrong simulation results):
| Buildings.Fluid | |
| Buildings.Fluid.Sensors.SpecificEntropyTwoPort | Corrected wrong computation of the dynamics used for the sensor signal. |
| Buildings.HeatTransfer | |
| Buildings.HeatTransfer.Data.GlazingSystems.DoubleClearAir13Clear | Corrected the glass layer thickness, which was 5.7 mm instead of 3 mm, as the documentation states. |
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 | |
|
Buildings.BoundaryConditions.SkyTemperature.BlackBody Buildings.BoundaryConditions.WeatherData.BaseClasses.CheckTemperature Buildings.BoundaryConditions.WeatherData.ReaderTMY3 Buildings.Controls.SetPoints.HotWaterTemperatureReset Buildings.Examples.ChillerPlant.BaseClasses.Controls.ChillerSwitch Buildings.Examples.ChillerPlant.BaseClasses.Controls.WSEControl Buildings.Fluid.Boilers.BoilerPolynomial Buildings.Fluid.HeatExchangers.BaseClasses.HexElement Buildings.Fluid.HeatExchangers.BaseClasses.MassExchange Buildings.Fluid.HeatExchangers.BaseClasses.MassExchangeDummy Buildings.Fluid.DXSystems.Cooling.BaseClasses.ApparatusDewPoint Buildings.Fluid.DXSystems.Cooling.BaseClasses.ApparatusDryPoint Buildings.Fluid.DXSystems.BaseClasses.CoolingCapacity Buildings.Fluid.DXSystems.Cooling.BaseClasses.DXCooling Buildings.Fluid.DXSystems.BaseClasses.DryCoil Buildings.Fluid.DXSystems.Cooling.BaseClasses.DryWetSelector Buildings.Fluid.DXSystems.Cooling.BaseClasses.Evaporation Buildings.Fluid.DXSystems.Cooling.BaseClasses.WetCoil Buildings.Fluid.MixingVolumes.BaseClasses.PartialMixingVolumeWaterPort Buildings.Fluid.Sensors.RelativeTemperature Buildings.Fluid.Sensors.Temperature Buildings.Fluid.Sensors.TemperatureTwoPort Buildings.Fluid.Sensors.TemperatureWetBulbTwoPort Buildings.Fluid.SolarCollectors.BaseClasses.PartialHeatLoss Buildings.Utilities.Comfort.Fanger Buildings.Utilities.IO.BCVTB.From_degC Buildings.Utilities.IO.BCVTB.To_degC Buildings.Utilities.Psychrometrics.TDewPoi_pW Buildings.Utilities.Psychrometrics.TWetBul_TDryBulPhi Buildings.Utilities.Psychrometrics.TWetBul_TDryBulXi Buildings.Utilities.Psychrometrics.WetBul_pTX Buildings.Utilities.Psychrometrics.pW_TDewPoi |
Replaced wrong attribute
quantity="Temperature" with
quantity="ThermodynamicTemperature". |
| Buildings.Fluid | |
| Buildings.Fluid.Data.Fuels.Generic | Corrected wrong type for mCO2. It was
declared as Modelica.Units.SI.MassFraction, which is
incorrect. |
| Buildings.Fluid.HeatExchangers.CoolingTowers.Correlations.BaseClasses.Bounds | Corrected wrong type for FRWat_min,
FRWat_max and liqGasRat_max. They were
declared as Modelica.Units.SI.MassFraction, which is
incorrect as, for example, FRWat_max can be larger
than one. |
|
Buildings.Fluid.HeatExchangers.ConstantEffectiveness Buildings.Fluid.MassExchangers.ConstantEffectiveness |
Corrected error in the documentation that was not updated when the implementation of zero flow rate was revised. |
| Buildings.Fluid.Interfaces.ConservationEquation | Corrected the syntax error
Medium.ExtraProperty C[Medium.nC](each
nominal=C_nominal) to Medium.ExtraProperty
C[Medium.nC](nominal=C_nominal) because
C_nominal is a vector. This syntax error caused a
compilation error in OpenModelica. |
|
Buildings.Fluid.Sensors.SensibleEnthalpyFlowRate Buildings.Fluid.Sensors.LatentEnthalpyFlowRate Buildings.Fluid.Sensors.MassFraction Buildings.Fluid.Sensors.MassFractionTwoPort |
Changed medium declaration in the
extends statement to replaceable to avoid
a translation error in OpenModelica. |
| Buildings.Fluid.Sensors.TraceSubstances Buildings.Fluid.Sensors.TraceSubstancesTwoPort |
Corrected syntax errors in setting nominal value for output signal and for state variable. This eliminates a compilation error in OpenModelica. |
| Buildings.Fluid.Sources.TraceSubstancesFlowSource | Added missing each in declaration of
C_in_internal. This eliminates a compilation error in
OpenModelica. |
| Buildings.Utilities.Python27 | |
| Buildings.Utilities.IO.Python27.Functions.exchange | Corrected error in C code that lead to message
'module' object has no attribute 'argv' when a python
module accessed sys.argv. |
The following issues have been fixed:
| Verify mass and species balance | |
| #165 | This issue has been addressed by renaming the connectors to avoid an ambiguity in the model equation. The equations were correct. |
| Remove flow attribute from radiosity connectors | |
| #158 | This issue has been addressed by reformulating the radiosity models. With the new implementation, incoming and outgoing radiosity are non-negative quantities. |