Analytics & Visualization · PI Vision Custom Symbol

How to Add a Gantt Chart to AVEVA PI Vision

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

Event Frames

Your Event Frames, Instantly on a Timeline

Pick an AF database — lanes per asset, colors per severity

Point the symbol at an AF database and every event frame in the display time range appears as a bar — grouped into lanes by asset, template, severity or name, colored by severity, following the PI Vision time bar automatically.

• Works with any Event Frame template
• Group by asset · template · severity · name
• Severity color mapping out of the box
• Follows the display time bar automatically

Inline Editing

Acknowledge & Annotate Without Leaving the Chart

Tooltip → details → attribute values → one-click ack

Hover for a configurable tooltip; click for the full picture — attributes, annotations and comments. Acknowledge, edit or annotate right there: writes go through PI Web API with the viewer’s own account.

• Configurable hover tooltip
• Details view: attributes, annotations, comments
• One-click Acknowledge (write-back)
• Edit name, severity & description inline

Downtime Pareto

The Question That Pays: What Cost Us the Most?

Causes ranked by total duration — click to filter

One toolbar button ranks every cause in the current view by total duration. Click a cause and the chart filters to exactly those events. This is the analysis plant managers actually ask for.

• Top-N causes by total duration
• Rank by name, template, severity or asset
• Click a cause → chart filters to it
• Live: recalculates with filters and time range

Time-Series Mode

No Event Frames? Plain Tags Work Too

Each tag becomes a lane, every state change becomes a bar

Drop ordinary digital or analog tags: each tag becomes a lane and every state change becomes a bar. Search or use the per-tag state filter to isolate exactly the runs you care about.

• Digital states → bars automatically
• Analog tags auto-band to Low/Mid/High
• Per-tag state filter & text search
• All Gantt features work: tooltip, Pareto, CSV

Analog Banding

Analog Tags, Meaningful States

Auto bands with zero setup — or exact spec limits

Analog signals are split into Low/Mid/High automatically using an outlier-proof 5–95 percentile range (2–5 bands). Need exact alarm limits? Switch to manual ranges with your own labels and colors.

• Auto banding — zero configuration
• Outlier-proof percentile range
• Steady signals collapse to a single labeled bar
• Manual mode for spec / alarm limits

Layout & Style

Pack It Your Way

Compact, single-row or row-per-state — plus full styling

Choose how overlapping bars stack: compact, everything on one row, or a dedicated row per state for vertical pattern comparison. Lane height, colors, the now-line, Σ duration stats and CSV export round it out.

• Three packing modes
• Now-line & Σ duration in the toolbar
• CSV export of the filtered view
• Auto-contrast text on any background

Frequently asked questions

Does Gantt Chart 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].