Buildings.Templates.Components.Valves
Valve models
Information
This package contains models for valves.
Extends from Modelica.Icons.VariantsPackage (Icon for package containing variants).
Package Content
| Name | Description |
|---|---|
 None
|
No valve |
| ThreeWayModulating
|
Three-way modulating valve |
| ThreeWayTwoPosition
|
Three-way two-position valve |
| TwoWayModulating
|
Two-way modulating valve |
| TwoWayTwoPosition
|
Two-way two-position valve |
Buildings.Templates.Components.Valves.None
No valve
Information
This is a direct fluid pass-through model to represent a configuration with no valve.
Extends from Buildings.Templates.Components.Interfaces.PartialValve (Interface class for valve).
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| replaceable package Medium | PartialMedium | Medium in the component | |
| Valve | dat | Design and operating parameters | |
| Configuration | |||
| Valve | typ | Buildings.Templates.Componen... | Equipment type |
| Assumptions | |||
| Boolean | allowFlowReversal | true | = false to simplify equations, assuming, but not enforcing, no flow reversal |
| Advanced | |||
| MassFlowRate | m_flow_small | 1E-4*abs(m_flow_nominal) | Small mass flow rate for regularization of zero flow [kg/s] |
| Diagnostics | |||
| Boolean | show_T | false | = true, if actual temperature at port is computed |
| Dynamics | |||
| Filtered opening | |||
| Boolean | use_inputFilter | true | = true, if opening is filtered with a 2nd order CriticalDamping filter |
| Time | riseTime | 120 | Rise time of the filter (time to reach 99.6 % of an opening step) [s] |
| Init | init | Modelica.Blocks.Types.Init.I... | Type of initialization (no init/steady state/initial state/initial output) |
| Real | y_start | 1 | Initial position of actuator |
| Nominal condition | |||
| Time | tau | 10 | Time constant at nominal flow [s] |
| Conservation equations | |||
| Dynamics | energyDynamics | Modelica.Fluid.Types.Dynamic... | Type of energy balance: dynamic (3 initialization options) or steady state |
| Graphics | |||
| Integer | text_rotation | 0 | Text rotation angle in icon layer |
| Boolean | text_flip | false | True to flip text horizontally in icon layer |
Connectors
| Type | Name | Description |
|---|---|---|
| FluidPort_a | port_a | Fluid connector a (positive design flow direction is from port_a to port_b) |
| FluidPort_b | port_b | Fluid connector b (positive design flow direction is from port_a to port_b) |
| FluidPort_a | portByp_a | Fluid connector with bypass line |
| Bus | bus | Control bus |
Modelica definition
model None "No valve"
extends Buildings.Templates.Components.Interfaces.PartialValve(
final typ=Buildings.Templates.Components.Types.Valve.None);
equation
connect(port_a, port_b);
end None;
Buildings.Templates.Components.Valves.ThreeWayModulating
Three-way modulating valve
Information
This is a model for a three-way modulating valve.
-
The valve position is modulated with a fractional position
signal
y(real).
y = 0corresponds to full bypass.y = 1corresponds to zero bypass. -
The actual valve position
y_actual(real) is returned.
y_actual = 0corresponds to full bypass.y_actual = 1corresponds to zero bypass.
Extends from Buildings.Templates.Components.Interfaces.PartialValve (Interface class for valve).
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| replaceable package Medium | PartialMedium | Medium in the component | |
| Valve | dat | Design and operating parameters | |
| ThreeWayEqualPercentageLinear | val | redeclare Buildings.Fluid.Ac... | Valve |
| Configuration | |||
| Valve | typ | Buildings.Templates.Componen... | Equipment type |
| Assumptions | |||
| Boolean | allowFlowReversal | true | = false to simplify equations, assuming, but not enforcing, no flow reversal |
| Advanced | |||
| MassFlowRate | m_flow_small | 1E-4*abs(m_flow_nominal) | Small mass flow rate for regularization of zero flow [kg/s] |
| Diagnostics | |||
| Boolean | show_T | false | = true, if actual temperature at port is computed |
| Dynamics | |||
| Filtered opening | |||
| Boolean | use_inputFilter | true | = true, if opening is filtered with a 2nd order CriticalDamping filter |
| Time | riseTime | 120 | Rise time of the filter (time to reach 99.6 % of an opening step) [s] |
| Init | init | Modelica.Blocks.Types.Init.I... | Type of initialization (no init/steady state/initial state/initial output) |
| Real | y_start | 1 | Initial position of actuator |
| Nominal condition | |||
| Time | tau | 10 | Time constant at nominal flow [s] |
| Conservation equations | |||
| Dynamics | energyDynamics | Modelica.Fluid.Types.Dynamic... | Type of energy balance: dynamic (3 initialization options) or steady state |
| Graphics | |||
| Integer | text_rotation | 0 | Text rotation angle in icon layer |
| Boolean | text_flip | false | True to flip text horizontally in icon layer |
Connectors
| Type | Name | Description |
|---|---|---|
| FluidPort_a | port_a | Fluid connector a (positive design flow direction is from port_a to port_b) |
| FluidPort_b | port_b | Fluid connector b (positive design flow direction is from port_a to port_b) |
| FluidPort_a | portByp_a | Fluid connector with bypass line |
| Bus | bus | Control bus |
Modelica definition
model ThreeWayModulating "Three-way modulating valve"
extends Buildings.Templates.Components.Interfaces.PartialValve(
final typ=Buildings.Templates.Components.Types.Valve.ThreeWayModulating);
replaceable Buildings.Fluid.Actuators.Valves.ThreeWayEqualPercentageLinear val
constrainedby Buildings.Fluid.Actuators.BaseClasses.PartialThreeWayValve(
redeclare final package Medium=Medium,
final m_flow_nominal=m_flow_nominal,
final dpValve_nominal=dpValve_nominal,
final dpFixed_nominal={dpFixed_nominal, dpFixedByp_nominal},
final energyDynamics=energyDynamics,
final tau=tau,
final use_inputFilter=use_inputFilter,
final riseTime=riseTime,
final init=init,
final y_start=y_start,
final portFlowDirection_1=if allowFlowReversal then
Modelica.Fluid.Types.PortFlowDirection.Bidirectional
else Modelica.Fluid.Types.PortFlowDirection.Entering,
final portFlowDirection_2=if allowFlowReversal then
Modelica.Fluid.Types.PortFlowDirection.Bidirectional
else Modelica.Fluid.Types.PortFlowDirection.Leaving,
final portFlowDirection_3=if allowFlowReversal then
Modelica.Fluid.Types.PortFlowDirection.Bidirectional
else Modelica.Fluid.Types.PortFlowDirection.Entering)
"Valve";
equation
connect(port_a, val.port_1);
connect(val.port_2, port_b);
connect(val.port_3, portByp_a);
connect(bus.y, val.y);
connect(val.y_actual, bus.y_actual);
end ThreeWayModulating;
Buildings.Templates.Components.Valves.ThreeWayTwoPosition
Three-way two-position valve
Information
This is a model for a three-way two-position (directional) valve.
-
The valve position is commanded with a Boolean signal
y1.
y1 = falsecorresponds to full bypass.y1 = truecorresponds to zero bypass. -
The open end switch status
y1_actualand closed end switch statusy0_actual(Booleans) are returned.
y1_actual = falsecorresponds to full bypass.y1_actual = truecorresponds to zero bypass. And the opposite fory0_actual.
Extends from Buildings.Templates.Components.Interfaces.PartialValve (Interface class for valve).
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| replaceable package Medium | PartialMedium | Medium in the component | |
| Valve | dat | Design and operating parameters | |
| ThreeWayLinear | val | redeclare Buildings.Fluid.Ac... | Valve |
| Configuration | |||
| Valve | typ | Buildings.Templates.Componen... | Equipment type |
| Assumptions | |||
| Boolean | allowFlowReversal | true | = false to simplify equations, assuming, but not enforcing, no flow reversal |
| Advanced | |||
| MassFlowRate | m_flow_small | 1E-4*abs(m_flow_nominal) | Small mass flow rate for regularization of zero flow [kg/s] |
| Diagnostics | |||
| Boolean | show_T | false | = true, if actual temperature at port is computed |
| Dynamics | |||
| Filtered opening | |||
| Boolean | use_inputFilter | true | = true, if opening is filtered with a 2nd order CriticalDamping filter |
| Time | riseTime | 120 | Rise time of the filter (time to reach 99.6 % of an opening step) [s] |
| Init | init | Modelica.Blocks.Types.Init.I... | Type of initialization (no init/steady state/initial state/initial output) |
| Real | y_start | 1 | Initial position of actuator |
| Nominal condition | |||
| Time | tau | 10 | Time constant at nominal flow [s] |
| Conservation equations | |||
| Dynamics | energyDynamics | Modelica.Fluid.Types.Dynamic... | Type of energy balance: dynamic (3 initialization options) or steady state |
| Graphics | |||
| Integer | text_rotation | 0 | Text rotation angle in icon layer |
| Boolean | text_flip | false | True to flip text horizontally in icon layer |
Connectors
| Type | Name | Description |
|---|---|---|
| FluidPort_a | port_a | Fluid connector a (positive design flow direction is from port_a to port_b) |
| FluidPort_b | port_b | Fluid connector b (positive design flow direction is from port_a to port_b) |
| FluidPort_a | portByp_a | Fluid connector with bypass line |
| Bus | bus | Control bus |
Modelica definition
model ThreeWayTwoPosition "Three-way two-position valve"
extends Buildings.Templates.Components.Interfaces.PartialValve(
final typ=Buildings.Templates.Components.Types.Valve.ThreeWayTwoPosition);
replaceable Buildings.Fluid.Actuators.Valves.ThreeWayLinear val
constrainedby Buildings.Fluid.Actuators.BaseClasses.PartialThreeWayValve(
redeclare final package Medium=Medium,
final m_flow_nominal=m_flow_nominal,
final dpValve_nominal=dpValve_nominal,
final dpFixed_nominal={dpFixed_nominal, dpFixedByp_nominal},
final energyDynamics=energyDynamics,
final tau=tau,
final use_inputFilter=use_inputFilter,
final riseTime=riseTime,
final init=init,
final y_start=y_start,
final portFlowDirection_1=if allowFlowReversal then
Modelica.Fluid.Types.PortFlowDirection.Bidirectional
else Modelica.Fluid.Types.PortFlowDirection.Entering,
final portFlowDirection_2=if allowFlowReversal then
Modelica.Fluid.Types.PortFlowDirection.Bidirectional
else Modelica.Fluid.Types.PortFlowDirection.Leaving,
final portFlowDirection_3=if allowFlowReversal then
Modelica.Fluid.Types.PortFlowDirection.Bidirectional
else Modelica.Fluid.Types.PortFlowDirection.Entering)
"Valve";
Buildings.Controls.OBC.CDL.Reals.GreaterThreshold evaOpe(t=0.99, h=0.5E-2)
"Return true if open (open end switch contact)";
Buildings.Controls.OBC.CDL.Reals.LessThreshold evaClo(t=0.01, h=0.5E-2)
"Return true if closed (closed end switch contact)";
Buildings.Controls.OBC.CDL.Conversions.BooleanToReal booToRea(
final realTrue=1,
final realFalse=0)
"Signal conversion";
equation
connect(port_a, val.port_1);
connect(val.port_2, port_b);
connect(val.y_actual, evaOpe.u);
connect(val.y_actual, evaClo.u);
connect(evaOpe.y, bus.y1_actual);
connect(evaClo.y, bus.y0_actual);
connect(booToRea.u, bus.y1);
connect(booToRea.y, val.y);
connect(val.port_3, portByp_a);
end ThreeWayTwoPosition;
Buildings.Templates.Components.Valves.TwoWayModulating
Two-way modulating valve
Information
This is a model for a two-way modulating valve.
-
The valve position is modulated with a fractional position
signal
y(real).
y = 0corresponds to fully closed.y = 1corresponds to fully open. -
The actual valve position
y_actual(real) is returned.
y_actual = 0corresponds to fully closed.y_actual = 1corresponds to fully open.
Extends from Buildings.Templates.Components.Interfaces.PartialValve (Interface class for valve).
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| replaceable package Medium | PartialMedium | Medium in the component | |
| Valve | dat | Design and operating parameters | |
| TwoWayEqualPercentage | val | redeclare Buildings.Fluid.Ac... | Valve |
| Configuration | |||
| Valve | typ | Buildings.Templates.Componen... | Equipment type |
| Assumptions | |||
| Boolean | allowFlowReversal | true | = false to simplify equations, assuming, but not enforcing, no flow reversal |
| Advanced | |||
| MassFlowRate | m_flow_small | 1E-4*abs(m_flow_nominal) | Small mass flow rate for regularization of zero flow [kg/s] |
| Diagnostics | |||
| Boolean | show_T | false | = true, if actual temperature at port is computed |
| Dynamics | |||
| Filtered opening | |||
| Boolean | use_inputFilter | true | = true, if opening is filtered with a 2nd order CriticalDamping filter |
| Time | riseTime | 120 | Rise time of the filter (time to reach 99.6 % of an opening step) [s] |
| Init | init | Modelica.Blocks.Types.Init.I... | Type of initialization (no init/steady state/initial state/initial output) |
| Real | y_start | 1 | Initial position of actuator |
| Nominal condition | |||
| Time | tau | 10 | Time constant at nominal flow [s] |
| Conservation equations | |||
| Dynamics | energyDynamics | Modelica.Fluid.Types.Dynamic... | Type of energy balance: dynamic (3 initialization options) or steady state |
| Graphics | |||
| Integer | text_rotation | 0 | Text rotation angle in icon layer |
| Boolean | text_flip | false | True to flip text horizontally in icon layer |
Connectors
| Type | Name | Description |
|---|---|---|
| FluidPort_a | port_a | Fluid connector a (positive design flow direction is from port_a to port_b) |
| FluidPort_b | port_b | Fluid connector b (positive design flow direction is from port_a to port_b) |
| FluidPort_a | portByp_a | Fluid connector with bypass line |
| Bus | bus | Control bus |
Modelica definition
model TwoWayModulating "Two-way modulating valve"
extends Buildings.Templates.Components.Interfaces.PartialValve(
final typ=Buildings.Templates.Components.Types.Valve.TwoWayModulating);
replaceable Buildings.Fluid.Actuators.Valves.TwoWayEqualPercentage val
constrainedby Buildings.Fluid.Actuators.BaseClasses.PartialTwoWayValve(
redeclare final package Medium=Medium,
final m_flow_nominal=m_flow_nominal,
final dpValve_nominal=dpValve_nominal,
final dpFixed_nominal=dpFixed_nominal,
final use_inputFilter=use_inputFilter,
final riseTime=riseTime,
final init=init,
final y_start=y_start,
final allowFlowReversal=allowFlowReversal,
final show_T=show_T)
"Valve";
equation
connect(port_a, val.port_a);
connect(val.port_b, port_b);
connect(bus.y, val.y);
connect(val.y_actual, bus.y_actual);
end TwoWayModulating;
Buildings.Templates.Components.Valves.TwoWayTwoPosition
Two-way two-position valve
Information
This is a model for a two-way two-position (isolation) valve.
-
The valve position is commanded with a Boolean signal
y1.
y1 = falsecorresponds to fully closed.y1 = truecorresponds to fully open. -
The open end switch status
y1_actualand closed end switch statusy0_actual(Booleans) are returned.
y1_actual = falsecorresponds to fully closed.y1_actual = truecorresponds to fully open. And the opposite fory0_actual.
Extends from Buildings.Templates.Components.Interfaces.PartialValve (Interface class for valve).
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| replaceable package Medium | PartialMedium | Medium in the component | |
| Valve | dat | Design and operating parameters | |
| TwoWayPolynomial | val | val(c={0,1.101898284705380E-... | Valve (butterfly valve characteristic) |
| Configuration | |||
| Valve | typ | Buildings.Templates.Componen... | Equipment type |
| Assumptions | |||
| Boolean | allowFlowReversal | true | = false to simplify equations, assuming, but not enforcing, no flow reversal |
| Advanced | |||
| MassFlowRate | m_flow_small | 1E-4*abs(m_flow_nominal) | Small mass flow rate for regularization of zero flow [kg/s] |
| Diagnostics | |||
| Boolean | show_T | false | = true, if actual temperature at port is computed |
| Dynamics | |||
| Filtered opening | |||
| Boolean | use_inputFilter | true | = true, if opening is filtered with a 2nd order CriticalDamping filter |
| Time | riseTime | 120 | Rise time of the filter (time to reach 99.6 % of an opening step) [s] |
| Init | init | Modelica.Blocks.Types.Init.I... | Type of initialization (no init/steady state/initial state/initial output) |
| Real | y_start | 1 | Initial position of actuator |
| Nominal condition | |||
| Time | tau | 10 | Time constant at nominal flow [s] |
| Conservation equations | |||
| Dynamics | energyDynamics | Modelica.Fluid.Types.Dynamic... | Type of energy balance: dynamic (3 initialization options) or steady state |
| Graphics | |||
| Integer | text_rotation | 0 | Text rotation angle in icon layer |
| Boolean | text_flip | false | True to flip text horizontally in icon layer |
Connectors
| Type | Name | Description |
|---|---|---|
| FluidPort_a | port_a | Fluid connector a (positive design flow direction is from port_a to port_b) |
| FluidPort_b | port_b | Fluid connector b (positive design flow direction is from port_a to port_b) |
| FluidPort_a | portByp_a | Fluid connector with bypass line |
| Bus | bus | Control bus |
Modelica definition
model TwoWayTwoPosition "Two-way two-position valve"
extends Buildings.Templates.Components.Interfaces.PartialValve(
final typ=Buildings.Templates.Components.Types.Valve.TwoWayTwoPosition);
replaceable Buildings.Fluid.Actuators.Valves.TwoWayPolynomial val(
c={0,1.101898284705380E-01, 2.217227395456580, -7.483401207660790, 1.277617623360130E+01, -6.618045307070130})
constrainedby Buildings.Fluid.Actuators.BaseClasses.PartialTwoWayValve(
redeclare final package Medium=Medium,
final CvData = Buildings.Fluid.Types.CvTypes.OpPoint,
final m_flow_nominal=m_flow_nominal,
final dpValve_nominal=dpValve_nominal,
final dpFixed_nominal=dpFixed_nominal,
final use_inputFilter=use_inputFilter,
final riseTime=riseTime,
final init=init,
final y_start=y_start,
final allowFlowReversal=allowFlowReversal,
final show_T=show_T)
"Valve (butterfly valve characteristic)";
Buildings.Controls.OBC.CDL.Reals.GreaterThreshold evaOpe(
t=0.99,
h=0.5E-2)
"Return true if open (open end switch contact)";
Buildings.Controls.OBC.CDL.Reals.LessThreshold evaClo(t=0.01, h=0.5E-2)
"Return true if closed (closed end switch contact)";
Buildings.Controls.OBC.CDL.Conversions.BooleanToReal booToRea(
final realTrue=1,
final realFalse=0)
"Signal conversion";
equation
connect(port_a, val.port_a);
connect(val.port_b, port_b);
connect(val.y_actual, evaOpe.u);
connect(val.y_actual, evaClo.u);
connect(evaOpe.y, bus.y1_actual);
connect(evaClo.y, bus.y0_actual);
connect(booToRea.u, bus.y1);
connect(booToRea.y, val.y);
end TwoWayTwoPosition;