.Buildings.Templates.Components.Actuators.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 status y0_actual (Booleans) are returned.
  y1_actual = false corresponds to fully closed. y1_actual = true corresponds to fully open. And the opposite for y0_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.

Revisions

• May 7, 2025, by Antoine Gautier:
  Replaced direct fluid pass-through with fixed resistance.
  This is for #4227.
• September 27, 2023, by Antoine Gautier:
  First implementation.