Gauges & KPI · PI Vision Custom Symbol

How to Add a Linear Gauge to AVEVA PI Vision

Everything you need to get the PIForge Linear 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 Gauge That Reads Itself

Multistate zones + zone-colored fill

The fill bar takes the color of whichever zone the value is in — green, amber, red — so state is obvious across the control room without reading a single number.

• Zone-colored fill (or fixed color)
• Unlimited multistate zones
• Big value label with auto-contrast
• Ticks, units and decimals fully configurable

Forecast

Time-to-Limit: Act Before the Alarm

Live "↗ 23 min → 85 %" from the recent trend

A live least-squares trend of the recent window forecasts when the value will reach your limit — and shows it right on the gauge. Flat signals stay quiet; only meaningful drift speaks.

• Live countdown to your limit
• Trend window & limits configurable
• Auto-hides when flat or > 48 h away
• Arrow color = the zone you are heading into

Peak Hold

Excursions That Refuse to Hide

Session min/max watermarks, one-click reset

The value came back to normal — but the peak-hold markers still show how far it went. Classic panel-meter behavior, finally in PI Vision.

• Session min & max watermarks
• Hover for exact peak values
• One-click reset in the panel
• Marker color configurable

Multi-Pointer

PV, Setpoint and Limits on One Scale

Drop more tags — pointers appear automatically

Every tag you drop becomes its own pointer — arrow, line or bubble, each with its own color and label. Add static target markers for HiHi/LoLo and the comparison is instant.

• Pointer auto-created per dragged tag
• Arrow · line · bubble styles
• Static target markers with labels
• Up to 8 pointers on one scale

Layouts

Vertical or Horizontal — One Dropdown

Same gauge, any dashboard slot

Rotate the whole gauge with a single setting. Ticks, labels, zones, forecast and peak-hold all re-lay themselves out for the horizontal footprint.

• One-click orientation switch
• All features work in both layouts
• Fits headers, sidebars and KPI strips
• Resizes crisply with the symbol

Zone Editor

Zones You Can Actually Edit

Rows in the panel — the track updates live

Each zone is a simple from-to-color row. Change a boundary and the track repaints instantly; add as many zones as your operating envelope needs.

• From / to / color rows — no dialogs
• Live preview while typing
• Unlimited zones
• Zones drive fill color and forecast arrow

Frequently asked questions

Does Linear 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].