Docs / Shapes / Gauge

Gauge Shape

The Gauge shape displays an elegant circular dial whose needle follows a term value.

Screenshot: Gauge shape on the board

Overview

A Gauge shape maps a bound term between its minimum and maximum values across a circular dial. The needle can be dragged to update the term, while automatic scaling and colored ranges make the current value easy to interpret.

The needle is only draggable when the value it shows can be set: a gauge with no bound term, or one bound to a term the model lets you change. A needle bound to a computed term, to the independent variable, or to a locked term is read-only, and dragging over it moves the shape instead.

Toolbar

Screenshot: Gauge shape toolbar

Properties Panel

Screenshot: Gauge properties panel
PropertyDescription
ValueThe term controlling the gauge needle
Auto ScaleUses the observed term range as the gauge scale
MinimumThe lower end of a manual scale
MaximumThe upper end of a manual scale
Start angleThe beginning of the visible dial sweep
End angleThe end of the visible dial sweep
Tick stepThe value interval between gauge ticks
Color rangesColored bands assigned to value intervals