modelDecoupling

Decoupling circuit with self-acting Delta-p control valve

Extends from Fluid.HydronicConfigurations.Interfaces.PartialHydronicConfiguration.

Information

Summary

This configuration (see schematic below) is used for variable flow primary and consumer circuits where the consumer circuit has the same supply temperature set point as the primary circuit. The fixed bypass prevents the primary pressure differential from being transmitted to the consumer circuit. This allows a proper operation of the terminal control valves on the consumer side when the primary pressure differential is either too low or too high or varying too much. The self-acting Δp control valve maintains a nearly constant bypass mass flow rate, set by default to 5% of the consumer circuit design mass flow rate.

Schematic

The following table presents the main characteristics of this configuration.

Primary circuit Variable flow
Secondary (consumer) circuit Variable flow
Typical applications Same consumer circuit supply temperature set point as primary circuit
(Otherwise use either this model in conjunction with Buildings.Fluid.HydronicConfigurations.PassiveNetworks.SingleMixing, or Buildings.Fluid.HydronicConfigurations.ActiveNetworks.InjectionTwoWay)
Primary pressure differential either too low or too high or varying too much such as in DHC systems
Non-recommended applications Heating systems with condensing boilers due to the recirculating primary flow rate
(Since the recirculating primary flow rate is controlled to a nearly constant value, this configuration is used in DHC systems.)
Built-in valve control options Self-acting Δp control valve with a proportional band of ±20% around the pressure differential set point
Control valve selection
(See the nomenclature in the schematic.)
β = ΔpA-B / (Δp1 + ΔpA-J) ≈ ΔpA-B / Δp1
The valve is sized with a pressure drop of Δp1 / 2 for a mass flow rate 5 to 10% higher than m2_flow_nominal.
Balancing requirement The design pressure drop of the bypass balancing valve dpBal3_nominal is typically around 10 kPa for a mass flow rate of m1_flow_nominal-m2_flow_nominal. No primary balancing valve is needed in addition to the self-acting Δp control valve.
(For an actuated control valve with external controls, the same balancing requirements as for Buildings.Fluid.HydronicConfigurations.ActiveNetworks.InjectionTwoWay hold. No bypass balancing valve is needed.)
Lumped flow resistance includes
(With the setting use_lumFloRes=true.)
Control valve val and primary balancing valve res1

Additional comments

The P-controller used in the model mimics a self-acting Δp control valve with a proportional band of ±20% around the pressure differential set point. This set point corresponds to the design pressure drop of the bypass balancing valve. Note that this configuration yields a nearly constant bypass mass flow rate, as opposed to a constant percentage of the consumer circuit mass flow rate provided by a control based on the return temperature upstream and downstream of the bypass. However, as illustrated in Buildings.Fluid.HydronicConfigurations.ActiveNetworks.Examples.DecouplingTemperature the latter control logic is flawed at low load, and the primary mass flow rate potentially maxed out. Since there is no standard strategy to counteract that effect, the configuration with built-in controls based on return temperature is not included in this package.

The specific built-in control option implemented in this model does not depend on the actual function of the consumer circuit (such as cooling, heating, or change-over). Therefore, the model remains the same whatever the value assigned to the parameter typCtl except if None (no built-in controls) is selected. In that latter case only, no built-in controls are included and the user must connect a control signal to modulate the valve.

For consumer circuits with a different supply temperature set point, this configuration is sometimes used in conjunction with Buildings.Fluid.HydronicConfigurations.PassiveNetworks.SingleMixing, see the example Buildings.Fluid.HydronicConfigurations.ActiveNetworks.Examples.DecouplingMixing.

Parameters

