Gauges & KPI · PI Vision Custom Symbol

How to Add a Radial Gauge to AVEVA PI Vision

Everything you need to get the PIForge Radial Gauge symbol running on your AVEVA PI Vision server — installation, license activation, and a tour of every feature with live video.

Installation — 5 steps, about 10 minutes

1. 1

   Download the package

   Purchase the symbol at piforge.app and download the ZIP from your profile. It contains four files: the symbol script (.js), two templates (.html) and an icon (.svg).

2. 2

   Copy the files to the PI Vision server

   Extract all four files into the PI Vision extension folder on the server: %PIHOME%\PIVision\Scripts\app\editor\symbols\ext\ (create the ext folder if it does not exist yet).

3. 3

   Restart the PI Vision application

   Recycle the PI Vision application pool in IIS (or run iisreset), then hard-refresh the browser (Ctrl+F5) so the new symbol script is loaded.

4. 4

   Add the symbol to a display

   Open a display in edit mode. The new symbol appears in the symbol palette on the left. Select it, then drag a tag or AF attribute onto the canvas.

5. 5

   Activate the license

   Open Format Symbol, paste the license key from your purchase email into the License field, and save. The watermark disappears immediately — no restart needed.

What you can do with it

Live Display

A Radial Gauge That Tells You the State

Needle, multistate arc zones, zone-colored center value

The needle sweeps live while the big center value takes the color of the active zone — readable across the room, on light or dark displays.

• Smooth live needle
• Multistate zones on the arc
• Center value colored by zone
• Auto-contrast ticks & labels

Ghost Pointer

Am I Better or Worse Than an Hour Ago?

A faded marker shows the past value — with Δ on hover

The ghost pointer marks where the value was N minutes ago. One glance answers the question every operator asks — no trend chart needed. Hover for the exact past value and delta.

• Past value as faded needle/marker
• Configurable offset: 60 min, 4 h, 24 h…
• Exact value + Δ on hover
• Unique — no other PI Vision gauge has it

Gauge Angles

Any Arc: 180°, 240°, 360° — You Decide

Start angle and sweep are just two numbers

Classic three-quarter gauge, a compact semi-circle for headers, or a full ring for modern KPI tiles — set start and sweep and the ticks, zones and indicators re-lay themselves out.

• Free start & sweep angles
• Full-circle mode
• Ticks and zones follow the arc
• Rounded or square arc caps

Multi-Ring

Three Tags, One Gauge

Concentric rings with a color-matched center legend

Drop several tags and switch on Multi-Ring: each becomes its own concentric arc, with a color-matched legend and values in the center. Compare related KPIs in the footprint of one symbol.

• A ring per dragged tag
• Center legend with live values
• Ring thickness & gap configurable
• Up to six rings

Indicators

Needle, Arc or Marker — Per Indicator

Pick the style that fits the story

A classic needle for process values, a progress arc for completion KPIs, a quiet marker dot for references — each indicator picks its own style and color.

• Three indicator styles
• Per-indicator color & label
• Optional per-indicator value labels
• Mix styles on the same gauge

Zones

Zones That Drive Everything

Arc segments + center value color from one editor

Zones are simple from-to-color rows. Move a boundary and the arc repaints, the center value recolors, and your operating envelope is documented right on the gauge.

• From / to / color rows
• Live preview while editing
• Center value follows the active zone
• Unlimited zones

Frequently asked questions

Does Radial Gauge work with my PI Vision version?

Yes — PI Vision 2019 R2 through 2023+ are supported. The symbol uses the standard PI Vision extensibility model, so regular version upgrades do not break it, and one year of compatibility updates is included.

Do I need to install anything on client PCs?

No. The symbol is installed once on the PI Vision server; every browser client gets it automatically from there.

How is it licensed?

One license covers one PI Vision server, with unlimited displays and unlimited users on that server. The key is delivered instantly by email after purchase.

Can I try it before buying?

Every feature is demonstrated in live video on the product page, and a free symbol (Combo Chart Free Edition) is available on GitHub to validate the install workflow end to end. For evaluation keys, contact [email protected].