Analytics & Visualization · PI Vision Custom Symbol

How to Add a Correlation Pro to AVEVA PI Vision

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

Multi-Mode Process Analytics — One Symbol, Five Views

Density, Time Series, Rolling Correlation, Trajectory, Correlation Matrix

Smart Pattern Pro transforms raw PI tag pairs into five distinct analytical views — all live, all in PI Vision, no external tools. Switch between visualization modes to answer different questions about your process without leaving the display.

• XY Density: where does your process actually run — not just where it trends
• Time Series Heatmap: how temperature distributes across each hour of the day
• Rolling Correlation: watch the relationship between tags evolve over time
• Trajectory: follow the exact path your process took through XY space
• Correlation Matrix: four-tag correlation snapshot for multi-variable monitoring

Visualization

XY Density Heatmap — See Where Your Process Actually Lives

Thousands of data points compressed into one intuitive color map

A trend line shows you the last value. A density heatmap shows you where your process spends its time. As more data arrives, the map builds up — revealing clusters, outliers, and the true operating envelope of your process.

• Color intensity maps frequency: bright = where you run most of the time
• Sparse regions reveal outliers that a trend line would hide
• X and Y bin resolution configurable — coarse overview or fine-grained detail
• Manual axis override: fix the scale to compare across different time windows

Visualization

Five Visualization Modes — Switch Without Reconfiguring

Each mode answers a different process question from the same data

One symbol configuration, five analytical lenses. Switch modes from the configuration panel to move from spatial density to temporal patterns, correlation tracking, process trajectory, or multi-tag matrix — without changing the underlying data connection.

• Density: spatial frequency — where does the process cluster in XY space
• Time Series: temporal patterns — which hours of the day run hot or cold
• Rolling Correlation: dynamic relationship — is the correlation stable or shifting
• Trajectory: process path — how did the process move through XY space
• Matrix: multi-variable overview — correlation coefficients for up to 4 tags at once

Density Settings

Configurable Resolution — From Overview to Detail

Adjust bin count to match the precision your analysis needs

Coarse bins give you a fast process overview. Fine bins reveal the detailed structure within each operating region. Adjust X and Y bin resolution independently to match the range and precision of each axis.

• Low bin count (10×10): fast orientation, clear cluster centers
• High bin count (30×30): fine structure, hotspot detail within clusters
• Independent X/Y resolution: match the natural scale of each variable
• Changes apply instantly — no page reload required

Correlation

Rolling Correlation — Detect Relationship Changes in Real Time

Pearson r calculated over a sliding window — trend before it shifts

A static correlation coefficient hides the history. The rolling correlation view plots r over time using a configurable sliding window — letting you see when two variables move in lockstep and when that relationship breaks down.

• Rolling window configurable: 10 points (reactive) to 40 points (stable)
• Reference lines at r = +0.5, 0, -0.5 for instant visual benchmarking
• Narrow window: sensitive to short-term shifts — catches transient decoupling
• Wide window: smoothed trend — confirms long-term relationship stability

Frequently asked questions

Does Correlation Pro 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].