Skip to content

Gauge Radial

The Gauge Radial shows a value on an arc-shaped scale, as a filled arc, a bar or a needle. It is a general-purpose gauge for any quantity: load, pressure, level, temperature. It is found in the Maritime - OpenBridge section of the Perspective Component Palette as Gauge Radial.

Radial gauge at 62 with a setpoint and a readout

The parts of the gauge:

  1. Scale — the arc from minValue to maxValue, with tickmarks and labels. See Range and Scale.
  2. Value — the filled arc, bar or needle. See Type.
  3. Readout — the value as a number, with a label and a unit. See Readout.
  4. Setpoint — a marker on the scale. See Setpoint.

The Gauge Radial is one of the maritime instruments. State, priority, the setpoint, advice zones, the scale and sizing are shared by all of them and are described in Maritime Instruments — Common Features. This page covers what is specific to the Gauge Radial. For a small symbol of the same kind, see the Gauge Radial Indicator.

A Gauge Radial dropped from the palette shows 0 on a scale from 0 to 100, without labels:

Gauge Radial with default properties

Bind value to the quantity to show. minValue and maxValue are the ends of the scale; the range always spans the whole arc. With a range that is symmetric around zero, zero is at the top and the value grows to either side:

0 to 100, value = 62 −100 to 100, value = -30 Tickmarks every 25, 5 and 1
Gauge at 62 Gauge from −100 to 100 Three levels of tickmarks

The tickmarks are on from the start: primaryTickmarkInterval (default 50) sets the long, labelled ones and secondaryTickmarkInterval (default 10) the medium ones. Turn on the short ones with hasTertiaryTickmarkInterval. The labels need showLabels to be true. See also Scale.

Name Description Property Type
value The value. Default 0. value
minValue Lowest value of the scale. Default 0. value
maxValue Highest value of the scale. Default 100. value
primaryTickmarkInterval Distance between the long, labelled tickmarks. Default 50. value
secondaryTickmarkInterval Distance between the medium tickmarks. Default 10. value
hasTertiaryTickmarkInterval Show short tickmarks. Default false. value
tertiaryTickmarkInterval Distance between the short tickmarks. Only shown when hasTertiaryTickmarkInterval is true. value

type selects how the value is drawn:

filled (default) bar needle
Filled arc Bar Needle
  • filled — a solid arc from the start of the scale (or from zero) to the value.
  • bar — a lighter arc with a marker line at the value.
  • needle — a pointer from the centre.
Name Description Property Type
type filled, bar or needle. Default filled. value

sector selects how much of a circle the scale covers:

270 (default) 180
270° sector 180° sector
90-left 90-right
Quarter circle, left Quarter circle, right

The quarter circles are for placing gauges in the corners of a layout, or two of them side by side. Advice zones are not drawn on them.

Name Description Property Type
sector 270, 180, 90-left or 90-right. Default 270. value

Set hasReadout to true to show the value as a number, with label and unit below it. fractionDigits is the number of decimals. Where the readout goes depends on sector and type:

270°, filled 180°, filled 270°, needle
Readout in the centre Readout at the bottom Readout under the needle

In a quarter circle the readout sits in the free corner:

Readout in a quarter circle

A needle gauge with sector 180, 90-left or 90-right has no readout.

Name Description Property Type
hasReadout Show the value as a number. Default false. value
label Text under the number, for example LOAD. Empty by default. value
unit Unit after the label, for example %. Empty by default. value
fractionDigits Number of decimals in the readout. Default 0. value

The setpoint works as described in Setpoint:

Gauge with a setpoint at 75

advices is a list of advice zones, with the ends of a zone in the unit of the scale:

[{"category": "caution", "min": 80, "max": 100}]

A zone you add in the Property Editor starts with category, min, max and state filled in. Views made with earlier versions use minValue and maxValue for the ends; they still work.

A zone is triggered when the value or the setpoint is inside it. Earlier versions triggered it by the value only; set adviceTrigger to value to keep that:

Zone from 80 to 100 Value (90) inside the zone Setpoint (90) inside the zone
Caution zone Zone triggered by the value Zone triggered by the setpoint

active loading off
Active gauge Loading gauge Gauge that is off
priority = regular priority = enhanced
Regular gauge Enhanced gauge

See State and Priority.


The gauge fills the component’s box, as described in Size: it grows until it touches the shorter side of the box. In a box that is wider than tall, horizontalAlignment places it to the left, centre or right; in a box that is taller than wide, verticalAlignment places it at the top, centre or bottom. The blue frame is the component’s box:

left center (default)
Aligned left Centred
right
Aligned right
top center (default) bottom
Aligned top Centred Aligned bottom
Name Description Property Type
horizontalAlignment Place the gauge in a wide box: left, center or right. Default center. value
verticalAlignment Place the gauge in a tall box: top, center or bottom. Default center. value

These work in the same way on every maritime instrument, and are described in Maritime Instruments — Common Features:

  • State — state.
  • Priority — priority.
  • Setpoint — hasSetpoint, setpoint, autoAtSetpoint, autoAtSetpointDeadband, atSetpoint, touching, hasNewSetpoint, newSetpoint, animateSetpoint, setpointAtZeroDeadband, setpointOverride.
  • Advice Zones — advices, adviceTrigger, adviceEmphasis (see above).
  • Scale — showLabels, tickmarksInside, tickmarkStyle.
  • Size — hasFaceDiameter, faceDiameter.
  • Style and Events — style.

The Gauge Radial has no component events of its own.

  1. Drop a Gauge Radial into the view and make it 200 × 200 px.
  2. Bind value to [default]Engine/ME1/Load.
  3. Set showLabels to true, primaryTickmarkInterval to 25 and secondaryTickmarkInterval to 5.
  4. Set hasReadout to true, label to LOAD and unit to %.
  5. Set advices to [{"category": "caution", "min": 85, "max": 100}], so the zone lights up when the load goes above 85 %.

Built on the OpenBridge Design System