.Buildings.UsersGuide.ReleaseNotes.Version_3_0_0 .Buildings.UsersGuide.ReleaseNotes.Version_3_0_0Version 3.0.0 is a major new release.
The following major changes have been done:
Buildings.ThermalZones.Detailed.Examples.ElectroChromicWindow.Buildings.Fluid.Movers can now be
configured to use three different control input signals: a
continuous signal (depending on the model either normalized speed,
speed in rpm, prescribed mass flow rate or prescribed head),
discrete stages of these quantities, or on/off. The models also
have been refactored to make their implementation clearer.Buildings.Fluid.HeatPumps has been
added. This package contains models for idealized heat pumps whose
COP changes proportional to the change in COP of a Carnot cycle,
with an optional correction for the part load efficiency.Buildings.Electrical, have been reformulated to comply
with the Modelica Language Definition. All models comply with the
pedantic Modelica check of Dymola.The following new libraries have been added:
| Buildings.Fluid.HeatPumps | Library with heat pump models. This library
contains models for idealized heat pumps whose COP changes
proportional to the change in COP of a Carnot cycle. Optionally, a
part load efficiency curve can be specified. The model
Buildings.Fluid.HeatPumps.Carnot_TCon takes as a
control input the leaving condenser fluid temperature, and the
model Buildings.Fluid.HeatPumps.Carnot_y takes as a
control signal the compressor speed. |
The following new components have been added to existing libraries:
| Buildings.BoundaryConditions.SolarGeometry | |
| Buildings.BoundaryConditions.SolarGeometry.ProjectedShadowLength | Block that computes the length of a shadow projected onto a horizontal plane into the direction that is perpendicular to the azimuth of a surface. |
| Buildings.Electrical | |
|
Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Adapter3to3 Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to3Ground_n Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to3Ground_p |
Adapters for unbalanced three phase systems which are required because the previous formulation used connect statements that violate the Modelica Language Definition. This change was required to enable pedantic model check and translation in Dymola 2016 FD01. This is for #426. |
| Buildings.Fluid.Chillers | |
| Buildings.Fluid.Chillers.Carnot_TEva | Chiller model whose efficiency changes with temperatures similarly to a change in Carnot efficiency. The control input signal is the evaporator leaving fluid temperature. This is for IBPSA, #353. |
| Buildings.Fluid.Sensors | |
| Buildings.Fluid.Sensors.PPM Buildings.Fluid.Sensors.PPMTwoPort |
Sensors that measure trace substances in parts per million. |
| Buildings.HeatTransfer.Windows | |
| Buildings.HeatTransfer.Windows.BeamDepthInRoom | Block that computes the maximum distance at which a solar beam that enters the window hits the workplane. |
| Buildings.Utilities.Math | |
| Buildings.Utilities.Math.Functions.smoothInterpolation | Function that interpolates for vectors
xSup[], ySup[] and independent variable
x. The interpolation is done using a cubic Hermite
spline with linear extrapolation. |
The following existing components have been improved in a backward compatible way:
| Buildings.Fluid | |
|
Buildings.Fluid.Actuators.Valves.ThreeWayEqualPercentageLinear Buildings.Fluid.Actuators.Valves.ThreeWayLinear |
Changed the default value for valve leakage
parameter l from 0 to
0.0001. This is the same value as is used for the
two-way valves, and avoids an assertion that would be triggered if
l=0. |
| Buildings.Fluid.Geothermal.Boreholes.UTube | Updated code for 64 bit on Linux and Windows. This closes issue 485. |
| Buildings.Fluid.HeatExchangers.DryEffectivenessNTU | Reformulated model to allow translation in OpenModelica. This is for issue #490. |
| Buildings.Fluid.Chillers.Carnot | Changed the sign convention for
dTEva_nominal. Now, this quantity needs to be
negative. This change was done to be consistent with other models.
In this version, a warning will be written if the sign is not
updated, but the results will be the same. In future versions the
warning will be changed to an error.The parameters dTEva_nominal and
dTCon_nominal are now used to assign default values
for the nominal mass flow rates. |
| Buildings.Fluid.MixingVolumes.MixingVolume Buildings.Fluid.MixingVolumes.MixingVolumeMoistAir |
Added the parameter use_C_flow. If
set to true, an input connector will be enabled that
can be used to add a trace substance flow rate, such as CO2, to the
volume. |
| Buildings.Fluid.Movers.FlowControlled_dp Buildings.Fluid.Movers.FlowControlled_m_flow Buildings.Fluid.Movers.FlowControlled_Nrpm Buildings.Fluid.Movers.FlowControlled_y |
Added the parameter inputType which
allows to set the input as an continuous input signal, to set the
input as an Integer input signal that selects the stage of the
mover, or to remove the input connector and use a parameter to
assign the control signal. |
| Buildings.Fluid.Storage.StratifiedEnhancedInternalHex | Added option to set dynamics of heat exchanger material separately from the dynamics of the fluid inside the heat exchanger. This is for issue #434. |
|
Buildings.Fluid.Interfaces.FourPortHeatMassExchanger Buildings.Fluid.Interfaces.TwoPortHeatMassExchanger |
Propagated parameter
allowFlowReversal which can cause a simpler energy
balance to be used. |
| Buildings.Fluid.Interfaces.PartialTwoPortTransport | Implemented more efficient computation of
port_a.Xi_outflow and port_a.C_outflow
when allowFlowReversal=false. This is for IBPSA issue
305. |
|
Buildings.Fluid.BaseClasses.FlowModels.basicFlowFunction_dp Buildings.Fluid.BaseClasses.FlowModels.basicFlowFunction_m_flow |
Refactored for a more efficient implementation.
Removed double declaration of smooth(..) and
smoothOrder and changed Inline=true to
LateInline=true. This is for IBPSA issue
301 and for IBPSA issue
279. |
| Buildings.ThermalZones | |
| Buildings.ThermalZones.Detailed.BaseClasses.CFDExchange | Set start and fixed
attributes in u[nWri](start=_uStart, each fixed=true)
to avoid a warning in Dymola 2016 about unspecified initial
conditions. This closes issue
422.Set start and fixed attributes in
firstTrigger(start=false, fixed=true),
retVal(start=0, fixed=true) and
modTimRea(fixed=false) to avoid such a warning in the
pedantic Modelica check in Dymola 2016. This closes issue
459. |
| Buildings.ThermalZones.Detailed.CFD | Updated code for 64 bit on Linux and Windows. This closes issue 485. |
| Buildings.Utilities.Math.Functions | Refactored
Buildings.Utilities.Math.Functions.inverseXRegularized
to make it more efficient as it is used in many steady-state energy
balances. This closes IBPSA issue
302. |
The following existing components have been improved in a non-backward compatible way:
| Buildings.BoundaryConditions | |
|
Buildings.BoundaryConditions.SkyTemperature.BlackBody Buildings.BoundaryConditions.WeatherData.Bus |
Renamed the connector from radHorIR
to HHorIR This is for IBPSA issue
376. For Dymola, the conversion script updates these
connections. However, this also results in a renaming of the
weather bus variable weaBus.radHorIR to
HHorIR, which may require a manual update. |
| Buildings.Fluid | |
| Buildings.Fluid.Interfaces.StaticTwoPortConservationEquation | Removed the constant sensibleOnly and
introduced instead the parameter use_mWat_flow. The
new parameter, if set to true, will enable an input
connector that can be used to add water to the conservation
equation. For Dymola, the conversion script updates the model for
these changes. |
| Buildings.Fluid.Chillers.Carnot | Renamed the model to
Buildings.Fluid.Chillers.Carnot_y due to the addition
of the new model Buildings.Fluid.Chillers.Carnot_TEva.
In addition, the following parameter names were changed:
use_eta_Carnot was changed to
use_eta_Carnot_nominal, and etaCar was
changed to etaCarnot_nominal. This is for IBPSA issue
353. For Dymola, the conversion script removes these
parameters. |
| Buildings.Fluid.Movers.FlowControlled_dp Buildings.Fluid.Movers.FlowControlled_m_flow Buildings.Fluid.Movers.FlowControlled_Nrpm Buildings.Fluid.Movers.FlowControlled_y |
Removed the parameters
use_powerCharacteristics and
motorCooledByFluid as these are already declared in
the performance data record per. This is for issue
#457.
For Dymola, the conversion script removes these parameters. |
| Buildings.Fluid.Movers.FlowControlled_dp Buildings.Fluid.Movers.FlowControlled_m_flow Buildings.Fluid.Movers.FlowControlled_Nrpm Buildings.Fluid.Movers.FlowControlled_y |
Removed the public variable r_N. This
is for IBPSA issue
417. For Dymola, the conversion script removes assignments of
r_N(start). |
| Buildings.Fluid.Movers.FlowControlled_dp Buildings.Fluid.Movers.FlowControlled_m_flow |
Write a warning if no pressure curve is provided
because the efficiency calculation can only be done correctly if a
pressure curve is provided. The warning can be suppressed by
providing a pressure curve, or by setting
nominalValuesDefineDefaultPressureCurve=true. |
| Buildings.Fluid.Movers.Data | Replaced the parameters
Buildings.Fluid.Movers.Data.FlowControlled,
Buildings.Fluid.Movers.Data.SpeedControlled_y, and
Buildings.Fluid.Movers.Data.SpeedControlled_Nrpm by
the parameter Buildings.Fluid.Movers.Data.Generic
which is used for all four types of movers. This is for IBPSA issue
417. This change allows to correctly compute the fan or pump
power also for the models
Buildings.Fluid.Movers.FlowControlled_dp,
Buildings.Fluid.Movers.FlowControlled_m_flow for
speeds that are different from the nominal speed, provided that the
user specifies the pressure curve. For Dymola, the conversion
script updates this parameter.In the previous record Buildings.Fluid.Movers.Data.SpeedControlled_Nrpm,
changed the parameter N_nominal to
speed_rpm_nominal. This is for IBPSA issue
396. For Dymola, the conversion script updates this
parameter. |
|
Buildings.Fluid.BaseClasses.PartialThreeWayResistance Buildings.Fluid.Movers.BaseClasses.PartialFlowMachine Buildings.Fluid.Movers.FlowControlled_dp Buildings.Fluid.Movers.FlowControlled_m_flow Buildings.Fluid.Movers.FlowControlled_Nrpm Buildings.Fluid.Movers.FlowControlled_y Buildings.Fluid.Actuators.Valves.ThreeWayEqualPercentageLinear Buildings.Fluid.Actuators.Valves.ThreeWayLinear Buildings.Fluid.Actuators.Valves.TwoWayEqualPercentage |
Removed parameter dynamicBalance that
overwrote the setting of energyDynamics and
massDynamics. This is for IBPSA, issue
411. For Dymola, the conversion script updates the models. |
| Buildings.Fluid.Interfaces.PartialTwoPort | Renamed the protected parameters
port_a_exposesState, port_b_exposesState
and showDesignFlowDirection. This is for IBPSA issue
349 and IBPSA issue
351. For Dymola, the conversion script updates models that
extend from
Buildings.Fluid.Interfaces.PartialTwoPort. |
| Buildings.Fluid.Interfaces.FourPort | Renamed model to
Buildings.Fluid.Interfaces.PartialFourPort and removed
the parameters h_outflow_a1_start,
h_outflow_b1_start, h_outflow_a2_start
and h_outflow_b2_start to make the model similar to
Buildings.Fluid.Interfaces.PartialTwoPort. See
IBPSA
issue 299 for a discussion. For Dymola, the conversion script
updates models that extend from
Buildings.Fluid.Interfaces.FourPort. |
| Buildings.Fluid.Interfaces.StaticTwoPortConservationEquation | Revised implementation of conservation equations
and added default values for outlet quantities at
port_a if allowFlowReversal=false. This
is for IBPSA issue
281. Also, revised implementation so that equations are always
consistent and do not lead to division by zero, also when
connecting a prescribedHeatFlowRate to
MixingVolume instances. Renamed
use_safeDivision to
prescribedHeatFlowRate. See IBPSA issue
282 for a discussion. For users who simply instantiate existing
component models, this change is backward compatible. However,
developers who implement component models that extend from
Buildings.Fluid.Interfaces.StaticTwoPortConservationEquation
may need to update the parameter use_safeDivision and
use instead prescribedHeatFlowRate. See the model
documentation. |
| Buildings.ThermalZones | |
| Buildings.ThermalZones.Detailed.MixedAir Buildings.ThermalZones.Detailed.CFD |
These models can now be used with electrochromic
windows. This required to change the glass properties
tauSol, rhoSol_a and
rhoSol_b to be arrays. For example, to convert an
existing model, use tauSol={0.6} instead of
tauSol=0.6. For Dymola, the conversion script will
automatically update existing models. |
| Buildings.Obsolete | |
| Buildings.Obsolete.Fluid.Movers Buildings.Obsolete.Media |
Removed these packages which have models from release 2.0.0. |
The following critical errors have been fixed (i.e., errors that can lead to wrong simulation results):
| Buildings.Fluid.Chillers | |
| Buildings.Fluid.Chillers.Carnot | Corrected wrong computation of state of leaving
fluid staB1 and staB2 for the
configuration without flow reversal. The previous implementation
mistakenly used the inStream operator. This is for
issue
476 |
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.Electrical | |
| Buildings.Electrical.Interfaces.PartialWindTurbine | Reformulated test for equality of
Real variables. This closes issue
493. |
| Buildings.HeatTransfer | |
|
Buildings.HeatTransfer.Conduction.SingleLayer Buildings.HeatTransfer.Data.BaseClasses |
Reformulated test for equality of
Real variables. This closes issue
493. |
| Buildings.Fluid | |
| Buildings.Fluid.FMI.FlowSplitter_u | Corrected wrong assert statement. This closes issue 442. |
| Buildings.Fluid.Chillers.Carnot | Corrected wrong assert statement for test on the efficiency function. This closes issue 468. |
| Buildings.Media | |
| Buildings.Media.Specialized.Water.TemperatureDependentDensity | Removed dublicate entry of smooth and
smoothOrder. This is for IBPSA issue
303. |
| Buildings.ThermalZones | |
| Buildings.ThermalZones.Detailed.BaseClasses.MixedAirHeatGain | Reformulated test for equality of
Real variables. This closes issue
493. |
| Buildings.Utilities.Math | |
|
Buildings.Utilities.Math.Functions.BaseClasses.der_2_regNonZeroPower Buildings.Utilities.Math.Functions.BaseClasses.der_polynomial Buildings.Utilities.Math.Functions.BaseClasses.der_regNonZeroPower |
Corrected wrong derivative implementation and improved their regression tests. This is for IBPSA issue 303. |
| Buildings.Utilities.Psychrometrics | |
| Buildings.Utilities.Psychrometrics.Density_pTX | Corrected wrong default component name. |
| Buildings.Utilities.Psychrometrics.Functions.saturationPressure | Changed smoothOrder from 5 to
1 as
Buildings.Utilities.Math.Functions.spliceFunction is
only once continuously differentiable. Inlined the function. |
| Buildings.Utilities.IO.Python27 | |
| Buildings.Utilities.IO.Python27.exchange | Updated Python implementation to allow compiling
code on 64 bit Linux. Previously, on Linux a segmentation fault
occurred during run-time if 64 bit code rather than 32 bit code was
generated. This is now corrected. Also, Windows 64 bit binaries have been added. This closes issue 287. |