modelLoad
Model of a load on a hydronic circuit
Extends from Buildings.Fluid.Interfaces.PartialTwoPortInterface.
Information
This model represents a thermal load on a hydronic circuit, typically
a terminal unit with recirculating air such as a fan coil unit. It takes the
fraction of the design load u as input and returns the control
valve demand signal yVal as output.
Modeling assumptions
The design pressure drop on the source side may be specified with
the parameter dpLiq_nominal.
The inlet conditions on the load side are constant and equal
to the design conditions. The mass flow rate is modulated based on the input
signal u, with a minimum value of u_min.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Buildings.Fluid.HydronicConfigurations.Types.Control | typ | Load type | |
| Modelica.Units.SI.MassFlowRate | mLiq_flow_nominal | 1 | Liquid mass flow rate at design conditions |
| Modelica.Units.SI.PressureDifference | dpLiq_nominal | 0 | Liquid pressure drop at design conditions |
| Modelica.Units.SI.MassFlowRate | mAir_flow_nominal | abs(Q_flow_nominal)/10/cpAir_nominal | Air mass flow rate at design conditions |
| Modelica.Units.SI.Temperature | TAirEnt_nominal | if typ == Buildings.Fluid.HydronicConfigurations.Types.Control.Heating then 20 + 273.15 else 26 + 273.15 | Air entering temperature at design conditions |
| Modelica.Units.SI.MassFraction | phiAirEnt_nominal | 0.5 | Air entering relative humidity at design conditions |
| Modelica.Units.SI.MassFraction | XAirEnt_nominal | Buildings.Utilities.Psychrometrics.Functions.X_pTphi(MediumAir.p_default, TAirEnt_nominal, phiAirEnt_nominal) | Air entering water mass fraction at design conditions (kg/kg air) |
| Modelica.Units.SI.MassFraction | xAirEnt_nominal | XAirEnt_nominal/(1 - XAirEnt_nominal) | Air entering humidity ratio at design conditions (kg/kg dry air) |
| Modelica.Units.SI.Temperature | TLiqEnt_nominal | if typ == Buildings.Fluid.HydronicConfigurations.Types.Control.Heating then 60 + 273.15 else 7 + 273.15 | Liquid entering temperature at design conditions |
| Modelica.Units.SI.Temperature | TLiqLvg_nominal | TLiqEnt_nominal + (if typ == Buildings.Fluid.HydronicConfigurations.Types.Control.Heating then -10 else +5) | Liquid leaving temperature at design conditions |
| Modelica.Units.SI.HeatFlowRate | Q_flow_nominal | (MediumLiq.specificEnthalpy_pTX(MediumLiq.p_default, TLiqEnt_nominal, X = MediumLiq.X_default) - MediumLiq.specificEnthalpy_pTX(MediumLiq.p_default, TLiqLvg_nominal, X = MediumLiq.X_default))*mLiq_flow_nominal | Transmitted heat flow rate at design conditions |
| Real | u_min | 0.1 | Minimum fan speed |
| Valve controller | |||
| Buildings.Controls.OBC.CDL.Types.SimpleController | controllerType | Buildings.Controls.OBC.CDL.Types.SimpleController.PI | Type of controller |
| Real | k | 0.1 | Gain of controller |
| Real | Ti | 10 | Time constant of integrator block |
| Real | Td | 0.1 | Time constant of derivative block |
| Dynamics › Conservation equations | |||
| Modelica.Fluid.Types.Dynamics | energyDynamics | Modelica.Fluid.Types.Dynamics.FixedInitial | Type of energy balance: dynamic (3 initialization options) or steady state |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | u | Fraction of design load | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanInput | u1 | System enable | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | yVal | Valve demand signal | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | dTLiq | Liquid deltaT | |
| Buildings.Fluid.Sources.Boundary_pT | outAir | Pressure boundary condition at coil outlet | |
| Buildings.Fluid.Sensors.TemperatureTwoPort | TAirLvg | Leaving air temperature sensor | |
| Buildings.Fluid.HeatExchangers.WetCoilEffectivenessNTU | coi | Coil | |
| Buildings.Fluid.Sources.MassFlowSource_T | souAir | Source for entering air | |
| Buildings.Controls.OBC.Utilities.PIDWithEnable | conPID | Controller | |
| Buildings.Fluid.Sensors.TemperatureTwoPort | TLiqEnt | Entering liquid temperature sensor | |
| Buildings.Fluid.Sensors.TemperatureTwoPort | TLiqLvg | Leaving liquid temperature sensor | |
| Buildings.Controls.OBC.CDL.Reals.Subtract | dT | Compute deltaT | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | Q_flow | Total heat flow rate transferred to the load | |
| Modelica.Blocks.Sources.RealExpression | heaFlo | Access coil heat flow rate | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | yLoa_actual | Actual load fraction met | |
| Modelica.Blocks.Sources.RealExpression | loaFra | Compute actual load fraction | |
| Buildings.Controls.OBC.CDL.Reals.Sources.Constant | uMin | Minimum speed | |
| Buildings.Controls.OBC.CDL.Reals.Max | max1 | Maximum of control signal and minimum speed | |
| Buildings.Controls.OBC.CDL.Conversions.BooleanToReal | enaRea | Cast enable signal to real | |
| Buildings.Controls.OBC.CDL.Reals.Multiply | mul | Zero out control signal if system is disabled | |
| Buildings.Controls.OBC.CDL.Reals.MultiplyByParameter | modMAir | Scale with design flow |
Contents
| Name | Description |
|---|---|
| MediumAir | Medium model for air |
| MediumLiq | Medium model for liquid (CHW or HHW) |
Revisions
-
December 8, 2025, by Antoine Gautier:
First implementation.