TypeNameDefaultDescription
Realn (from PartialHydronicConfiguration)2Flow exponent, n1=1 for laminar, n1=2 for turbulent
Movers.Data.GenericperPum (from PartialHydronicConfiguration)
Configuration
Booleanuse_siz (from PartialHydronicConfiguration)trueSet to true for built-in sizing of control valve and optional pump
Booleanuse_dp1 (from PartialHydronicConfiguration)Set to true to enable dp1_nominal
Booleanuse_dp2 (from PartialHydronicConfiguration)Set to true to enable dp2_nominal
Buildings.Fluid.HydronicConfigurations.Types.ValvetypVal (from PartialHydronicConfiguration)Type of control valve
Booleanhave_typVar (from PartialHydronicConfiguration)trueSet to true to enable the choice of the controlled variable
Nominal condition
Modelica.Units.SI.MassFlowRatem1_flow_nominal (from PartialHydronicConfiguration)Mass flow rate in primary circuit at design conditions
Modelica.Units.SI.MassFlowRatem2_flow_nominal (from PartialHydronicConfiguration)Mass flow rate in consumer circuit at design conditions
Modelica.Units.SI.PressureDifferencedp1_nominal (from PartialHydronicConfiguration)Primary circuit pressure differential at design conditions
Modelica.Units.SI.PressureDifferencedp2_nominal (from PartialHydronicConfiguration)Consumer circuit pressure differential at design conditions
Control valve
Buildings.Fluid.HydronicConfigurations.Types.ValveCharacteristictypCha (from PartialHydronicConfiguration)Buildings.Fluid.HydronicConfigurations.Types.ValveCharacteristic.EqualPercentageControl valve characteristic
Modelica.Units.SI.PressureDifferencedpValve_nominal (from PartialHydronicConfiguration)Control valve pressure drop at design conditions
Actuators.Valves.Data.GenericflowCharacteristics (from PartialHydronicConfiguration)Table with flow characteristics
Actuators.Valves.Data.GenericflowCharacteristics1 (from PartialHydronicConfiguration)Table with flow characteristics for direct flow path at port_1
Actuators.Valves.Data.GenericflowCharacteristics3 (from PartialHydronicConfiguration)Table with flow characteristics for bypass flow path at port_3
Pump
Buildings.Fluid.HydronicConfigurations.Types.PumptypPum (from PartialHydronicConfiguration)Buildings.Fluid.HydronicConfigurations.Types.Pump.VariableInputType of secondary pump
Buildings.Fluid.HydronicConfigurations.Types.PumpModeltypPumMod (from PartialHydronicConfiguration)Buildings.Fluid.HydronicConfigurations.Types.PumpModel.SpeedType of pump model
Modelica.Units.SI.MassFlowRatemPum_flow_nominal (from PartialHydronicConfiguration)m2_flow_nominalPump head at design conditions
Modelica.Units.SI.PressureDifferencedpPum_nominal (from PartialHydronicConfiguration)dp2_nominal + dpBal2_nominalPump head at design conditions
Controls
Buildings.Fluid.HydronicConfigurations.Types.ControltypCtl (from PartialHydronicConfiguration)Buildings.Fluid.HydronicConfigurations.Types.Control.NoneType of built-in controls
Buildings.Fluid.HydronicConfigurations.Types.ControlVariabletypVar (from PartialHydronicConfiguration)Buildings.Fluid.HydronicConfigurations.Types.ControlVariable.SupplyTemperatureControlled variable
Buildings.Controls.OBC.CDL.Types.SimpleControllercontrollerType (from PartialHydronicConfiguration)Buildings.Controls.OBC.CDL.Types.SimpleController.PIType of controller
Realk (from PartialHydronicConfiguration)0.1Gain of controller
RealTi (from PartialHydronicConfiguration)120Time constant of integrator block
Assumptions
Booleanuse_lumFloRes (from PartialHydronicConfiguration)trueSet to true to use a lumped flow resistance when possible
BooleanallowFlowReversal (from PartialHydronicConfiguration)true= false to simplify equations, assuming, but not enforcing, no flow reversal for medium 1
Balancing valves
Modelica.Units.SI.PressureDifferencedpBal1_nominal (from PartialHydronicConfiguration)0Primary balancing valve pressure drop at design conditions
Modelica.Units.SI.PressureDifferencedpBal2_nominal (from PartialHydronicConfiguration)0Secondary balancing valve pressure drop at design conditions
Modelica.Units.SI.PressureDifferencedpBal3_nominal (from PartialHydronicConfiguration)0Bypass balancing valve pressure drop at design conditions
Dynamics › Conservation equations
Modelica.Fluid.Types.DynamicsenergyDynamics (from PartialHydronicConfiguration)Modelica.Fluid.Types.Dynamics.FixedInitialType of energy balance: dynamic (3 initialization options) or steady state
Advanced › Diagnostics
Booleanshow_T (from PartialHydronicConfiguration)false= true, if actual temperature at port is computed

Connectors

