Analytics & Visualization · PI Vision Custom Symbol

How to Add a Duval to AVEVA PI Vision

Everything you need to get the PIForge Duval 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

Overview

Read What the Oil Is Telling You

Duval Triangle DGA, live on your PI data

Transformer oil carries the signature of what is failing inside. Drop your dissolved-gas attributes on the symbol and PIForge Duval recognises H2, CH4, C2H2, C2H4, C2H6, CO and CO2 by name - no mapping to configure - and places the fault point in its IEC 60599 zone immediately.

• Automatic gas to tag mapping straight from your AF model
• IEC 60599 fault zones: PD, T1-T3, D1-D2, DT
• Gas ppm readout with plain-language diagnosis
• Runs on data you already historise - no external service

Diagnostic Models

Four Triangles, One Symbol

Mineral oil, load tap changers and low-temperature faults

There is not one Duval triangle - there are four, each for different equipment and fault regimes. Switch between them without leaving the display.

• Triangle 1 - general fault classification for mineral oil
• Triangle 2 - filters the normal switching arcs of a load tap changer
• Triangles 4 and 5 - resolve low-temperature faults Triangle 1 cannot separate
• Zone letters, axis labels and legend stay readable on a wall display

History Trail

A Snapshot Is Not a Diagnosis

Twelve oil samples, one trajectory

A single point tells you where the transformer is. The trail tells you where it has been. It is built from the display time range, so the progression of the fault is visible at a glance.

• Plots every DGA sample in the window as a fading trail
• Trail length configurable from 2 to 60 points
• Hover any point for its timestamp and gas mix
• In the demo the fault walks from T1 into T3 over five weeks

Fault Projection

Where Is It Heading?

Extrapolates the recent trend into the next zone

Fault Trajectory Projection extends the recent movement and warns which fault zone the transformer is driving toward - so you catch escalation before it happens.

• Projects the recent trend forward, 1 to 10 steps
• Shows the direction of travel on the triangle
• Warns when the projected path enters a more severe zone
• Turns a diagnosis into a forecast

IEEE C57.104

The Fault Type Is Only Half the Answer

Condition, action and re-sampling interval

Operations needs a verdict, not a coordinate. The C57.104 assessment gives severity and action: total dissolved combustible gas to Condition 1-4, per-gas L1 exceedance, gas generation rate per day, and the recommended sampling interval.

• IEEE C57.104 Condition 1-4 from TDCG
• Flags every gas over its L1 threshold
• Gas rate in ppm per day - how fast it is getting worse
• Recommended re-sampling interval and action text

Branding

Match Your Site Standard

Every colour, size and label is yours

Zone fills, point size, pulse animation, grid, ticks and title are all configurable so the symbol fits the look of your existing displays.

• Per-zone colour swatches
• Point size, colour and attention pulse
• Grid, tick labels and title toggles
• Auto or fixed text colour, adjustable font size

Frequently asked questions

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