Horizontal pipe
Who it’s for
Anyone drawing a SCADA mimic where the connections matter as much as the equipment — a process line where an operator needs to see not only that a pump is running but that fluid is actually moving through the pipe it feeds, and whether that pipe is leaking.
What it does
The Horizontal pipe widget renders a pipe symbol with fluid and leak visualizations bound to live data. As a preconfigured SCADA symbol, it ships pointed at the platform’s own horizontal pipe SVG, and its behaviors bind flow and leak state to whatever keys the process reports.
- Pipes as first-class elements — a mimic where the connections animate reads as a process, whereas one with static lines between animated equipment reads as a diagram.
- Fluid visualization shows movement, so a running pump feeding a closed valve is visibly different from one feeding an open line.
- A leak visualization gives a fault its own representation on the diagram rather than only in an alarm list.
- A 1×1 default footprint, because pipes are laid out in runs of tiles rather than placed as single large widgets.
- Being a SCADA symbol, it takes the same behaviors as any other — values that drive appearance, actions that command, and widget actions that navigate.
- The Horizontal pipe draws one horizontal segment: corners, junctions and vertical runs need their own symbols placed alongside it.
How to set up
Data keys
The Horizontal pipe takes its data through the symbol’s behaviors rather than through a fixed key list.
| Attribute | Scope | Operation | Description |
|---|---|---|---|
| Flow key | Any | Read | Bound to a Value behavior, this drives the fluid visualization — whether the pipe shows movement. |
| Leak key | Any | Read | Bound to a Value behavior, this drives the leak visualization. |
Bind the flow behavior to something that actually indicates flow — a flow meter, a pump run state, a valve position — rather than to the presence of pressure. A pressurized static line looks identical to a flowing one on the instrumentation, and the pipe will animate as though fluid is moving when it is not.
Symbol
| Setting | Default | Effect |
|---|---|---|
| SCADA symbol | The platform’s horizontal pipe SVG | The symbol rendered |
| Behavior | Empty | Bindings from the symbol’s flow and leak elements to data |
| Properties | Empty | The symbol’s own configurable settings, exposed per instance |
How to customize
- To animate flow — add a Value behavior bound to the key that indicates movement.
- To show leaks — add a Value behavior bound to the leak detection key.
- To make the pipe navigate — add a Widget action behavior, so clicking a run opens the state covering that section.
- To match the mimic’s background — set the card Background and Card padding so adjacent pipe tiles join without a visible gap.
- To adjust the symbol’s own appearance — set its exposed Properties.
Tips
- Set the padding to zero and match the backgrounds on every pipe tile in a run. Any padding leaves gaps between segments, and a mimic where the pipes visibly do not connect undermines the diagram it is meant to be.
- Bind the leak visualization even when there is no leak sensor, using a derived condition instead — a pressure drop across a section, or a flow imbalance between two meters. A leak that only exists in an alarm list is not visible on the diagram where the operator is looking.
Share Your Widget with the Community
Built a custom widget? Export it as a JSON from ThingsBoard and publish it to the IoT Hub through a simple 4-step wizard (Upload, Listing, Readme, Review & Submit). Share it with thousands of ThingsBoard developers worldwide and get featured in the catalog.