TypeNameDefaultDescription
Modelica.Fluid.Interfaces.FluidPort_aport_a1 (from PartialHydronicConfiguration)Primary supply port
Modelica.Fluid.Interfaces.FluidPort_bport_b1 (from PartialHydronicConfiguration)Primary return port
Modelica.Fluid.Interfaces.FluidPort_aport_a2 (from PartialHydronicConfiguration)Secondary return port
Modelica.Fluid.Interfaces.FluidPort_bport_b2 (from PartialHydronicConfiguration)Secondary supply port
Buildings.Controls.OBC.CDL.Interfaces.RealInputyVal (from PartialHydronicConfiguration)Valve control signal
Buildings.Controls.OBC.CDL.Interfaces.RealInputset (from PartialHydronicConfiguration)Set point
Buildings.Controls.OBC.CDL.Interfaces.RealInputyPum (from PartialHydronicConfiguration)Pump control signal (variable speed)
Buildings.Controls.OBC.CDL.Interfaces.IntegerInputmode (from PartialHydronicConfiguration)Operating mode
Buildings.Controls.OBC.CDL.Interfaces.RealOutputyVal_actual (from PartialHydronicConfiguration)Valve position feedback
Buildings.Controls.OBC.CDL.Interfaces.RealOutputyPum_actual (from PartialHydronicConfiguration)Actual pump input value that is used for computations
Buildings.Controls.OBC.CDL.Interfaces.RealOutputPPum (from PartialHydronicConfiguration)Pump electrical power

Components

TypeNameDefaultDescription
Medium.MassFlowRatem1_flow (from PartialHydronicConfiguration)port_a1.m_flowMass flow rate from port_a1 to port_b1 (m1_flow > 0 is design flow direction)
Modelica.Units.SI.PressureDifferencedp1 (from PartialHydronicConfiguration)port_a1.p - port_b1.pPressure difference between port_a1 and port_b1
Medium.MassFlowRatem2_flow (from PartialHydronicConfiguration)port_a2.m_flowMass flow rate from port_a2 to port_b2 (m2_flow > 0 is design flow direction)
Modelica.Units.SI.PressureDifferencedp2 (from PartialHydronicConfiguration)port_a2.p - port_b2.pPressure difference between port_a2 and port_b2
Medium.ThermodynamicStatesta_a1 (from PartialHydronicConfiguration)if allowFlowReversal then Medium.setState_phX(port_a1.p, noEvent(actualStream(port_a1.h_outflow)), noEvent(actualStream(port_a1.Xi_outflow))) else Medium.setState_phX(port_a1.p, inStream(port_a1.h_outflow), inStream(port_a1.Xi_outflow))Medium properties in port_a1
Medium.ThermodynamicStatesta_b1 (from PartialHydronicConfiguration)if allowFlowReversal then Medium.setState_phX(port_b1.p, noEvent(actualStream(port_b1.h_outflow)), noEvent(actualStream(port_b1.Xi_outflow))) else Medium.setState_phX(port_b1.p, port_b1.h_outflow, port_b1.Xi_outflow)Medium properties in port_b1
Medium.ThermodynamicStatesta_a2 (from PartialHydronicConfiguration)if allowFlowReversal then Medium.setState_phX(port_a2.p, noEvent(actualStream(port_a2.h_outflow)), noEvent(actualStream(port_a2.Xi_outflow))) else Medium.setState_phX(port_a2.p, inStream(port_a2.h_outflow), inStream(port_a2.Xi_outflow))Medium properties in port_a2
Medium.ThermodynamicStatesta_b2 (from PartialHydronicConfiguration)if allowFlowReversal then Medium.setState_phX(port_b2.p, noEvent(actualStream(port_b2.h_outflow)), noEvent(actualStream(port_b2.Xi_outflow))) else Medium.setState_phX(port_b2.p, port_b2.h_outflow, port_b2.Xi_outflow)Medium properties in port_b2
FixedResistances.JunctionjunBypSupJunction
FixedResistances.JunctionjunBypRetJunction
Components.TwoWayValvevalControl valve
FixedResistances.PressureDropres1Primary balancing valve
FixedResistances.PressureDropres2Secondary balancing valve
Buildings.Controls.OBC.CDL.Integers.GreaterThresholdisEnaReturns true if enabled
Components.PumppumPump
Sensors.TemperatureTwoPortT2SupConsumer circuit supply temperature sensor
Controls.PIDWithOperatingModectlController
Sensors.TemperatureTwoPortT2RetConsumer circuit return temperature sensor
FixedResistances.PressureDropres3Bypass balancing valve
Sensors.RelativePressuredp3Pressure drop across bypass balancing valve
Buildings.Controls.OBC.CDL.Reals.Sources.Constantdp3SetPressure differential set point
Buildings.Controls.OBC.CDL.Conversions.BooleanToIntegerenaCtlEnable signal for control loop

Revisions

  • June 17, 2026, by Michael Wetter:
    Updated implementation to allow a flow coefficient n that is different from 2. This allows use of the model for not fully turbulent flow.
    This is for Buildings, #4620.
  • June 30, 2022, by Antoine Gautier:
    First implementation.