PI Vision Custom Symbol : CUSTOM RADIAL GAUGE

Description

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 AF

    

    For PI AF Attributes, this option is selected by default.
    
  • Fixed Limits : indicates that the limits are manually set

    

    For 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)
• PI Vision 2024 (build 3.10.0.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)
• PI Web API 2023 SP1 Patch 1 (version 1.18.0.572)

Asset Switching

This custom symbol is fully compatible with the asset switching feature.

Dependencies

No dependency required :

• No external library
• No polyfill