Buildings.Fluids.Actuators.Valves

Package with valve models

Information


This package contains components models for two- and three-way valves.
For motor models, see
Buildings.Fluids.Actuators.Motors.

Package Content

NameDescription
Buildings.Fluids.Actuators.Valves.ThreeWayEqualPercentageLinear ThreeWayEqualPercentageLinear Three way valve with equal percentage and linear characteristics
Buildings.Fluids.Actuators.Valves.ThreeWayLinear ThreeWayLinear Three way valve with linear characteristics
Buildings.Fluids.Actuators.Valves.TwoWayEqualPercentage TwoWayEqualPercentage Two way valve with linear flow characteristics
Buildings.Fluids.Actuators.Valves.TwoWayLinear TwoWayLinear Two way valve with linear flow characteristics
Buildings.Fluids.Actuators.Valves.TwoWayQuickOpening TwoWayQuickOpening Two way valve with linear flow characteristics


Buildings.Fluids.Actuators.Valves.ThreeWayEqualPercentageLinear Buildings.Fluids.Actuators.Valves.ThreeWayEqualPercentageLinear

Three way valve with equal percentage and linear characteristics

Buildings.Fluids.Actuators.Valves.ThreeWayEqualPercentageLinear

Information


Three way valve with equal percentage characteristics between port_1 and port_2 and linear opening characteristic between port_1 and port_2. Such opening characteristics were typical for valves from Landis & Gyr (now Siemens).

This model is based on the partial valve models PartialThreeWayValve and PartialTwoWayValve. See PartialThreeWayValve for the implementation of the three way valve and see PartialTwoWayValve for the implementation of the leakage flow or the regularization near the origin.


Parameters

TypeNameDefaultDescription
replaceable package MediumPartialMediumFluid medium model
Realk_SI Flow coefficient for fully open valve in SI units, k=m_flow/sqrt(dp) [(kg*m)^(1/2)]
RealfraK0.7Fraction k_SI(port_1->port_2)/k_SI(port_3->port_2)
Reall[2]{0,0}Valve leakage, l=Cv(y=0)/Cvs
RealR50Rangeability, R=50...100 typically
Realdelta00.01Range of significant deviation from equal percentage law
Pressure-flow linearization
RealdeltaM0.02Fraction of nominal flow rate where linearization starts, if y=1
Pressuredp06000Nominal pressure drop [Pa]
Advanced
Booleanfrom_dptrue= true, use m_flow = f(dp) else dp = f(m_flow)
TempflowDirectionModelica_Fluid.Types.FlowDir...Unidirectional (port_1 -> port_2) or bidirectional flow component
Booleanlinearized[2]{false,false}= true, use linear relation between m_flow and dp for any flow rate

Connectors

TypeNameDescription
FluidPort_bport_1 
FluidPort_bport_2 
FluidPort_bport_3 
input RealInputyDamper position (0: closed, 1: open)

Modelica definition

model ThreeWayEqualPercentageLinear 
  "Three way valve with equal percentage and linear characteristics" 
    extends BaseClasses.PartialThreeWayValve(
      redeclare TwoWayEqualPercentage res1(
      redeclare package Medium = Medium,
      k_SI=k_SI,
      l=l[1],
      deltaM=deltaM,
      dp0=dp0,
      flowDirection=flowDirection,
      from_dp=from_dp,
      linearized=linearized[1],
      R=R,
      delta0=delta0),
      redeclare TwoWayLinear res3(
      redeclare package Medium = Medium,
      k_SI=fraK*k_SI,
      l=l[2],
      deltaM=deltaM,
      dp0=dp0,
      flowDirection=flowDirection,
      from_dp=from_dp,
      linearized=linearized[2]));
  parameter Real R = 50 "Rangeability, R=50...100 typically";
  parameter Real delta0 = 0.01 
    "Range of significant deviation from equal percentage law";
  
equation 
  connect(inv.y, res3.y);
  connect(y, inv.u2);
  connect(y, res1.y);
end ThreeWayEqualPercentageLinear;

Buildings.Fluids.Actuators.Valves.ThreeWayLinear Buildings.Fluids.Actuators.Valves.ThreeWayLinear

Three way valve with linear characteristics

Buildings.Fluids.Actuators.Valves.ThreeWayLinear

Information


Three way valve with linear opening characteristic.

This model is based on the partial valve models PartialThreeWayValve and PartialTwoWayValve. See PartialThreeWayValve for the implementation of the three way valve and see PartialTwoWayValve for the implementation of the leakage flow or the regularization near the origin.


