.Buildings.UsersGuide.ReleaseNotes.Version_1_1_build1 .Buildings.UsersGuide.ReleaseNotes.Version_1_1_build1Version 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.