⏲️

Gauge

Sinks

The Gauge block renders an analog semicircular dial with a rotating needle, showing the instantaneous value of the connected signal relative to a user-defined min/max range. The filled arc grows proportionally with the value and the needle sweeps from −90° (minimum) to +90° (maximum), giving an immediate visual sense of where the signal sits within its operating band.

It is well suited for monitoring slowly varying process variables — temperature, pressure, flow rate, or any signal with a meaningful engineering range — where a quick at-a-glance reading is more useful than a precise numeric readout.

Inputs & Outputs

Direction	ID	Label	Type	Status
→ In	`in`	Input	number	Required

Parameters

Parameters	Label	Type	Default
`minValue`	Min Value	number	`0`
`maxValue`	Max Value	number	`100`
`units`	Units	string

Usage Examples

Monitor reactor temperature

TemperatureSensor → Gauge

Set minValue to 0, maxValue to 200, and units to "°C" to watch the vessel temperature sweep across its safe operating range.

Display normalised PID error

Abs → Gauge

Set minValue to 0 and maxValue to 1 with units as "" to track the absolute normalised error of a control loop at a glance.

Remarks & Best Practices

Pure sink: The Gauge block has no output port. It is a terminal visualisation block and cannot be used mid-chain.
Value clamping: Input values outside [minValue, maxValue] are clamped; the needle does not go beyond the end-stops, so out-of-range conditions are not visually distinguishable from the limit values.
Static readout: The numeric value shown in the dial centre is updated each simulation step but always displays one decimal place regardless of the signal precision.

Related Components

Display: Numeric text readout with configurable precision, format, and history — use when you need exact values or post-run statistics.
SevenSegment: LED-style integer/decimal display — use for a hardware-panel aesthetic instead of an analog dial.