Parameters

TypeNameDefaultDescription
replaceable package MediumPartialMediumFluid medium model
Realk_SI Flow coefficient for fully open valve in SI units, k=m_flow/sqrt(dp) [(kg*m)^(1/2)]
RealfraK0.7Fraction k_SI(port_1->port_2)/k_SI(port_3->port_2)
Reall[2]{0,0}Valve leakage, l=Cv(y=0)/Cvs
Pressure-flow linearization
RealdeltaM0.02Fraction of nominal flow rate where linearization starts, if y=1
Pressuredp06000Nominal pressure drop [Pa]
Advanced
Booleanfrom_dptrue= true, use m_flow = f(dp) else dp = f(m_flow)
TempflowDirectionModelica_Fluid.Types.FlowDir...Unidirectional (port_1 -> port_2) or bidirectional flow component
Booleanlinearized[2]{false,false}= true, use linear relation between m_flow and dp for any flow rate

Connectors

TypeNameDescription
FluidPort_bport_1 
FluidPort_bport_2 
FluidPort_bport_3 
input RealInputyDamper position (0: closed, 1: open)

Modelica definition

model ThreeWayLinear "Three way valve with linear characteristics" 
    extends BaseClasses.PartialThreeWayValve(
      redeclare TwoWayLinear res1(
      redeclare package Medium = Medium,
      k_SI=k_SI,
      l=l[1],
      deltaM=deltaM,
      dp0=dp0,
      flowDirection=flowDirection,
      from_dp=from_dp,
      linearized=linearized[1]),
      redeclare TwoWayLinear res3(
      redeclare package Medium = Medium,
      k_SI=fraK*k_SI,
      l=l[2],
      deltaM=deltaM,
      dp0=dp0,
      flowDirection=flowDirection,
      from_dp=from_dp,
      linearized=linearized[2]));
  
equation 
  connect(inv.y, res3.y);
  connect(y, inv.u2);
  connect(y, res1.y);
end ThreeWayLinear;

Buildings.Fluids.Actuators.Valves.TwoWayEqualPercentage Buildings.Fluids.Actuators.Valves.TwoWayEqualPercentage

Two way valve with linear flow characteristics

Buildings.Fluids.Actuators.Valves.TwoWayEqualPercentage

Information


Two way valve with an equal percentage valve opening characteristic.

This model is based on the partial valve model PartialTwoWayValve. Check this model for more information, such as the leakage flow or regularization near the origin.


Parameters

TypeNameDefaultDescription
replaceable package MediumPartialMediumMedium in the component
Realk_SI Flow coefficient for fully open valve in SI units, k=m_flow/sqrt(dp) [(kg*m)^(1/2)]
Reall0.005Valve leakage, l=Cv(y=0)/Cvs
RealR50Rangeability, R=50...100 typically
Realdelta00.01Range of significant deviation from equal percentage law
Initialization
MassFlowRatem_flow Mass flow rate from port_a to port_b (m_flow > 0 is design flow direction) [kg/s]
Pressuredp Pressure difference between port_a and port_b [Pa]
Pressure-flow linearization
RealdeltaM0.02Fraction of nominal flow rate where linearization starts, if y=1
Pressuredp06000Nominal pressure drop [Pa]
Advanced
TempflowDirectionModelica_Fluid.Types.FlowDir...Unidirectional (port_a -> port_b) or bidirectional flow component
Booleanfrom_dptrue= true, use m_flow = f(dp) else dp = f(m_flow)
Booleanlinearizedfalse= true, use linear relation between m_flow and dp for any flow rate

Connectors

TypeNameDescription
FluidPort_aport_aFluid connector a (positive design flow direction is from port_a to port_b)
FluidPort_bport_bFluid connector b (positive design flow direction is from port_a to port_b)
input RealInputyDamper position (0: closed, 1: open)

Modelica definition

model TwoWayEqualPercentage 
  "Two way valve with linear flow characteristics" 
  extends BaseClasses.PartialTwoWayValve;
  parameter Real R = 50 "Rangeability, R=50...100 typically";
  parameter Real delta0 = 0.01 
    "Range of significant deviation from equal percentage law";
initial equation 
 assert(l < 1/R, "Wrong parameters in valve model.\n"
               + "  Rangeability R = " + realString(R) +  "\n"
               + "  Leakage flow l = " + realString(l) +  "\n"
               + "  Must have l < 1/R = " + realString(1/R));
  
