PI Vision dashboards guide: practices for asset-based displays

A PI Vision display is quick to build. A set of dashboards that stays useful across many assets, sites and years takes a few decisions up front. These practices are based on the AVEVA documentation and on our experience with PI Vision projects.

New to PI Vision? Start with our AVEVA PI Vision guide.

Build on PI AF

AVEVA recommends PI Asset Framework to get the most from PI Vision. Displays built on AF elements and templates can be reused for every asset of the same type, while displays built on single PI points have to be copied and maintained one by one. Our PI Asset Framework guide explains templates and attributes.

One display for many assets

With asset swap, users switch a display from one asset to another. By default, the asset list shows all assets created from the same template as the assets in the display. If an asset is not based on the same template and lacks an attribute, the display shows No Data; if an attribute is excluded on an asset of the same template, it shows N/A or a blank. Configure the multi-state of a symbol to hide bad data in such cases.

Collections for fleets of assets

Collections group similar assets in one display and add new assets automatically (AVEVA), for example all pumps of a unit. Since PI Vision 2017 R2, the search root of a collection can follow the related assets menu, so one collection display serves several areas.

Status at a glance

Multi-state symbols, tables and graphics change color or blink when values cross thresholds you define, and event tables show events next to the process data. Use a consistent color scheme across displays, so a red state means the same everywhere.

Calculations: know where they run

PI Vision 2020 introduced calculations on PI points in displays, and PI Vision 2021 added AF attributes, which also work with asset swap and collections. According to AVEVA’s PI Vision performance session, tag-based calculations run on the PI Data Archive and asset-based calculations on the PI Vision server, and extensive use of calculations is a common cause of slow displays. Results that many displays need belong in AF analyses instead.

Keep displays fast

The same AVEVA session lists the possible bottlenecks: client browser, network, PI AF server, PI Data Archive, the PI Vision application and the web server. Keep displays focused, avoid very long time ranges on dense trends, and check the data underneath: poorly tuned exception and compression settings also slow displays down, as our PI Tag Optimization page explains.

Organize and govern displays

PI Vision 2024 added moving folders and a permissions model for folders and displays, and the 2025 Display Utility can assign the Manage permission (PI Vision 2025 release notes). Use folders per site or team, separate development folders from published ones, and keep a change history: reVision keeps a revision history of PI Vision displays and restores earlier versions.

Events in the display with the PI Vision Suite

Event frames are where PI AF records what happened on an asset: downtime, excursions, batches (see our PI Asset Framework guide). The PI Vision Suite brings them into the display where people already work.

  • Gantt chart: shows the AF event frames of the displayed time range, grouped by event type. Hovering over an event shows its start, end, duration, severity and the attributes you configure.
  • Event Viewer: lists the events in a table where users acknowledge, comment on, edit and review event frames, and create new ones on the fly, for example to record a downtime reason during a shift.
AVEVA PI Vision OEE display with the PI Vision Suite Navigation Menu, a Gantt chart of production event frames and the Event Viewer table

OEE display in AVEVA PI Vision with three PI Vision Suite symbols: the Navigation Menu at the top, the Gantt chart of production events and the Event Viewer with reasons, comments and actions. Click to enlarge.

Assets at a glance with the PI Vision Suite

With many assets, the first question is often where something is happening. The PI Vision Suite answers it in the display:

  • Map: places AF elements on a map and shows their live status with custom icons, colors and status indicators, so a fleet of sites or vehicles fits on one screen.
  • Comparison symbols: doughnut charts, stacked bars and the calendar heatmap put assets or energy sources side by side and make recurring patterns visible.
  • Navigation Menu: built from an AF element structure based on templates, it puts the same menu on top of every display of a site, so users move between assets and displays without searching.
AVEVA PI Vision energy overview with PI Vision Suite doughnut charts, stacked bars, calendar heatmap and the Map symbol showing site status

Energy overview in AVEVA PI Vision built with PI Vision Suite symbols: doughnut charts, stacked bars and a calendar heatmap compare countries and energy sources, the Map symbol shows sites with their live status. Map data: OpenStreetMap contributors. Click to enlarge.

Symbols beyond the standard set

When the built-in symbols are not enough, the Amitec PI Vision Suite adds 41 custom symbols and 8 tools to AVEVA PI Vision, for example Sankey diagrams, calendar heatmaps, radar charts, stacked bars, maps and a date picker. Read how PI Vision custom symbols work.

Frequently asked questions

How do I make one PI Vision display work for many assets?

Build it on PI AF elements that share a template, then use asset swap. The asset list shows all assets created from the same template by default.

What is a PI Vision collection?

A collection groups similar assets in one display and adds new assets automatically, for example all pumps of a unit.

Why does my display show No Data after switching assets?

The new asset is not based on the same template and lacks the attribute. Assets with an excluded attribute show N/A or a blank instead.

Why is my PI Vision display slow?

Common causes are many calculations, dense trends over long time ranges and slow data sources. AVEVA lists browser, network, PI AF, PI Data Archive, the PI Vision application and the web server as possible bottlenecks.

How can we track changes to PI Vision displays?

PI Vision itself offers folders and permissions. For version control with a revision history and restore, use reVision.

Talk to a PI Vision expert

Tell us about your displays, and we will show you how to make them reusable and fast.

PI Vision Suite

41 custom symbols and 8 tools for AVEVA PI Vision. Free 30-day trial.

Want to know more?

Featured product

Amitec Industrial Knowledge Graph product box

Related posts