Version 1.1 build 1 contains improvements to models that address numerical problems.
In particular, flow machines and actuators now have an optional filter
that converts step changes in the input signal to a smooth change in
speed or actuator position.
Also, (Buildings.Examples.Tutorial)
has been added to provide step-by-step instruction for how to build
system models.
The following new libraries have been added:
| Buildings.Examples.Tutorial | Tutorial with step by step instructions for how to build system models. |
The following new components have been added to existing libraries:
| Buildings.Fluid | |
| Buildings.Fluid.FixedResistances.Pipe | Added a model for a pipe with transport delay and optional heat exchange with the environment. |
| Buildings.Fluid.Actuators.UsersGuide | Added a user's guide for actuator models. |
| Buildings.Fluid.Interfaces.ConservationEquation Buildings.Fluid.Interfaces.StaticConservationEquation |
These base classes have been added to simplify the implementation of dynamic and steady-state thermofluid models. |
| Buildings.Fluid.Data.Fuels | Package with physical properties of fuels that are used by the boiler model. |
The following existing components have been improved in a backward compatible way:
| Buildings.Fluid | |
| Buildings.Fluid.Actuators.Dampers.Exponential Buildings.Fluid.Actuators.Dampers.VAVBoxExponential Buildings.Fluid.Actuators.Dampers.MixingBox Buildings.Fluid.Actuators.Dampers.MixingBoxMinimumFlow Buildings.Fluid.Actuators.Valves.ThreeWayEqualPercentageLinear Buildings.Fluid.Actuators.Valves.ThreeWayLinear Buildings.Fluid.Actuators.Valves.TwoWayEqualPercentage Buildings.Fluid.Actuators.Valves.TwoWayLinear Buildings.Fluid.Actuators.Valves.TwoWayQuickOpening |
Added an optional 2nd order lowpass filter for the input signal.
The filter approximates the travel time of the actuators.
It also makes the system of equations easier to solve
because a step change in the input signal causes a gradual change in the actuator
position. Note that this filter affects the time response of closed loop control. Therefore, enabling the filter may require retuning of control loops. See the user's guide of the Buildings.Fluid.Actuators package. |
| Buildings.Fluid.Boilers.BoilerPolynomial | Added computation of fuel usage and improved the documentation. |
| Buildings.Fluid.Movers.SpeedControlled_y Buildings.Fluid.Movers.SpeedControlled_Nrpm Buildings.Fluid.Movers.FlowControlled_dp Buildings.Fluid.Movers.FlowControlled_m_flow |
Added a 2nd order lowpass filter to the input signal.
The filter approximates the startup and shutdown transients of fans or pumps.
It also makes the system of equations easier to solve
because a step change in the input signal causes a gradual change in the
mass flow rate. Note that this filter affects the time response of closed loop control. Therefore, enabling the filter may require retuning of control loops. See the user's guide of the Buildings.Fluid.Movers package. |
| Buildings.Fluid.Interfaces.StaticTwoPortHeatMassExchanger | Changed model to use graphical implementation of models for pressure drop and conservation equations. |
| Buildings.Fluid.BaseClasses.PartialResistance Buildings.Fluid.FixedResistances.FixedResistanceDpM Buildings.Fluid.Actuators.BaseClasses.PartialTwoWayValve Buildings.Fluid.Actuators.BaseClasses.PartialDamperExponential |
Revised base classes and models to simplify object inheritance tree.
Set m_flow_small to final in Buildings.Fluid.BaseClasses.PartialResistance,
and removed its assignment in the other classes.
|
| Buildings.Fluid.FixedResistances.FixedResistanceDpM Buildings.Fluid.FixedResistances.SplitterFixedResistanceDpM |
Improved documentation. |
| Buildings.HeatTransfer | |
| Buildings.HeatTransfer.Windows.Functions.glassProperty | Added the function glassPropertyUncoated that calculates the property for uncoated glass.
|
| Buildings.ThermalZones | |
| Buildings.ThermalZones.Detailed.MixedAir | Changed model to use new implementation of Buildings.HeatTransfer.Radiosity.OutdoorRadiosity in its base classes. This change leads to the use of the same equations for the radiative heat transfer between window and ambient as is used for the opaque constructions. |
The following existing components have been improved in a non-backward compatible way:
| Buildings.Fluid | |
| Buildings.Fluid.Actuators.Valves.ThreeWayEqualPercentageLinear Buildings.Fluid.Actuators.Valves.ThreeWayLinear Buildings.Fluid.Actuators.Valves.TwoWayEqualPercentage Buildings.Fluid.Actuators.Valves.TwoWayLinear Buildings.Fluid.Actuators.Valves.TwoWayQuickOpening |
Changed models to allow modeling of a fixed resistance that is
within the controlled flow leg. This allows in some cases
to avoid a nonlinear equation if a flow resistance is
in series to the valve.
This change required changing the parameter for the valve resistance
dp_nominal to dpValve_nominal,
and introducing the parameter
dpFixed_nominal, with dpFixed_nominal=0
as its default value.
Previous models that instantiate these components need to change the
assignment of dp_nominal to an assignment of
dpValve_nominal.
See also Buildings.Fluid.Actuators.UsersGuide.
|
| Buildings.HeatTransfer | |
| Buildings.HeatTransfer.Radiosity.OutdoorRadiosity Buildings.HeatTransfer.Windows.ExteriorHeatTransfer |
Changed model to use new implementation of Buildings.HeatTransfer.Radiosity.OutdoorRadiosity. This change leads to the use of the same equations for the radiative heat transfer between window and ambient as is used for the opaque constructions. |
| Buildings.Controls | |
| Buildings.Controls.SetPoints.OccupancySchedule | Changed model to fix a bug that caused the output of the block
to be incorrect when the simulation started
at a time different from zero.
When fixing this bug, the parameter startTime was removed,
and the parameter endTime was renamed to period.
The period always starts at t=0 seconds.
|
The following critical errors have been fixed (i.e., errors that can lead to wrong simulation results):
| Buildings.Controls | |
| Buildings.Controls.SetPoints.OccupancySchedule | The output of the block was incorrect when the simulation started at a time different from zero. |
| Buildings.Fluid.HeatExchangers | |
| Buildings.Fluid.HeatExchangers.DryCoilCounterFlow Buildings.Fluid.HeatExchangers.WetCoilCounterFlow |
Corrected error in assignment of dp2_nominal.
The previous assignment caused a pressure drop in all except one element,
instead of the opposite. This caused too high a flow resistance
of the heat exchanger.
|
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.BoundaryConditions | |
| Buildings.BoundaryConditions.SkyTemperature.BlackBody | Fixed error in BlackBody model that was causing a translation error when calTSky was set to Buildings.BoundaryConditions.Types.SkyTemperatureCalculation.HorizontalRadiation.
|
| Buildings.Fluid | |
| Buildings.Fluid.Interfaces.TwoPortHeatMassExchanger | Fixed wrong class reference in information section. |
| Buildings.Utilities | |
| Buildings.Utilities.IO.BCVTB.Examples.MoistAir | Updated fan parameters, which were still for version 0.12 of the Buildings library and hence caused a translation error with version 1.0 or higher. |
The following issues have been fixed:
| Exterior longwave radiation exchange in window model | |
| #51 | Changed model to use new implementation of Buildings.HeatTransfer.Radiosity.OutdoorRadiosity. This change leads to the use of the same equations for the radiative heat transfer between window and ambient as is used for the opaque constructions. |
| #53 | Fixed bug in Buildings.Controls.SetPoints.OccupancySchedule that led to wrong results when the simulation started at a time different from zero. |
Note:
Buildings.Fluid.Actuators.UsersGuide
and
Buildings.Fluid.Movers.UsersGuide for recommended control
gains and further details.