Skip to content

Analog Threeway Valve

The Analog Threeway Valve is an automation symbol for a valve that connects three pipes, where each port can be set to any opening between closed and fully open, such as a mixing or diverting control valve. It is found in the Automation - OpenBridge section of the Perspective Component Palette as Valve - Threeway Analog (Experimental). It is a palette entry of its own, listed right after the Valve, which is for two-port valves only.

Note: This component is experimental: its properties may change in a later version.

It is meant to be placed in a mimic or diagram, typically in a coordinate container, with its properties bound to the state of the device. The Analog Threeway Valve shows the state it is given; it does not change it, and clicking it does nothing unless you configure an event.

Analog Threeway Valve with two flow rows and a tag

The Analog Threeway Valve is one of the automation buttons. The readout and tag, the alert frame, the progress ring, the badges, the size and the positioning are shared by all of them and are described in Automation Buttons — Common Features. This page covers what is specific to the Analog Threeway Valve. For a valve whose ports are only open or closed, use the Digital Threeway Valve; for a two-port control valve, the Analog Valve.

An Analog Threeway Valve dropped from the palette with default properties (all ports at 0):

Analog Threeway Valve with default properties

The valve has three ports and one side without a port. Bind open1, open2 and open3 to the opening of each port in percent, from 0 (closed) to 100 (fully open).

The ports are numbered from the side without a port, in the order left, stem, right as seen with the stem pointing down. With the default orientation bottom, port 1 is the left port, port 2 the bottom port (the stem) and port 3 the right port. Port 2 is always the stem; the numbering turns with the symbol.

A port counts as open when its opening is above 0. What the symbol shows:

  • Fewer than two ports open — no flow can pass, so the valve is drawn closed (filled and grey) and the readout shows Closed.
  • A port at 0 while the two others are open — that port is drawn plugged (filled).
  • A port between 0 and 100 — the shut part of the port is drawn as a shaded band at the port end; the band narrows as the port opens.
  • All three ports at 100 — the open symbol.

The handle on top of the symbol shows how the flow from the most open port is split between the two others: upright when it all goes one way, level when it all goes the other, and tilted in between.

The headings give open1 / open2 / open3:

In a Connector Diagram, the medium flows only between the ports that are above 0, and never through the side without a port.

0 / 0 / 0 100 / 0 / 0 100 / 100 / 0 100 / 0 / 100 0 / 100 / 100
All ports closed Only port 1 open Port 3 closed Port 2 closed Port 1 closed
100 / 100 / 100 100 / 50 / 50 100 / 25 / 75 50 / 100 / 50
All ports fully open Ports 2 and 3 half open Ports 2 and 3 at 25 and 75 % Ports 1 and 3 half open

The openings are only drawn on the symbol; the readout does not show them. Use the flow readout to show values.

Name Description Property Type
open1 Opening of port 1 in percent, 0–100. Default 0. value
open2 Opening of port 2, the stem, in percent, 0–100. Default 0. value
open3 Opening of port 3 in percent, 0–100. Default 0. value

orientation names the side the stem (port 2) points to: bottom (default) and top lay the valve on a horizontal pipe, left and right on a vertical one. The images show ports 1 and 2 at 100 and port 3 at 0, so the plugged port shows where port 3 ends up:

bottom (default) left top right
Orientation bottom Orientation left Orientation top Orientation right

Where each port is, per orientation:

  • bottom — port 1 left, port 2 bottom, port 3 right.
  • left — port 1 top, port 2 left, port 3 bottom.
  • top — port 1 right, port 2 top, port 3 left.
  • right — port 1 bottom, port 2 right, port 3 top.

Flow through a three-way valve can go several ways at once, so the status row of the readout is a list, set with flows:

  • While no flow can pass (fewer than two ports above 0), the readout shows Closed, whatever flows holds.
  • While flow can pass and flows is empty (the default), it shows Open.
  • Otherwise it shows one row per item in flows.
Closed Open, no flows
Readout Closed Readout Open

flows does not follow the ports: the component does not work out where the flow goes. Bind or write the rows you want to show.

Each item is one of two kinds of row:

  • Value row — direction, value and unit. Shows an arrow, the value with three digits (leading zeros greyed out) and the unit. unit defaults to %.
  • State row — direction and open. Shows an arrow and Open or Closed. With direction none, the on or off icon is shown in place of the arrow.

A row is a state row as soon as it has an open key. A row added in the Property Editor starts as a value row (direction none, value 0, unit %); add an open key to it to make it a state row.

Example: two value rows, flow going right and down:

[
{"direction": "right", "value": 60, "unit": "%"},
{"direction": "down", "value": 40, "unit": "%"}
]

Example: two state rows:

[
{"direction": "right", "open": true},
{"direction": "down", "open": false}
]
Value rows State rows State row, no arrow
Two value rows Two state rows State row without direction

direction is the arrow in front of the row, pointing on screen: up, down, left, right or none (no arrow). It does not turn with orientation; point it the way the flow goes in your diagram.

up down left right none (default)
Direction up Direction down Direction left Direction right Direction none
Name Description Property Type
flows Readout rows, one per flow. Default [] (shows Open or Closed). array
flows[n].direction Arrow in front of the row: up, down, left, right or none. Default none. value
flows[n].value Value of a value row. Default 0. value
flows[n].unit Unit of a value row. Default %. value
flows[n].open Makes the row a state row: true shows Open, false shows Closed. Not present on a new row. value

variant selects whether the icon is drawn on a button or directly on the background:

  • regular (default) — the icon sits on a round button.
  • flat — only the icon is drawn, larger and without a button. Use it where the valve is part of a pipe in a diagram.
Closed Open
regular regular, closed regular, open
flat flat, closed flat, open

Name Description Property Type
open1 Opening of port 1 in percent, 0–100. Default 0. See Ports. value
open2 Opening of port 2, the stem, in percent. Default 0. value
open3 Opening of port 3 in percent. Default 0. value
orientation Side the stem points to: bottom, left, top or right. Default bottom. value
flows Readout rows, one per flow. Default []. See Flow Readout. array
variant regular draws the icon on a button, flat draws only the icon. Default regular. value

The Analog Threeway Valve is an automation button. The properties below work in the same way on every automation button, and are described in Automation Buttons — Common Features:

  • Readout — The readout next to the symbol: the status row (here the flow readout) and the tag name. Properties: showReadoutStack, readoutPosition, readoutSize, showStatus, showStatusIcon, hasTag, tag.
  • Positioning — Which part of the button is aligned to the component’s box. Properties: positioning.
  • Size — Size of the whole component. Properties: componentSize.
  • Activated — Highlighted background that marks the symbol as selected. Properties: activated.
  • Static — Grey symbol for a device whose state is unknown. Properties: static.
  • Alert Frame — Alert frame around the symbol. Properties: alert, alertFrameType, alertFrameStatus, alertFrameMode, alertFrameThickness, showAlertCategoryIcon, showAlertIcon, alertIcon, alertLabel, alertTimer.
  • Progress — Progress ring while a command is carried out. Properties: progress, progressMode, progressValue.
  • Badges — Badges in the corners of the symbol. Properties: badgeControl, badgeAlert, badgeInterlock, badgeCommandLocked.
  • Style — Standard Perspective style object.

The Analog Threeway Valve has no component events of its own. The standard Perspective events, such as onClick, are available in the component’s event configuration. See Operating a Device.

Built on the OpenBridge Design System