.Buildings.UsersGuide.ReleaseNotes.Version_1_4_build1 .Buildings.UsersGuide.ReleaseNotes.Version_1_4_build1Version 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:
| Buildings.Utilities.IO.Python27 | Package that contains blocks and functions that embed Python 2.7 in Modelica. Data can be sent to Python functions and received from Python functions. This allows for example data analysis in Python as part of a Modelica model, or data exchange as part of a hardware-in-the-loop simulation in which Python is used to communicate with hardware. |
The following new components have been added to existing libraries:
| Buildings.BoundaryConditions.WeatherData | |
| Buildings.BoundaryConditions.WeatherData.BaseClasses.getAbsolutePath | This function is used by the weather data reader to set the path to the weather file relative to the root directory of the Buildings library. |
The following existing components have been improved in a backward compatible way:
| Buildings.Fluid | |
| Buildings.Fluid.MixingVolumes.BaseClasses.PartialMixingVolume | Removed the check of multiple connections to the
same element of a fluid port, as this check required the use of the
deprecated cardinality function. |
| Buildings.HeatTransfer | |
| Buildings.HeatTransfer.Conduction.SingleLayer | Added option to model layers with phase change material. |
| Buildings.ThermalZones | |
| Buildings.ThermalZones.Detailed.BaseClasses.InfraredRadiationExchange | Removed the use of the cardinality
function as this function is deprecated in the Modelica Language
Specification. |
The following existing components have been improved in a non-backward compatible way:
| Buildings.Fluid | |
| Buildings.Fluid.Actuators.Valves | All valves now require the declaration of
dp_nominal if the parameter assignment is CvData
= Buildings.Fluid.Types.CvTypes.OpPoint. This change was
needed because in the previous version, dp_nominal had
a default value of 6000 Pascals. However, if CvData
>< Buildings.Fluid.Types.CvTypes.OpPoint, then
dp_nominal is computed in the initial algorithm
section and hence providing a default value is not allowed
according to the Modelica Language Specification. Hence, it had to
be removed.As part of this change, we set dp(nominal=6000) for
all valves, because the earlier formulation uses a value that is
not known during compilation, and hence leads to an error in Dymola
2014. |
|
Buildings.Fluid.MixingVolumes.MixingVolumeDryAir Buildings.Fluid.MixingVolumes.MixingVolumeMoistAir |
Removed the use of the deprecated
cardinality function. Therefore, now all input signals
must be connected. |
| Buildings.Utilities | |
|
Buildings.Utilities.Diagnostics.AssertEquality Buildings.Utilities.Diagnostics.AssertInequality |
Removed the option to not connect input signals,
as this required the use of the cardinality function
which is deprecated in the MSL, and not correctly implemented in
OpenModelica. Therefore, if using these models, both input signals
must be connected. |
| Buildings.Utilities.Math.Functions.splineDerivatives | Removed the default value input Boolean
ensureMonotonicity=isMonotonic(y, strict=false) as the
Modelica language specification is not clear whether defaults can
be computed or must be constants. |
The following critical errors have been fixed (i.e., errors that can lead to wrong simulation results):
| Buildings.Controls | |
| Buildings.Controls.SetPoints.HotWaterTemperatureReset | Corrected error that led to wrong results if the
room air temperature is different from its nominal value
TRoo_nominal. This fixes issue
74. |
| Buildings.HeatTransfer | |
|
Buildings.Fluid.HeatExchangers.RadiantSlabs.SingleCircuitSlab Buildings.Fluid.HeatExchangers.RadiantSlabs.ParallelCircuitSlab |
Fixed bug in the assignment of the fictitious
thermal resistance by replacing RFic[nSeg](each
G=A/Rx) with RFic[nSeg](each G=A/nSeg/Rx). This
fixes issue
79. |
| Buildings.Utilities | |
|
Buildings.Utilities.Diagnostics.AssertEquality Buildings.Utilities.Diagnostics.AssertInequality |
Replaced when test with
if test as equations within a when
section are only evaluated when the condition becomes true. This
fixes issue
72. |
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.Fluid | |
|
Buildings.Fluid.Actuators.Valves.ThreeWayEqualPercentageLinear Buildings.Fluid.Actuators.Valves.ThreeWayLinear |
The documenation was Fraction Kv(port_1 →
port_2)/Kv(port_3 → port_2) instead of Fraction Kv(port_3 →
port_2)/Kv(port_1 → port_2). Because the parameter set
correctly its attributes min=0 and max=1,
instances of these models used the correct value. |
| Buildings.Fluid.Actuators.BaseClasses.ValveParameters | Removed stray backslash in write statement. |
|
Buildings.Fluid.Interfaces.ConservationEquation Buildings.Fluid.Interfaces.StaticTwoPortConservationEquation Buildings.Fluid.Interfaces.StaticTwoPortHeatMassExchanger |
Removed wrong unit attribute of
COut. |
| Buildings.Fluid.HeatExchangers.BaseClasses.HexElement | Changed the redeclaration of vol2 to
be replaceable, as vol2 is replaced in some
models. |
The following issues have been fixed:
| Add explanation of nStaRef. | |
| #70 | Described in
Buildings.HeatTransfer.Data.Solids how the parameter
nStaRef is used to compute the spatial grid that is
used for simulating transient heat conduction. |
| Assert statement does not fire. | |
| #72 | The blocks
Buildings.Utilities.Diagnostics.AssertEquality and
Buildings.Utilities.Diagnostics.AssertInequality did
not fire because the test on the time was in a when
instead of an if statement. This was wrong because
when sections are only evaluated when the condition
becomes true. |
HotWaterTemperatureReset computes
wrong results if room temperature differs from nominal
value. |
|
| #74 | The equation
TSup = TRoo_in_internal
+ ((TSup_nominal+TRet_nominal)/2-TRoo_in_internal) * qRel^(1/m)
+ (TSup_nominal-TRet_nominal)/2 * qRel;
should be formulated as
TSup = TRoo_in_internal
+ ((TSup_nominal+TRet_nominal)/2-TRoo_nominal) * qRel^(1/m)
+ (TSup_nominal-TRet_nominal)/2 * qRel; |
Bug in
RadiantSlabs.SingleCircuitSlab fictitious resistance
RFic. |
|
| #79 | This bug has been fixed in the assignment of the
fictitious thermal resistance by replacing RFic[nSeg](each
G=A/Rx) with RFic[nSeg](each G=A/nSeg/Rx). The
bug also affected
RadiantSlabs.ParallelCircuitSlab. |
Note: