.Buildings.UsersGuide.ReleaseNotes.Version_11_0_0 .Buildings.UsersGuide.ReleaseNotes.Version_11_0_0Version 11.0.0 is a major release that adds various new packages and models.
The library has been tested with Dymola 2024x, OpenModelica 1.22.1-1, OPTIMICA 1.48.2 and recent versions of Impact.
The following major changes have been done compared to release 10.1.0:
Buildings.Templates.Plants.HeatPumps. The package
allows configuration of the type of hydronic integration.Buildings.Experimental.DHC to
Buildings.DHC.Buildings.DHC.Loads.HotWater.Buildings.Examples.Tutorial.SimpleHouse.The following new libraries have been added:
| Buildings.Templates.Plants | Package with template models for central plants with air-to-water reversible heat pumps, including the plant closed loop control. |
| Buildings.Examples.Tutorial.SimpleHouse | Tutorial for how to build a simple system model. |
| Buildings.DHC.Loads.HotWater | Package of models for domestic hot water generation and loads served by district networks. This is for issue 3063. |
The following new components have been added to existing libraries:
| Buildings.DHC.ETS.Combined | |
| Buildings.DHC.ETS.Combined.BaseClasses.PartialHeatPumpHeatExchanger | Created partial base class to support two versions of the energy transfer station. One that heats domestic hot water with a heat pump, and one that heats domestic hot water with a heat pump plus storage tank and heat exchanger. This is for issue 3063. |
| Buildings.DHC.ETS.Combined.HeatPumpHeatExchangerDHWTank | Version of Buildings.DHC.ETS.Combined.HeatPumpHeatExchanger that heats domestic hot water with a heat pump plus storage tank and heat exchanger. This is for issue 3063. |
| Buildings.DHC.ETS.Combined.Subsystems.BaseClasses.PartialHeatPump | Partial base class to support two versions of heat pump subsystem. One which directly heats water through condenser, and one which uses the heat pump to heat water in a storage tank, which can be circulated to heat water through a heat exchanger. This is for issue 3063. |
| Buildings.DHC.ETS.Combined.Subsystems.HeatPumpDHWTank | Uses a heat pump to heat water in a storage tank, which can be circulated to heat domestic hot water through a heat exchanger, modeled with Buildings.DHC.Loads.HotWater.StorageTankWithExternalHeatExchanger. This is for issue 3063. |
| Buildings.DHC.Loads.Combined.BuildingTimeSeriesWithETSWithDHWTank | Similar to Buildings.DHC.Loads.Combined.BuildingTimeSeriesWithETS, but uses Buildings.DHC.ETS.Combined.HeatPumpHeatExchangerDHWTank as the ETS. This is for issue 3063. |
| Buildings.DHC.Loads.Combined.Examples.BuildingTimeSeriesWithETSDHWTank | Example model for use of Buildings.DHC.Loads.Combined.BuildingTimeSeriesWithETSWithDHWTank. This is for issue 3063. |
| Buildings.Fluid.FixedResistances.BuriedPipes.PipeGroundCoupling | Ground coupling model Buildings.Fluid.FixedResistances.BuriedPipes.PipeGroundCoupling. This is for issue 3431. |
| Buildings.DHC.Networks | |
| Buildings.DHC.Networks.Distribution1Pipe_R | Added Buildings.DHC.Networks.Distribution1Pipe_R. One pipe distribution network that uses autosize pipes for supply and lossless for connection. This is for issue 3694. |
| Buildings.DHC.Networks.Distribution1PipePlugFlow_v | Added Buildings.DHC.Networks.Distribution1PipePlugFlow_v. One pipe distribution network that uses plugflow pipes for supply and lossless for connection. This is for issue 3694. |
| Buildings.DHC.Networks.Distribution2Pipe_R | Added Buildings.DHC.Networks.Distribution2Pipe_R. Two pipes network that uses autosize pipes for supply and return, and lossless for connection. This is for issue 3694. |
| Buildings.DHC.Networks.Connections | |
| Buildings.DHC.Networks.Connections.Connection1Pipe_R | Added Buildings.DHC.Networks.Connections.Connection1Pipe_R. One pipe connection model using autosize pipes for supply and lossless for connection. This is for issue 3694. |
| Buildings.DHC.Networks.Connections.Connection1PipePlugFlow_v | Added Buildings.DHC.Networks.Connections.Connection1PipePlugFlow_v. One pipe connection model using plugflow pipes for supply and lossless for connection. This is for issue 3694. |
| Buildings.DHC.Networks.Connections.Connection2Pipe_R | Added Buildings.DHC.Networks.Connections.Connection2Pipe_R. Two pipes connection model using autosize pipes for supply and return, lossless for connection. This is for issue 3694. |
| Buildings.DHC.Networks.Connections.Examples.Connection1PipeExample | Added Buildings.DHC.Networks.Connections.Examples.Connection1PipeExample. Example model for one pipe connections. This is for issue 3694. |
| Buildings.DHC.Networks.Connections.Examples.Connection2PipeExample | Added Buildings.DHC.Networks.Connections.Examples.Connection2PipeExample. Example model for two pipes connections. This is for issue 3694. |
| Buildings.DHC.Networks.Controls | |
| Buildings.DHC.Networks.Controls.AgentPump1Pipe | Added Buildings.DHC.Networks.Controls.AgentPump1Pipe. Agent controller (i.e. borefield, waste heat plant) for one pipe networks. This is for issue 3694. |
| Buildings.DHC.Networks.Controls.Examples.AgentPump1PipeExample | Added Buildings.DHC.Networks.Controls.Examples.AgentPump1PipeExample. Example model for AgentPump1Pipe. This is for issue 3694. |
| Buildings.DHC.Networks.Controls.Examples.MainPump1PipeExample | Added Buildings.DHC.Networks.Controls.Examples.MainPump1PipeExample. Example model for MainPump1PipeExample. This is for issue 3694. |
| Buildings.DHC.Examples.Combined | |
| Buildings.DHC.Examples.Combined.SeriesVariableFlowAgentControl | Added Buildings.DHC.Examples.Combined.SeriesVariableFlowAgentControl. This example model showcases a more sophisticated way of controlling district agent pumps. This is for issue 3431. |
| Buildings.Utilities.Math | |
| Buildings.Utilities.Math.Interpolate Buildings.Utilities.Math.Examples.Interpolate |
Created a block with an example model for Buildings.Utilities.Math.Functions.interpolate. This is for IBPSA, #1844. |
The following existing components have been improved in a backward compatible way:
| Buildings.Controls.OBC.ASHRAE.G36 | |
| Buildings.Controls.OBC.ASHRAE.G36.AHUs.MultiZone.VAV.Controller | Added 2-position relief damper position output
y1RelDam.This is for issue 3526. |
| Buildings.Controls.OBC.CDL | |
| All classes | Expanded interface class names to full class names
for all classes within
Buildings.Controls.OBC.CDL.This is for #3746. |
| Buildings.Controls.OBC.CDL.Discrete.Examples | Changed the package name from
Examples to Validation.This is for issue 3517. |
| Buildings.Fluid.Interfaces | |
| Buildings.Fluid.Interfaces.PartialFourPort Buildings.Fluid.Interfaces.PartialTwoPort Buildings.Fluid.Interfaces.PartialTwoPortVector |
Changed implementation to allow moving fluid
connector. This accomodates implementation of models that should
have connectors on the top and bottom (such as a tank) and moving
of connectors for models that need larger icons. This is for IBPSA, #1781. |
| Buildings.DHC.ETS.Heating | |
| Buildings.DHC.ETS.Heating.Direct | Documentation corrected for heating. This is for issue 3628. |
| Buildings.DHC.ETS.Heating.Indirect | Documentation corrected for heating. This is for issue 3628. |
| Buildings.Templates | |
| Buildings.Templates.Components.Fans.ArrayVariable | Refactored with flow rate multiplier. This is for #3536. |
| Buildings.ThermalZones.EnergyPlus_9_6_0 | |
| Buildings.ThermalZones.EnergyPlus_9_6_0.Building | Introduced parameter
setInitialRadiativeHeatGainToZero and refactored
radiative heat exchange between Modelica and EnergyPlus. This was
done to avoid iterative solutions between Modelica and EnergyPlus
for some coupled simulations that exchange radiative heat transfer,
such as from a hydronic radiator. For details, see info section in
Buildings.ThermalZones.EnergyPlus_9_6_0.Building.This is for Buildings, #3707. |
|
Buildings.ThermalZones.EnergyPlus_9_6_0.Examples.SingleFamilyHouse.AirHeating Buildings.ThermalZones.EnergyPlus_9_6_0.Examples.SingleFamilyHouse.HeatPumpRadiantHeatingGroundHeatTransfer Buildings.ThermalZones.EnergyPlus_9_6_0.Examples.SingleFamilyHouse.RadiantHeatingCooling_TRoom Buildings.ThermalZones.EnergyPlus_9_6_0.Examples.SingleFamilyHouse.RadiantHeatingCooling_TSurface Buildings.ThermalZones.EnergyPlus_9_6_0.Examples.SingleFamilyHouse.Radiator |
Added insulation to EnergyPlus input data file and
resized the system. This is for #3707. |
| Buildings.ThermalZones.EnergyPlus_9_6_0.ThermalZone | Changed radiative heat flow rate sent to
EnergyPlus to be the average over the last synchronization time
step rather than the instantaneuous value, and set it by default to
zero during the initialization. This avoids a nonlinear system of
equation during the time integration for models in which the
radiative heat gain is a function of the room radiative
temperature, such as when a radiator is connected to the room
model. This is for Buildings, #3707. |
| Buildings.ThermalZones.ReducedOrder | |
|
Buildings.ThermalZones.ReducedOrder.EquivalentAirTemperature.VDI6007 Buildings.ThermalZones.ReducedOrder.EquivalentAirTemperature.VDI6007 |
Changed implementation to allow ground temperature
to be taken from an input rather than using a constant value. This is for IBPSA, #1744. |
| Buildings.DHC.ETS.BaseClasses | |
| Buildings.DHC.ETS.BaseClasses.Pump_m_flow | Updated pump model to use to Buildings.Fluid.Movers.Preconfigured.FlowControlled_m_flow . This change allows to have a better estimation of pump default curve using euler number. This is for issue 3431. |
| Buildings.DHC.ETS.Combined.BaseClasses.PartialHeatPumpHeatExchanger | Reduced swiFlo.dpValve_nominal to
numerically zero to avoid reverse flow. This is for issue
3431. |
| Buildings.DHC.ETS.Combined.Subsystems.BaseClasses | |
| Buildings.DHC.ETS.Combined.Subsystems.BaseClasses.PartialHeatPump | Converted heat pump model to dynamic by changing
heaPum.energyDynamics to
Modelica.Fluid.Types.Dynamics.FixedInitial and added
junction on recirculation loop. This is for issue
3431. |
| Buildings.DHC.Examples.Combined | |
| Buildings.DHC.Examples.Combined.SeriesConstantFlow | Added connections that were removed in Buildings.DHC.Examples.Combined.BaseClasses.PartialSeries . This is for issue 3431. |
| Buildings.DHC.Examples.Combined.SeriesVariableFlow | Added connections that were removed in Buildings.DHC.Examples.Combined.BaseClasses.PartialSeries . This is for issue 3431. |
The following existing components have been improved in a non-backward compatible way:
| Buildings.Controls.OBC.CDL | |
| Buildings.Controls.OBC.CDL.Reals.Sources.ModelTime | Renamed the block to CivilTime.This is for issue 3596. |
| Buildings.Controls.OBC.CDL.Logical.TrueHoldWithReset | Renamed the block to TrueHold.This is for issue 3689. |
| Buildings.Controls.OBC.CDL.Logical.Or3 Buildings.Controls.OBC.CDL.Logical.ZeroCrossing Buildings.Controls.OBC.CDL.Logical.OnOffController Buildings.Controls.OBC.CDL.Logical.TriggeredTrapezoid |
Moved the block to the Obsolete
package.This is for issue 3595. |
| Buildings.Controls.OBC.ASHRAE.G36 | |
| Buildings.Controls.OBC.ASHRAE.G36.TerminalUnits | Added coil type enumeration and removed the coil
type flags. This is for issue 3526. |
| Buildings.Controls.OBC.ASHRAE.G36.AHUs.MultiZone.VAV.Controller | Removed the connectors uCooCoi_actual
and uHeaCoi_actual, added coil type enumeration and
removed the coil type flags.This is for issue 3526. |
| Buildings.DHC | |
| Buildings.Experimental.DHC | The package was renamed to
Buildings.DHC, and the package
DHC.EnergyTransferStations was renamed to
DHC.ETS.This change is supported in the conversion script. |
| Buildings.DHC.ETS.BaseClasses.PartialDirect | Change input TSetDisRet to
TDisRetSet. |
| Buildings.DHC.ETS.BaseClasses.PartialIndirect | Change input TSetBuiSup to
TBuiSupSet. |
| Buildings.DHC.ETS.Combined.HeatPumpHeatExchanger | Extend from new partial base class Buildings.DHC.ETS.Combined.BaseClasses.PartialHeatPumpHeatExchanger. Evaporator water flow through space heating and domestic how water heat pumps is constant, with dT across district supply and return controlled by three-way mixing valve. This is for issue 3063. |
| Buildings.DHC.ETS.Combined.Subsystems.HeatPump | Extend from new partial base class Buildings.DHC.ETS.Combined.Subsystems.BaseClasses.PartialHeatPump. Evaporator water flow through heat pump is constant, with dT across district supply and return controlled by three-way mixing valve. This is for issue 3063. |
| Buildings.DHC.ETS.Combined.Subsystems.Validation.HeatPump | Validation test for Buildings.DHC.ETS.Combined.Subsystems.HeatPump. This is for issue 3063. |
| Buildings.DHC.ETS.Combined.Subsystems.Validation.HeatPumpDHWTank | Validation test for Buildings.DHC.ETS.Combined.Subsystems.HeatPumpDHWTank. This is for issue 3063. |
| Buildings.DHC.Loads.Combined.BuildingTimeSeriesWithETS | Updated to use new version of Buildings.DHC.ETS.Combined.HeatPumpHeatExchanger as the ETS. This is for issue 3063. |
| Buildings.DHC.Plants.Combined.Subsystems.BaseClasses.MultipleCommands | The class has been moved to
Buildings.Templates.Components.Controls.MultipleCommands. This is for #3536. This change is supported in the conversion script. |
| Buildings.DHC.Plants.Reservoir.Borefield | Moved to
Buildings.DHC.Examples.Combined.BaseClasses.Borefield . This is for #3628. This change is supported in the conversion script. |
| Buildings.Fluid.SolarCollectors | |
| Buildings.Fluid.SolarCollectors.ASHRAE93 Buildings.Fluid.SolarCollectors.EN12975 |
Changed assignment of
computeFlowResistance to final based on
dp_nominal.This is for Buildings, #3597. This change is supported in the conversion script. |
| Buildings.Obsolete | |
| Buildings.Obsolete.Utilities.IO.Python36 | Removed package. This is for #3506. |
| Buildings.Templates | |
|
Buildings.Templates.AirHandlersFans.Data.PartialAirHandler Buildings.Templates.AirHandlersFans.Data.VAVMultiZone Buildings.Templates.AirHandlersFans.Interfaces.PartialAirHandler Buildings.Templates.AirHandlersFans.VAVMultiZone Buildings.Templates.ZoneEquipment.Data.PartialAirTerminal Buildings.Templates.ZoneEquipment.Data.VAVBox Buildings.Templates.ZoneEquipment.Interfaces.PartialAirTerminal Buildings.Templates.ZoneEquipment.Interfaces.VAVBox Buildings.Templates.ZoneEquipment.VAVBoxCoolingOnly Buildings.Templates.ZoneEquipment.VAVBoxReheat |
Refactored with a record class for configuration
parameters. This is for #3500. |
| Buildings.Templates.Components.Dampers Buildings.Templates.Components.Valves |
The models in these packages have been retired and
replaced with two container classes within
Buildings.Templates.Components.Actuators that cover
all equipment types, and allow the flow characteristic to be
specified with one parameter.This is for #3539. |
| Buildings.Fluid.Geothermal.BuriedPipes | Moved to
Buildings.Fluid.FixedResistances.BuriedPipes . This is for #3431. This change is supported in the conversion script. |
| Buildings.DHC.Networks | |
| Buildings.DHC.Networks.Connection2Pipe | Removed
Buildings.DHC.Networks.Connection2Pipe. This is for
#3694. |
| Buildings.DHC.Networks.Connection2PipePlugFlow | Moved and renamed
Buildings.DHC.Networks.Connection2PipePlugFlow to
Buildings.DHC.Networks.Connections.Connection2PipePlugFlow_v .
Also updated available paremeters for sizing and heatport
configuration. This is for issue
3694.This change is supported in the conversion script. |
| Buildings.DHC.Networks.Distribution2Pipe | Removed
Buildings.DHC.Networks.Distribution2Pipe. This is for
#3694. |
| Buildings.DHC.Networks.Connection2PipePlugFlow | Renamed
Buildings.DHC.Networks.Distribution2PipePlugFlow to
Buildings.DHC.Networks.Distribution2PipePlugFlow_v
. Also updated available paremeters for sizing and heatport
configuration. This is for issue
3694.This change is supported in the conversion script. |
| Buildings.DHC.Networks.Controls | |
| Buildings.DHC.Networks.Connection2PipePlugFlow | Renamed
Buildings.DHC.Networks.Controls.MainPump to Buildings.DHC.Networks.Controls.MainPump1Pipe
. Also updated available paremeters and documentation. This is for
issue
3694.This change is supported in the conversion script. |
| Buildings.DHC.Networks.Combined | |
| Buildings.DHC.Networks.Combined.UnidirectionalParallel | Removed
Buildings.DHC.Networks.Combined.UnidirectionalParallel.
This is for #3694. |
| Buildings.DHC.Networks.Combined.UnidirectionalSeries | Removed
Buildings.DHC.Networks.Combined.UnidirectionalSeries.
This is for #3694. |
| Buildings.DHC.Networks.Combined.BaseClasses | |
| Buildings.DHC.Networks.Combined.BaseClasses.ConnectionParallelAutosize | Removed
Buildings.DHC.Networks.Combined.BaseClasses.ConnectionParallelAutosize.
This is for #3694. |
| Buildings.DHC.Networks.Combined.BaseClasses.ConnectionParallelStandard | Removed
Buildings.DHC.Networks.Combined.BaseClasses.ConnectionParallelStandard.
This is for #3694. |
| Buildings.DHC.Networks.Combined.BaseClasses.ConnectionSeriesAutosize | Removed
Buildings.DHC.Networks.Combined.BaseClasses.ConnectionSeriesAutosize.
This is for #3694. |
| Buildings.DHC.Networks.Combined.BaseClasses.ConnectionSeriesStandard | Removed
Buildings.DHC.Networks.Combined.BaseClasses.ConnectionSeriesStandard.
This is for #3694. |
| Buildings.DHC.Networks.Combined.BaseClasses.PipeAutosize | Moved
Buildings.DHC.Networks.Combined.BaseClasses.PipeAutosize
to Buildings.DHC.Networks.Pipes.PipeAutosize.
This is for issue
3694.This change is supported in the conversion script. |
| Buildings.DHC.Networks.Combined.BaseClasses.PipeStandard | Moved
Buildings.DHC.Networks.Combined.BaseClasses.PipeStandard
to Buildings.DHC.Networks.Pipes.PipeStandard.
This is for issue
3694.This change is supported in the conversion script. |
| Buildings.DHC.Networks.Combined.BaseClasses.Validation.Pipe | Moved
Buildings.DHC.Networks.Combined.BaseClasses.Validation.Pipe
to Buildings.DHC.Networks.Pipes.Validation.Pipe.
This is for issue
3694. |
| Buildings.DHC.Examples.Combined.BaseClasses | |
| Buildings.DHC.Examples.Combined.BaseClasses.PartialSeries | Removed several connections to implement to Buildings.DHC.Examples.Combined.SeriesVariableFlowAgentControl. This is for issue 3431. |
| Buildings.Utilities.Math | |
|
Buildings.Utilities.Math.Functions.interpolate Buildings.Utilities.Math.Functions.Examples.Interpolate |
Moved these classes to Buildings.Utilities.Math.Functions
from Buildings.Airflow.Multizone.BaseClasses. This is for IBPSA, #1844. This change is supported in the conversion script. |
The following critical errors have been fixed (i.e., errors that can lead to wrong simulation results):
| Buildings.Templates | |
|
Buildings.Templates.AirHandlersFans.Components.Controls.G36VAVMultiZone Buildings.Templates.AirHandlersFans.Components.Data.OutdoorReliefReturnSection Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialOutdoorReliefReturnSection Buildings.Templates.AirHandlersFans.Components.Interfaces.PartialReliefReturnSection Buildings.Templates.AirHandlersFans.Components.OutdoorReliefReturnSection.MixedAirWithDamper Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection.NoRelief Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection.NoReturn Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection.ReliefDamper Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection.ReliefFan Buildings.Templates.AirHandlersFans.Components.ReliefReturnSection.ReturnFan Buildings.Templates.AirHandlersFans.Configuration.PartialAirHandler Buildings.Templates.AirHandlersFans.Data.VAVMultiZone Buildings.Templates.AirHandlersFans.VAVMultiZone |
Added support for additional configurations. This is for #3526 and #3520. |