Radial Gauge+

Overview

Radial Gauge+ shows a current value on a circular scale with configurable ticks, labels, ranges, and multi-state colors.

When to use it

Use this symbol when you need to:

• Show one process value against a recognizable operating range.
• Emphasize the current state and distance from configured limits.

Before you begin

• Prepare one numeric PI Point or AF attribute.
• Define a meaningful scale and multi-state limits when range colors are used.

Add and set up the symbol

1. Select the symbol in the PI Vision symbol gallery.
2. Add the required data sources or asset context to the display.
3. Right-click the symbol and open its configuration pane.
4. Configure the minimum data, range, and display settings for a useful result.
5. Confirm that the symbol shows the expected data.

Use the symbol

Read the pointer, value, and active range together. Hover over the gauge for configured tooltip details.

Configure the symbol

Overview and behavior

The Radial Gauge+ displays a radial (circular or arc) color-coded scale for monitoring values across a configurable range. Key features include a colored range band, multiple pointer styles, unit labels on the scale, and a variety of design options.

Configure style

The Style section controls the overall appearance of the gauge container:

• Background: Sets the fill color of the control background.
• Border Width & Color: Sets the border around the entire control (not just the scale).
• Shadow: Enables or disables a drop shadow on the control.

Configure scale

The Scale section controls the arc shape and range of the gauge:

• Angle: Sets the total arc of the gauge, between 180° (half-circle) and 360° (full circle).

360° 180°

• Start Angle: Sets the angle at which the scale arc begins.
• Show: Shows or hides the scale arc line.
• Color: Sets the scale arc color.
• Width: Sets the scale arc line width.
• Range: Sets the minimum and maximum values for the scale. Use Auto to derive these from the data, or Custom to set fixed values. Enable Invert Scale to reverse the direction from clockwise to counter-clockwise.

Configure ticks

The gauge supports Major and Minor tick marks, each configurable independently. Ticks are only visible when the scale is enabled.

Mode: Controls how tick positions are determined. Interval places evenly spaced ticks across the arc. Ranges positions ticks at multi-state limit boundaries.

Example - Ranges mode:

For each tick type (Major and Minor), the following settings are available:

• Show: Enables or disables this tick type.
• Auto: When enabled, tick count and spacing are calculated automatically. When disabled, you set a fixed tick interval.
• Size: Sets the length of the tick marks.
• Position: Places the ticks inside, outside, or centered on the scale arc.
• Color: Chooses between a custom static color or the multi-state range color (requires Multi-State to be active).

Configure labels

Configures the numeric value labels along the scale:

• Show: Enables or disables scale labels.
• Position: Places labels inside or outside the scale arc.
• Offset: Fine-tunes the label distance from the scale arc.
• Color: Chooses between Range (colors labels by their multi-state color - requires Multi-State to be active) and Custom (a single user-defined color).

Range Custom (White)

• Units: Shows or hides the unit of measurement alongside scale value labels.
• Font Size: Sets the font size for scale value labels.
• Opacity: Sets the opacity of scale value labels.

Configure range bar

This section appears only when Multi-State is enabled. The range bar draws color bands and limit positions directly from the multi-state configuration - edit colors or thresholds in the Multi-State settings.

The following range bar display settings are available:

• Show: Shows or hides the range bar.
• Position: Places the range bar inside, outside, or centered on the scale arc.
• Size: Chooses between Uniform (constant width throughout) and Tapered (width increases or decreases along the arc).
• Width Start / End: Sets the start and end widths of the bar. Different values create a tapered effect.
• Offset: Adjusts the range bar's distance from the scale arc.
• Opacity: Sets the opacity for all range bands (used for non-highlighted bands when Highlight is active).
• Highlight: Emphasizes the active range band. All other bands are dimmed to the configured Opacity value. Set Opacity to 0 to fully hide non-active bands.

The data source list below the toggle lets you select which data source drives the highlight. Enable the checkbox next to a data source to activate highlighting for its current range.

Configure center label

The center label displays text inside the gauge arc. The following options are available:

• Show: Shows or hides the center label.
• Value / Label / Units: Selects which elements appear in the center label.
• Color: Chooses between using the current marker color or a custom text color.
• Text Shadow: Adds a subtle black shadow beneath the label text to improve legibility against the gauge background.

Note: To exclude a specific data source from the center label, open that data source's configuration, go to Label, and disable the Center Label option.

Configure tooltip

Configures the hover tooltip for gauge values:

• Enabled: Turns the tooltip on or off.
• Type: Chooses whether the tooltip shows the live data values or the multi-state range information.

Configure trace options

Each data source can be rendered in one of three display modes:

• Marker: Renders the value as an icon positioned on the scale arc. Text labels are not available in this mode.

• Bar: Renders the value as a filled arc from the scale minimum to the current value position.

• Needle: Renders the value as a traditional gauge needle pointing to the current value on the scale.

Marker Settings

• Type: Selects the marker icon shape.
• Size: Sets the marker size.
• Position / Offset: Controls the marker's radial position. Use this to prevent overlapping when multiple data sources share the gauge.

Bar Settings

• Width: Sets the bar arc width in pixels.
• Position: Places the bar inside or outside the scale arc.
• Rounded: Enables rounded end caps on the bar arc.

Label Settings

Each marker or bar can display a label. The following options are available:

• Label: Shows or hides the floating label next to the marker or bar.
• Center Label: Includes this data source's value in the center label. If only one data source has this enabled, the value is displayed large. If multiple data sources are enabled, their values are stacked vertically.

Single Label Multiple Labels

Style settings

• Color: Chooses between Custom (a fixed static color) and Range (the color of the multi-state range the current value falls within).
• Border Color / Width: Sets the border color and width around the label.
• Background: Available for Bars only. Sets the background fill color of the area beneath the bar arc.

Troubleshooting and limitations

• Check: If the pointer is missing or pinned to an edge, check the value, scale range, and data status.
• Check: Range colors require an active multi-state configuration.