PI Vision Custom Symbol : BOX PLOT

Description

The PI Vision custom symbol Box Plot is a single OR multiple datasource symbol that allows you to draw PI AF attribute values or PI tags values as vertical box plots.

Features

The Box Plot custom symbol is compatible with numerical values.

For each box plot, the symbol displays :

• Three horizontal lines for the minimum value, the maximum value and the statistical median
• A vertical line between the minimum value and the maximum value
• A box (rectangle) that belongs to the statistical second and third quartiles
• Dots to show the spread and skewness of the actual values

Configuration options

Visibility

Each graphical element can be hidden individually :

Datasources

You can manage the list of the symbol's datasources, similarly to other multiple datasource symbols :

Time Range Slicing

This option is enabled for symbols with a unique datasource .

When slicing is activated, the symbol creates as many box plots as defined by its configured time unit and the display time range.

• Year Formatting options :

Full Year : 2020, 2021, 2022, etc..

2 Digits Number : 20, 21, 22, etc…

Grouped By Decades : 2000-2009, 2010-2019, 2020-2029, etc…

• Month formatting options

Name : January, February, March, etc…

Short Name : Jan, Feb, Mar, etc…

Number : 1, 2, 3, etc…

2 Digits Number : 01, 02, 03

MM/YYYY : 01/2025, 02/2025, 03/2025, etc…

• Week formatting options

Week Number : 1, 2, 3, etc…

2 Digits Number : 01, 02, 03, etc…

Week + Index : Week 1, Week 2, Week 3, etc…

• Day formatting options

Day Number : 1, 2, 3, etc…

2 Digits Number : 01, 02, 03, etc…

DD/MM : 01/01, 02/01, 03/01, etc…

Weekday Name : Monday, Tuesday, Wednesday, etc…

Axes

• X-Axis Color
• Y-Axis Color

Box

• Box Background color
• Box width
• Box border color
• Box border width

Lines

• Vertical line color
• Maximum line color
• Median line color
• Minimum line color
• Vertical line width in pixels
• Horizontal lines width in pixels (same value for maximum, median and minimum)

Dots

• Dots inner color
• Dots size in pixels

Colors

• Backgound color
• All other graphical element colors

Layout

All margins values are in pixels.

• Top margin
• Right margin
• Bottom margin
• Left margin

Note : Unticking the checkbox "Graph Margins" is equal to set all margin values to zero.

Borders

• Border color
• Border weight in 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

Fully based on Data Services (like all core PI Vision symbols).

Do NOT require PI Web API.

Asset Switching

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

Dependencies

No dependency required :

• No external library
• No polyfill