Buildings.Templates.Components.Actuators
Damper and valve models
Information
This package contains models for dampers and valves.
Extends from Modelica.Icons.VariantsPackage (Icon for package containing variants).
Package Content
Name | Description |
---|---|
Damper | Multiple-configuration damper |
Valve | Multiple-configuration valve |
Buildings.Templates.Components.Actuators.Damper
Multiple-configuration damper
Information
This is a container model that can be used to represent a variety of dampers. The supported damper types are described in the enumeration Buildings.Templates.Components.Types.Damper.
Control points
The following input and output points are available.
For modulating dampers:
-
The damper opening is modulated with a fractional opening
signal
y
(real).
y = 0
corresponds to fully closed.y = 1
corresponds to fully open. -
The actual damper position
y_actual
(real) is returned.
y_actual = 0
corresponds to fully closed.y_actual = 1
corresponds to fully open.
For pressure-independent dampers:
-
The airflow setpoint is modulated with a fractional
airflow signal
y
(real).
y = 0
corresponds to zero airflow.y = 1
corresponds to the maximum airflow. -
The actual damper position
y_actual
(real) is returned.
y_actual = 0
corresponds to fully closed.y_actual = 1
corresponds to fully open.
For two-position dampers:
-
The damper is commanded open with a Boolean signal
y1
.
y1 = 0
corresponds to fully closed.y1 = 1
corresponds to fully open. -
The open end switch status
y1_actual
and closed end switch statusy0_actual
(Booleans) are returned.
y1_actual = false
corresponds to fully closed.y1_actual = true
corresponds to fully open. And the opposite fory0_actual
.
Model parameters
The design operating point is specified with an instance of Buildings.Templates.Components.Data.Damper.
Extends from Buildings.Fluid.Interfaces.PartialTwoPortInterface (Partial model with two ports and declaration of quantities that are used by many models).
Parameters
Type | Name | Default | Description |
---|---|---|---|
replaceable package Medium | PartialMedium | Medium in the component | |
Damper | dat | dat(final typ=typ) | Design and operating parameters |
Nominal condition | |||
MassFlowRate | m_flow_nominal | dat.m_flow_nominal | Nominal mass flow rate [kg/s] |
Configuration | |||
Damper | typ | 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] |
Boolean | from_dp | false | = true, use m_flow = f(dp) else dp = f(m_flow) |
Boolean | linearized | false | = true, use linear relation between m_flow and dp for any flow rate |
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 |
Graphics | |||
DamperBlades | typBla | if typ == Buildings.Template... | Type of blades |
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) |
Bus | bus | Control bus |
Modelica definition
Buildings.Templates.Components.Actuators.Valve
Multiple-configuration valve
Information
This is a container model that can be used to represent a variety of valves, with a variety of characteristics. The supported types of valve are described in the enumeration Buildings.Templates.Components.Types.Valve. The supported flow characteristics are described in the enumeration Buildings.Templates.Components.Types.ValveCharacteristicTwoWay for two-way valves, and in the enumeration Buildings.Templates.Components.Types.ValveCharacteristicThreeWay for three-way valves.
Control points
The following input and output points are available.
For modulating valves:
-
The valve position is modulated with a fractional position
signal
y
(real).
y = 0
corresponds to fully closed (fully open bypass for three-way valves).y = 1
corresponds to fully open (fully closed bypass for three-way valves). -
The actual valve position
y_actual
(real) is returned.
y_actual = 0
corresponds to fully closed.y_actual = 1
corresponds to fully open.
For two-position valves:
-
The valve position is commanded with a Boolean signal
y1
.
y1 = false
corresponds to fully closed (fully open bypass for three-way valves).y1 = true
corresponds to fully open (fully closed bypass for three-way valves). -
The open end switch status
y1_actual
and closed end switch statusy0_actual
(Booleans) are returned.
y1_actual = false
corresponds to fully closed.y1_actual = true
corresponds to fully open. And the opposite fory0_actual
.
Model parameters
The design operating point is specified with an instance of Buildings.Templates.Components.Data.Valve.
The default characteristic is equal percentage (resp. equal percentage and linear) for modulating two-way valves (resp. modulating three-way valves). The default characteristic is linear for two-position actuators.
For three-way valves, the default setting for the ratio of
the Kvs coefficient between the bypass branch and the
direct branch is fraK=1.0
, see
Buildings.Fluid.HydronicConfigurations.UsersGuide.ControlValves
for the rationale.
Extends from Buildings.Fluid.Interfaces.PartialTwoPortInterface (Partial model with two ports and declaration of quantities that are used by many models).
Parameters
Type | Name | Default | Description |
---|---|---|---|
replaceable package Medium | PartialMedium | Medium in the component | |
Valve | dat | dat(final typ=typ) | Design and operating parameters |
Nominal condition | |||
MassFlowRate | m_flow_nominal | dat.m_flow_nominal | Nominal mass flow rate [kg/s] |
Configuration | |||
Valve | typ | Equipment type | |
ValveCharacteristicTwoWay | chaTwo | if is_actMod then Buildings.... | Flow characteristic |
ValveCharacteristicThreeWay | chaThr | if is_actMod then Buildings.... | Flow characteristic |
Generic | flowCharacteristics | flowCharacteristics(y={0,1},... | Table with flow characteristics |
Generic | flowCharacteristics1 | flowCharacteristics1(y={0,1}... | Table with flow characteristics for direct flow path at port_1 |
Generic | flowCharacteristics3 | flowCharacteristics3(y={0,1}... | Table with flow characteristics for bypass flow path at port_3 |
Real | fraK | 1.0 | Fraction Kv(port_3→port_2)/Kv(port_1→port_2) |
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] |
Boolean | from_dp | false | = true, use m_flow = f(dp) else dp = f(m_flow) |
Boolean | linearized | false | = true, use linear relation between m_flow and dp for any flow rate |
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 |