The PI Vision custom symbol Custom Radial Gauge is a single datasource symbol that behaves similarly to the native symbol Radial Gauge, and also displays colored sectors and marks, to highlight the datasource limits :
Minimum
Lowest limit (LoLo)
Low limit (Lo)
High limit (Hi)
Highest limit (HiHi)
Maximum
Target
Example :
This symbol will easily integrate to your existing PI Vision displays : everywhere you have a Radial Gauge, you can replace it by a Custom Radial Gauge and show useful limits.
For sure, this will significantly improve the user experience.
The Custom Radial Gauge is compatible with PI Points and PI AF Attributes as well.
In fact, with all data types that support limits :
Byte
Int16
Int32
Int64
Single
Double
Features
All features of the native radial gauge are available in the Custom Radial Gauge.
Moreover, this symbols displays 5 colored sectors, and a target mark near to the value indicator and the scale range.
Those new elements are fully customizable (colors, sizes, show or hide, etc...).
For example, the size of the sectors can be set for all types of indicators :
Moreover, you can set the values of the limits manually (fixed limits), or retreive dynamically the limits of a PI AF (attribute limits).
Configuration options
In the configuration panel, you can find all the same options as the native Radial Gauge, plus 3 new option groups : "Limits", "Target" and "Borders".
Limits
Show Limit Sectors : you can choose to show the limit sectors or not. If you disable this feature, the symbol will look exactly the same as the native Radial Gauge
You can set a different color for each of the 5 sectors :
Even give some of them a transparent background
Padding : for the "Arc" indicator, this slider allows you to adjust the space betweeen the indicator and the sectors.
Attribute Limits : indicates that the limits are retreived from PI AFFor PI AF Attributes, this option is selected by default.
Fixed Limits : indicates that the limits are manually setFor PI Points, this option is selected by default, and the option "Attribute Limits" is disabled
Target
Show Target : you can choose to display the target mark or not.
Target mark above indicator : when displayed, the target mark can be placed above, or below the indicator Examples :
Color, width and size of the target mark can be adjusted Examples :
Attribute Target : similarly to limits, for PI AF Attributes this option is selected by default :
Fixed Target : for PI Points, this option is selected by default, and the option "Attribute Target" is disabled
Borders
As for each of my custom symbol, you can add borders, and specify their color and weight (from 0 pixel to 20 pixels)
Technical considerations
Compatibility
This custom symbol is compatible with PI Vision 2017 R2 or later.
Tested with :
PI Vision 2017 R2 SP1 (build 3.3.1.0)
PI Vision 2019 Patch 1 (build 3.4.1.0)
PI Vision 2020 Patch 1 (build 3.5.1.0)
PI Vision 2021 Patch 1 (build 3.6.1.0)
PI Vision 2022 (build 3.7.0.0)
PI Vision 2022 Patch 1 (build 3.7.1.0)
PI Vision 2023 (build 3.8.0.0)
PI Vision 2023 SP1 Patch 1 (build 3.9.1.0)
Data retrieval
Based on PI Web API.
Tested with :
PI Web API 2018 SP1 (version 1.11.1.5474)
PI Web API 2019 SP1 (version 1.13.0.6518)
PI Web API 2021 SP2 (version 1.16.0.254)
PI Web API 2021 SP3 (version 1.17.0.200)
Asset Switching
This custom symbol is fully compatible with the asset switching feature.