equation 
  phi = Buildings.Fluids.Actuators.BaseClasses.equalPercentage(y, R, l, delta0);
end TwoWayEqualPercentage;

Buildings.Fluids.Actuators.Valves.TwoWayLinear Buildings.Fluids.Actuators.Valves.TwoWayLinear

Two way valve with linear flow characteristics

Buildings.Fluids.Actuators.Valves.TwoWayLinear

Information


Two way valve with linear opening characteristic.

This model is based on the partial valve model PartialTwoWayValve. Check this model for more information, such as the leakage flow or regularization near the origin.


Parameters

TypeNameDefaultDescription
replaceable package MediumPartialMediumMedium in the component
Realk_SI Flow coefficient for fully open valve in SI units, k=m_flow/sqrt(dp) [(kg*m)^(1/2)]
Reall0.005Valve leakage, l=Cv(y=0)/Cvs
Initialization
MassFlowRatem_flow Mass flow rate from port_a to port_b (m_flow > 0 is design flow direction) [kg/s]
Pressuredp Pressure difference between port_a and port_b [Pa]
Pressure-flow linearization
RealdeltaM0.02Fraction of nominal flow rate where linearization starts, if y=1
Pressuredp06000Nominal pressure drop [Pa]
Advanced
TempflowDirectionModelica_Fluid.Types.FlowDir...Unidirectional (port_a -> port_b) or bidirectional flow component
Booleanfrom_dptrue= true, use m_flow = f(dp) else dp = f(m_flow)
Booleanlinearizedfalse= true, use linear relation between m_flow and dp for any flow rate

Connectors

TypeNameDescription
FluidPort_aport_aFluid connector a (positive design flow direction is from port_a to port_b)
FluidPort_bport_bFluid connector b (positive design flow direction is from port_a to port_b)
input RealInputyDamper position (0: closed, 1: open)

Modelica definition

model TwoWayLinear "Two way valve with linear flow characteristics" 
  extends BaseClasses.PartialTwoWayValve;
  
equation 
  phi = l + y * (1 - l);
end TwoWayLinear;

Buildings.Fluids.Actuators.Valves.TwoWayQuickOpening Buildings.Fluids.Actuators.Valves.TwoWayQuickOpening

Two way valve with linear flow characteristics

Buildings.Fluids.Actuators.Valves.TwoWayQuickOpening

Information


Two way valve with a power function for the valve opening characteristic. Valves that need to open quickly typically have such a valve characteristics.

This model is based on the partial valve model PartialTwoWayValve. Check this model for more information, such as the leakage flow or regularization near the origin.


Parameters

TypeNameDefaultDescription
replaceable package MediumPartialMediumMedium in the component
Realk_SI Flow coefficient for fully open valve in SI units, k=m_flow/sqrt(dp) [(kg*m)^(1/2)]
Reall0.005Valve leakage, l=Cv(y=0)/Cvs
Realalp2Parameter for valve characteristics, alp>0
Realdelta00.01Range of significant deviation from power law
Initialization
MassFlowRatem_flow Mass flow rate from port_a to port_b (m_flow > 0 is design flow direction) [kg/s]
Pressuredp Pressure difference between port_a and port_b [Pa]
Pressure-flow linearization
RealdeltaM0.02Fraction of nominal flow rate where linearization starts, if y=1
Pressuredp06000Nominal pressure drop [Pa]
Advanced
TempflowDirectionModelica_Fluid.Types.FlowDir...Unidirectional (port_a -> port_b) or bidirectional flow component
Booleanfrom_dptrue= true, use m_flow = f(dp) else dp = f(m_flow)
Booleanlinearizedfalse= true, use linear relation between m_flow and dp for any flow rate

Connectors

TypeNameDescription
FluidPort_aport_aFluid connector a (positive design flow direction is from port_a to port_b)
FluidPort_bport_bFluid connector b (positive design flow direction is from port_a to port_b)
input RealInputyDamper position (0: closed, 1: open)

Modelica definition

model TwoWayQuickOpening 
  "Two way valve with linear flow characteristics" 
  extends BaseClasses.PartialTwoWayValve;
  parameter Real alp = 2 "Parameter for valve characteristics, alp>0";
  parameter Real delta0 = 0.01 "Range of significant deviation from power law";
protected 
   parameter Real alpInv = 1/alp;
equation 
  phi = l + Modelica_Fluid.Utilities.regPow(y, alpInv, delta0) * (1 - l);
end TwoWayQuickOpening;

HTML-documentation generated by Dymola Tue Sep 30 14:24:23 2008.