.Buildings.UsersGuide.ReleaseNotes.Version_2_0_0 .Buildings.UsersGuide.ReleaseNotes.Version_2_0_0Version 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:
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.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.Buildings.Controls.DemandResponse
contains models for demand response simulation.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:
| Buildings.Electrical | Library for electrical grid simulation that allows to study building to electrical grid integration. The library contains models of loads, generation and transmission for DC and AC systems. |
| Buildings.Controls.DemandResponse | Library with a model for demand response prediction. |
| Buildings.Controls.Predictors | Library with 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 following new components have been added to existing libraries:
| Buildings.Fluid | |
| Buildings.Fluid.Actuators.Valves.TwoWayPressureIndependent | Model of a pressure-independent two way valve. |
| Buildings.Fluid.HeatExchangers.HeaterCooler_T | Model of a heater or cooler that takes as an input the set point for the temperature of the fluid that leaves the component. The set point is tracked exactly if the component has sufficient capacity. Optionally, the component can be configured to compute a dynamic rather than a steady-state response. |
| Buildings.Utilities | |
| Buildings.Utilities.Psychrometrics.Phi_pTX Buildings.Utilities.Psychrometrics.Functions.phi_pTX |
Block and function that computes the relative humidity for given pressure, temperature and water vapor mass fraction. |
| Buildings.ThermalZones | |
| Buildings.ThermalZones.Detailed.CFD | Room model that computes the room air flow using
computational fluid dynamics (CFD). The CFD simulation is coupled
to the thermal simulation of the room and, through the fluid port,
to the air conditioning system. Currently, the supported CFD
program is the Fast Fluid Dynamics (FFD) program. See
Buildings.ThermalZones.Detailed.UsersGuide.CFD for
detailed explanations. |
The following existing components have been improved in a backward compatible way:
| Buildings.BoundaryConditions | |
| Buildings.BoundaryConditions.WeatherData.ReaderTMY3 | Added option to obtain the black body sky
temperature from a parameter or an input signal rather than
computing it in the weather data reader. Removed redundant connection connect(conHorRad.HOut,
cheHorRad.HIn);. |
| Buildings.Fluid | |
| Buildings.Chillers.ElectricEIR Buildings.Chillers.ElectricReformulatedEIR |
Changed implementation so that the model is continuously differentiable. This is for issue 373. |
| Buildings.Fluid.HeatExchangers.DryCoilCounterFlow | Changed assignment of T_m to avoid
using the conditionally enabled model ele[:].mas.T,
which is only valid in a connect statement. Moved assignments of
Q1_flow, Q2_flow, T1,
T2 and T_m outside of equation section to
avoid mixing graphical and textual modeling within the same
model. |
| Buildings.Fluid.HeatExchangers.DryCoilDiscretized | Removed parameter m1_flow_nominal, as
this parameter is already declared in its base class
Buildings.Fluid.Interfaces.PartialFourPortInterface.
This change avoids an error in OpenModelica as the two declarations
had a different value for the min attribute, which is
not valid in Modelica. |
|
Buildings.Fluid.HeatExchangers.BaseClasses.CoilRegister Buildings.Fluid.HeatExchangers.BaseClasses.DuctManifoldDistributor |
Reformulated the multiple iterators in the
sum function as this language construct is not
supported in OpenModelica. |
| Buildings.Fluid.HeatExchangers.RadiantSlabs.SingleCircuitSlab | Set start value for hPip(fluid(T)) to
avoid a warning about conflicting start values. |
| Buildings.Fluid.Movers.SpeedControlled_y Buildings.Fluid.Movers.SpeedControlled_Nrpm Buildings.Fluid.Movers.FlowControlled_dp Buildings.Fluid.Movers.FlowControlled_m_flow |
For the parameter setting
use_powerCharacteristic=true, changed the computation
of the power consumption at reduced speed to properly account for
the affinity laws. This is in response to #202. |
| Buildings.Fluid.SolarCollectors.ASHRAE93 Buildings.Fluid.SolarCollectors.EN12975 |
Reformulated the model to avoid a translation
error if glycol is used. Propagated parameters for initialization in base class Buildings.Fluid.SolarCollectors.BaseClasses.PartialSolarCollector
and set prescribedHeatFlowRate=true. |
| Buildings.Fluid.Storage.StratifiedEnhancedInternalHex | Replaced the abs() function in the
assignment of the parameter nSegHexTan as the return
value of abs() is a Real which causes a
type error during model check. |
| Buildings.HeatTransfer | |
| Buildings.HeatTransfer.Conduction.MultiLayer | Changed the assignment of _T_a_start,
_T_b_start and RTot to be in the initial
equation section as opposed to the parameter declaration. This is
needed to avoid an error during model check and translation in
Dymola 2015 FD01 beta1. |
| Buildings.HeatTransfer.Windows.InteriorHeatTransferConvective | Changed model to allow a temperature dependent convective heat transfer on the room side. This is for issue 52. |
| Buildings.Media | |
|
Buildings.Media.Interfaces.PartialSimpleIdealGasMedium Buildings.Media.Interfaces.PartialSimpleMedium |
Set T(start=T_default) and
p(start=p_default) in the
ThermodynamicState record. Setting the start value for
T is required to avoid an error due to conflicting
start values when translating
Buildings.Examples.VAVReheat.ClosedLoop in pedantic
mode. |
| Buildings.ThermalZones | |
| Buildings.ThermalZones.Detailed.MixedAir | Changed model to allow a temperature dependent convective heat transfer on the room side for windows. This is for issue 52. |
| Rooms.BaseClasses.ExteriorBoundaryConditionsWithWindow | Conditionally removed the shade model if no shade is present. This corrects #234. |
The following existing components have been improved in a non-backward compatible way:
| Buildings.Airflow | |
| Buildings.Airflow.Multizone.ZonalFlow_ACS Buildings.Airflow.Multizone.ZonalFlow_m_flow |
Removed parameter
forceErrorControlOnFlow as it was not used. For
Dymola, the conversion script will automatically update existing
models. |
| Buildings.BoundaryConditions | |
| Buildings.BoundaryConditions.WeatherData.ReaderTMY3 | Changed the following signals for compatibility
with OpenModelica:weaBus.sol.zen to weaBus.solZen.weaBus.sol.dec to weaBus.solDec.weaBus.sol.alt to weaBus.solAlt.weaBus.sol.solHouAng to
weaBus.solHouAng.For Dymola, the conversion script will automatically update existing models. |
| Buildings.Examples | |
| Buildings.Examples.VAVReheat.Controls.IntegerSum | Removed block as it is not used in any model.
Models that require an integer sum can use
Modelica.Blocks.MathInteger.Sum. |
| Buildings.Examples.VAVReheat.Controls.UnoccupiedOn | Removed block as it is not used in any model. |
| Buildings.HeatTransfer | |
| Buildings.HeatTransfer.Data.GlazingSystems.Generic | Removed parameter nLay as
OpenModelica could not assign it during translation. For Dymola,
the conversion script will automatically update existing
models. |
| Buildings.HeatTransfer.Conduction.BaseClasses.der_temperature_u | Changed the input argument for this function from
type Buildings.HeatTransfer.Data.BaseClasses.Material
to the elements of this type as OpenModelica fails to translate the
model if the input to this function is a record. |
| Buildings.HeatTransfer.Types.Azimuth Buildings.HeatTransfer.Types.Tilt |
Moved these types from
Buildings.HeatTransfer to the top-level package
Buildings because they are used in
Buildings.BoundaryConditions,
Buildings.HeatTransfer and
Buildings.ThermalZones.Detailed.For Dymola, the conversion script will automatically update existing models. |
| Buildings.Fluid | |
| Buildings.Fluid.FixedResistances.Pipe Buildings.Fluid.FixedResistances.BaseClasses.Pipe Buildings.Fluid.HeatExchangers.RadiantSlabs.SingleCircuitSlab |
Renamed pressure drop from res to
preDro to use the same name as in other models. This
corrects #271.
For Dymola, the conversion script will automatically update
existing models. |
|
Buildings.Fluid.HeatExchangers.DryCoilDiscretized Buildings.Fluid.HeatExchangers.WetCoilDiscretized |
Reformulated flow splitter in the model to reduce
the dimension of the coupled linear or nonlinear system of
equations. With this revision, the optional control volume in the
duct inlet has been removed as it is no longer needed. Therefore,
the parameter dl has also been removed. Replaced the
parameters energyDynamics1 and
energyDynamics2 with energyDynamics.
Removed the parameter ductConnectionDynamics.For Dymola, the conversion script will automatically update existing models. |
| Buildings.Fluid.HeatExchangers.HeaterCoolerPrescribed | Renamed the model to HeaterCooler_u
due to the introduction of the new model
HeaterCooler_T.For Dymola, the conversion script will automatically update existing models. |
|
Buildings.Fluid.HeatExchangers.RadiantSlabs.SingleCircuitSlab Buildings.Fluid.HeatExchangers.RadiantSlabs.ParallelCircuitsSlab |
Changed the models to use by default an
ε-NTU approach for the heat transfer between the fluid and
the slab rather than a finite difference scheme along the flow
path. Optionally, the finite difference scheme can also be used as
this is needed for some control design applications. The new ε-NTU formulation has shown to lead to about five times faster computation on several test cases including the models in Buildings.ThermalZones.Detailed.FLEXLAB.Rooms.Examples.For Dymola, the conversion script will automatically update existing models. |
| Buildings.Fluid.HeatExchangers.BaseClasses.DuctManifoldFixedResistance | Reformulated flow splitter in the model to reduce
the dimension of the coupled linear or nonlinear system of
equations. With this revision, the optional control volume in the
duct inlet has been removed as it is no longer needed. Therefore,
the parameters dl and energyDynamics have
also been removed.For Dymola, the conversion script will automatically update existing models. |
| Buildings.Fluid.HeatExchangers.BaseClasses.CoilRegister | Replaced the parameters
energyDynamics1 and energyDynamics2 with
the new parameter energyDynamics. Removed the
parameters steadyState_1 and
steadyState_2 as this information is already contained
in energyDynamics.For Dymola, the conversion script will automatically update existing models. |
| Buildings.Fluid.MassExchangers.HumidifierPrescribed | Renamed the model to Humidifier_u due
to the introduction of the new model HeaterCooler_T
and to use the same naming pattern as
HeaterCooler_u.For Dymola, the conversion script will automatically update existing models. |
| Buildings.Fluid.Movers | This package has been redesigned. The models have
been renamed as follows:Buildings.Fluid.Movers.FlowMachine_dp is now called
Buildings.Fluid.Movers.FlowControlled_dp.Buildings.Fluid.Movers.FlowMachine_m_flow is now
called
Buildings.Fluid.Movers.FlowControlled_m_flow.Buildings.Fluid.Movers.FlowMachine_Nrpm is now called
Buildings.Fluid.Movers.SpeedControlled_Nrpm.Buildings.Fluid.Movers.FlowMachine_y is now called
Buildings.Fluid.Movers.SpeedControlled_y.In addition, the performance data of all movers are now stored in a record. These records are in Buildings.Fluid.Movers.Data. For most existing
instances, it should be sufficient to enclose the existing
performance data in a record called per. For example,
See the Buildings.Fluid.Movers.UsersGuide for more
information about these records.For Dymola, the conversion script will update existing models to use the old implementations which are now in the package Buildings.Obsolete.Fluid.Movers. |
| Buildings.Media | |
| Buildings.Media | Renamed all media to simplify the media selection. For typical
building energy simulation, Buildings.Media.Air and
Buildings.Media.Water should be used.The following changes were made. Renamed Buildings.Media.GasesPTDecoupled.MoistAirUnsaturatedto Buildings.Media.Air.Renamed Buildings.Media.ConstantPropertyLiquidWaterto Buildings.Media.Water.Renamed Buildings.Media.PerfectGases.MoistAirto Buildings.Obsolete.Media.PerfectGases.MoistAir.Renamed Buildings.Media.GasesConstantDensity.MoistAirUnsaturatedto Buildings.Obsolete.Media.GasesConstantDensity.MoistAirUnsaturated.Renamed Buildings.Media.GasesConstantDensity.MoistAirto Buildings.Obsolete.Media.GasesConstantDensity.MoistAir.Renamed Buildings.Media.GasesConstantDensity.SimpleAirto Buildings.Obsolete.Media.GasesConstantDensity.SimpleAir.Renamed Buildings.Media.IdealGases.SimpleAirto Buildings.Obsolete.Media.IdealGases.SimpleAir.Renamed Buildings.Media.GasesPTDecoupled.MoistAirto Buildings.Obsolete.Media.GasesPTDecoupled.MoistAir.Renamed Buildings.Media.GasesPTDecoupled.SimpleAirto Buildings.Obsolete.Media.GasesPTDecoupled.SimpleAir.For Dymola, the conversion script will update existing models according to the above list. |
| Buildings.Media.Water | Removed option to model water as a compressible medium as this option was not useful. |
| Buildings.ThermalZones | |
| Buildings.ThermalZones.Detailed.BaseClasses.ParameterConstructionWithWindow | Removed the keyword replaceable for
the parameters ove and sidFin.Models that instantiate Buildings.ThermalZones.Detailed.MixedAir are not
affected by this change. |
| Buildings.ThermalZones.Detailed.Examples.BESTEST | Moved the package to
Buildings.ThermalZones.Detailed.Validation.BESTEST. |
| Buildings.Utilities | |
| Buildings.Utilities.SimulationTime | Moved the block
Buildings.Utilities.SimulationTime to
Buildings.Utilities.Time.ModelTime.For Dymola, the conversion script will update existing models according to the above list. |
The following critical errors have been fixed (i.e., errors that can lead to wrong simulation results):
| Buildings.BoundaryConditions | |
| Buildings.BoundaryConditions.WeatherData.ReaderTMY3 | Corrected error that led the total and opaque sky cover to be ten times too low if its value was obtained from the parameter or the input connector. For the standard configuration in which the sky cover is obtained from the weather data file, the model was correct. This error only affected the other two possible configurations. |
| Buildings.Fluid | |
| Buildings.Fluid.Data.Pipes | Corrected wrong entries for inner and outer diameter of PEX pipes. |
| Buildings.Fluid.Geothermal.Boreholes.BaseClasses.singleUTubeResistances | Corrected error in function that used
beta before it was assigned a value. |
| Buildings.Fluid.Storage.Stratified Buildings.Fluid.Storage.StratifiedEnhanced Buildings.Fluid.Storage.StratifiedEnhancedInternalHex |
Replaced the use of
Medium.lambda_const with
Medium.thermalConductivity(sta_default) as
lambda_const is not declared for all media. This
avoids a translation error if certain media are used. |
| Buildings.Fluid.Storage.StratifiedEnhancedInternalHex | Corrected issue #271 which led to a compilation error if the heat exchanger and the tank had different media. |
| Buildings.HeatTransfer | |
| Buildings.HeatTransfer.Windows.BaseClasses.GlassLayer | Corrected issue #304 that led to an error in the glass temperatures if the glass conductance is very small. |
| Buildings.ThermalZones | |
| Buildings.ThermalZones.Detailed.MixedAir | Added propagation of the parameter value
linearizeRadiation to the window model. Prior to this
change, the radiation was never linearized for computing the glass
long-wave radiation. |
|
Buildings.ThermalZones.Detailed.FLEXLAB.Rooms.Examples.X3WithRadiantFloor Buildings.ThermalZones.Detailed.FLEXLAB.Rooms.Examples.X3AWithRadiantFloor Buildings.ThermalZones.Detailed.FLEXLAB.Rooms.Examples.X3BWithRadiantFloor |
Corrected wrong entries for inner and outer diameter of PEX pipes. |
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.FixedResistances.FixedResistanceDpM | Corrected error in documentation of computation of
k. |
| Buildings.HeatTransfer | |
| Buildings.HeatTransfer.Windows.BaseClasses.GlassLayer | Changed type of tauIR from
Modelica.Units.SI.Emissivity to
Modelica.Units.SI.TransmissionCoefficient. This avoids
a type error in OpenModelica. |
Note:
With version 2.0, we start using semantic versioning as described at http://semver.org/.