Gauge panel
Display numeric values from an incoming topic message path on a customized gauge display.
Message path functions can be appended to your message path using .@name syntax:
Scalar (@abs, @acos, @asin, etc.)
| Function | Description |
|---|---|
.@abs | Absolute value |
.@acos | Arc cosine (radians) |
.@asin | Arc sine (radians) |
.@atan | Arc tangent (radians) |
.@ceil | Round up to nearest integer |
.@cos | Cosine (input in radians) |
.@degrees | Convert radians to degrees |
.@log | Natural logarithm |
.@log1p | Natural log of 1 + value |
.@log2 | Base-2 logarithm |
.@log10 | Base-10 logarithm |
.@negative | Negate the value |
.@radians | Convert degrees to radians |
.@round | Round to nearest integer |
.@sign | Sign of value (-1, 0, or 1) |
.@sin | Sine (input in radians) |
.@sqrt | Square root |
.@tan | Tangent (input in radians) |
.@trunc | Truncate to integer |
Operand (@add(number), @sub(number), @mul(number), etc.)
| Function | Description |
|---|---|
.@add(number) | Add a number |
.@sub(number) | Subtract a number |
.@mul(number) | Multiply by a number |
.@div(number) | Divide by a number |
Vector (@norm)
| Function | Description |
|---|---|
.@norm | Euclidean norm (magnitude) of 2D or 3D vector |
Struct (@rpy, @quat)
| Function | Description |
|---|---|
.@rpy | Convert quaternion to roll/pitch/yaw (radians) |
.@quat | Convert roll/pitch/yaw to quaternion |
Struct functions must be followed by field access (for example, @rpy.yaw) to produce a scalar value.
Not supported in this panel: Time-series functions (.@delta, .@derivative, .@timedelta)—use the Plot panel for those.
Settings
General
| field | description |
|---|---|
| Message path | Message path containing a numeric value (or string that can be coerced to a numeric value) |
| Style | Style of gauge ("Dial" or "Bar") |
| Min | Minimum value for the gauge |
| Max | Maximum value for the gauge |
| Color mode | Type of gradient to use for the gauge |
| Color map | Preset gradients for the gauge: "Red to green", "Rainbow", or "Turbo" |
| Gradient | Starting and ending color stops for custom gradient |
| Reverse Colors | Reverse the colors of the gauge |
| Reverse Direction | Reverse the direction of the gauge, with min on right and max on left |
Styles
The panel supports two display styles:
- Dial – Displays the value as a needle on a semicircular dial. This is the default style.
- Bar – Displays the value as a horizontal progress bar. Useful for compact layouts or when monitoring multiple values.