modelLoadThreeWayValveControl

Model of a load on hydronic circuit with flow rate modulation by three-way valve

Extends from PartialLoadValveControl (Partial model of a load on hydronic circuit with flow rate modulation by control valve).

Information

This is a model of a thermal load on a hydronic circuit that is composed of Buildings.Fluid.HydronicConfigurations.ActiveNetworks.Examples.BaseClasses.Load and a diversion circuit with a three-way valve that is used to modulate the flow rate through the load component.

Parameters

TypeNameDefaultDescription
Buildings.Fluid.HydronicConfigurations.Types.Controltyp (from PartialLoadValveControl)Load type
Modelica.Units.SI.MassFlowRatemLiq_flow_nominal (from PartialLoadValveControl)1Liquid mass flow rate at design conditions
Modelica.Units.SI.PressureDifferencedpTer_nominal (from PartialLoadValveControl)3E4Liquid pressure drop across terminal unit at design conditions
Modelica.Units.SI.MassFlowRatemAir_flow_nominal (from PartialLoadValveControl)abs(Q_flow_nominal)/10/1015Air mass flow rate at design conditions
Modelica.Units.SI.TemperatureTAirEnt_nominal (from PartialLoadValveControl)if typ == Buildings.Fluid.HydronicConfigurations.Types.Control.Heating then 20 + 273.15 else 26 + 273.15Air entering temperature at design conditions
Modelica.Units.SI.TemperatureTAirEntChg_nominal (from PartialLoadValveControl)20 + 273.15Air entering temperature in change-over mode
Modelica.Units.SI.MassFractionphiAirEnt_nominal (from PartialLoadValveControl)0.5Air entering relative humidity at design conditions
Modelica.Units.SI.TemperatureTLiqEnt_nominal (from PartialLoadValveControl)if typ == Buildings.Fluid.HydronicConfigurations.Types.Control.Heating then 60 + 273.15 else 7 + 273.15Liquid entering temperature at design conditions
Modelica.Units.SI.TemperatureTLiqLvg_nominal (from PartialLoadValveControl)TLiqEnt_nominal + (if typ == Buildings.Fluid.HydronicConfigurations.Types.Control.Heating then -10 else +5)Liquid leaving temperature at design conditions
Modelica.Units.SI.TemperatureTLiqEntChg_nominal (from PartialLoadValveControl)60 + 273.15Liquid entering temperature in change-over mode
Modelica.Units.SI.HeatFlowRateQ_flow_nominal (from PartialLoadValveControl)(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_nominalTransmitted heat flow rate at design conditions
Buildings.Controls.OBC.CDL.Types.SimpleControllercontrollerType (from PartialLoadValveControl)Buildings.Controls.OBC.CDL.Types.SimpleController.PIType of controller
Assumptions
BooleanallowFlowReversal (from PartialTwoPort)true= false to simplify equations, assuming, but not enforcing, no flow reversal
Nominal condition
Modelica.Units.SI.MassFlowRatem_flow_nominal (from PartialTwoPortInterface)Nominal mass flow rate
Advanced
Modelica.Units.SI.MassFlowRatem_flow_small (from PartialTwoPortInterface)1E-4*abs(m_flow_nominal)Small mass flow rate for regularization of zero flow
Advanced › Diagnostics
Booleanshow_T (from PartialTwoPortInterface)false= true, if actual temperature at port is computed
Control valve
Modelica.Units.SI.PressureDifferencedpValve_nominal (from PartialLoadValveControl)dpTer_nominalControl valve pressure drop at design conditions
Balancing valves
Modelica.Units.SI.PressureDifferencedpBal1_nominal (from PartialLoadValveControl)0Balancing valve pressure drop at design conditions
Control gains
Realk (from PartialLoadValveControl)0.1Gain of controller
RealTi (from PartialLoadValveControl)60Time constant of integrator block
Dynamics › Conservation equations
Modelica.Fluid.Types.DynamicsenergyDynamics (from PartialLoadValveControl)Modelica.Fluid.Types.Dynamics.SteadyStateType of energy balance: dynamic (3 initialization options) or steady state

Connectors

TypeNameDefaultDescription
Modelica.Fluid.Interfaces.FluidPort_aport_a (from PartialTwoPort)Fluid connector a (positive design flow direction is from port_a to port_b)
Modelica.Fluid.Interfaces.FluidPort_bport_b (from PartialTwoPort)Fluid connector b (positive design flow direction is from port_a to port_b)
Buildings.Controls.OBC.CDL.Interfaces.RealInputu (from PartialLoadValveControl)Load modulating signal
Buildings.Controls.OBC.CDL.Interfaces.IntegerInputmode (from PartialLoadValveControl)Operating mode
Buildings.Controls.OBC.CDL.Interfaces.RealOutputyLoa_actual (from PartialLoadValveControl)Actual load fraction met
Buildings.Controls.OBC.CDL.Interfaces.RealOutputQ_flow (from PartialLoadValveControl)Total heat flow rate transferred to the load
Buildings.Controls.OBC.CDL.Interfaces.RealOutputyVal_actual (from PartialLoadValveControl)Valve position feedback

Components

TypeNameDefaultDescription
Modelica.Units.SI.MassFlowRatem_flow (from PartialTwoPortInterface)port_a.m_flowMass flow rate from port_a to port_b (m_flow > 0 is design flow direction)
Modelica.Units.SI.PressureDifferencedp (from PartialTwoPortInterface)port_a.p - port_b.pPressure difference between port_a and port_b
Medium.ThermodynamicStatesta_a (from PartialTwoPortInterface)if allowFlowReversal then Medium.setState_phX(port_a.p, noEvent(actualStream(port_a.h_outflow)), noEvent(actualStream(port_a.Xi_outflow))) else Medium.setState_phX(port_a.p, noEvent(inStream(port_a.h_outflow)), noEvent(inStream(port_a.Xi_outflow)))Medium properties in port_a
Medium.ThermodynamicStatesta_b (from PartialTwoPortInterface)if allowFlowReversal then Medium.setState_phX(port_b.p, noEvent(actualStream(port_b.h_outflow)), noEvent(actualStream(port_b.Xi_outflow))) else Medium.setState_phX(port_b.p, noEvent(port_b.h_outflow), noEvent(port_b.Xi_outflow))Medium properties in port_b
Buildings.Fluid.HydronicConfigurations.ActiveNetworks.Examples.BaseClasses.Loadloa (from PartialLoadValveControl)Load
HydronicConfigurations.Interfaces.PartialHydronicConfigurationcon (from PartialLoadValveControl)

Revisions

  • June 30, 2022, by Antoine Gautier:
    First implementation.