Data Table

- PI Vision Widget -

Revision History

Revision No.	Date	Author	Document ID	Description of changes
10.1	June 2026	RES	EW_Distribution_Plot_v10.1	Graphic restyle.
10.0	June 2026	RES	EW_Distribution_Plot_v10.0	Compatibility PIVision 2025.
9.1	December 2025	RES	EW_Distribution_Plot_v9.1	Added “sub-intervals” configuration.
9.0	March 2025	RES	EW_Distribution_Plot_v9.0	Compatibility PIVision 2024.
8.0	August 2023	CC	EW_Distribution_Plot_v8.0	Compatibility PIVision 2023.
1.0	May 2023	CC	EW_Distribution_Plot_v1.0	First version.

Document References

Document	Description
PI Vision Installation and Administration Guide	PI Vision™ user manual from AVEVA

Introduction

The EWDistributionPlot widget allows you to view a frequency distribution chart for an AF attribute, considering the PIVision time range.
Dragging an AF attribute onto the display will create a graph via the D3.js library, which will have the following by default:
- The x-axis will consist of 10 equidistant intervals of AF attribute values (the range size can be configured by the user in the settings)
- The y-axis showing the frequency of the values
The widget will also display additional statistical information such as the mean, median, Gaussian distribution, etc.
When you hover the mouse over the histogram bars, a tooltip will appear showing information about the distribution.

Definitions, Acronyms And Abbreviations

Acronyms and definitions that are used in the current manual are listed below.

Term	Definition
AF	Asset Framework
UOM	Units of Measure

Operating Principles And Use

To insert the DistributionPlot widget in a PI Vision display, navigate the AF, select the attribute and drag it on the display to initialize the widget.

Figure 1 - PI Vision Menu

Once you have dragged the AF attribute onto the display, a frequency distribution chart for that attribute will be generated, based on the PIVision time range.
Upon creation, the chart will display the default settings, and in addition will display the Average and Standard Deviation.
As well as in the settings, you’ll be able to choose which statistical calculations to display using a menu within the widget itself.

The calculations that can be displayed will include:

• Average
• Median
• Mode
• Gaussian
• Standard Deviation

Figure 2 - Widget insert

In order to access the configuration menu of the widget, right click on the control and select Configure Distribution Plot.

Figure 3 - Contextual Menu

Customization and configuration

The widget configuration allows to change the appearance in terms of colours, text size and language visualization.

Language

The section Language allows the user to choose the language with which the user visualizes labels and configuration parameters.

Figure 4 - Language selection

Configurations

The section Configurations allows the user to modify the behaviour of the widget..

Figure 5 - Configurations

Setting	Description
Number of decimals	The number of decimals to show for the numbers.
Divide by	Can select between “Bar Number” and “Range”.
Bar Number (divided by Bar Number selected)	How many bars to divide the plot into. (e.g 10, 20, 50 etc…).
Step range (divided by Range selected)	The value of each step. (eg 10, 50, 100 etc…).
Sub-intervals	Divides bars in sub intervals.
Magnitude sub-intervals (Sub-intervals selected)	The magnitude of each sub interval inside the bar/range.
UOM sub-intervals	UOM of sub-intervals. (eg minute, hour, day, week etc…).

Table 1 - Configurations

Stats

In the Stats section, it is possible to show/hide those stats on the plot.

Figure 6 - Stats

Appearance Settings

In the Appearance Settings section, it is possible to change the aesthetic appearance of the widget.
The configurable parameters are:

• Title;
• Title text size;
• Tooltip text size;
• Show/Hide grid;
• X axis label;
• Axis label text size;
• Legend text size;
• Title color;
• Background color;
• Axis color;
• Grid color;
• Tooltip text color;
• Tooltip background color;
• Bar color;
• Bell-Curve Color;
• Legend color;
• SVG margins;

Figure 7 - Appearance Settings

Colors Selection

To select a color click on the color’s dropdown menu. The Gradient panel will open. From this panel the user can select which color, transparency or color format he wants. A second panel named Palette view is present if the user wants to select from a few pre-determined colors. Confirm with the button .

Figure 8 - Choice of color

Contact Us

Get Support button (read Get Support documentation)

Link to e-matica.com (click on the icon)

Link to widget online documentation (click on link)

Figure 9 - Contacts

Installation

Following are the installation requirements and procedure.

Requirements

In order to install the product, minimum requirements are listed in the table below:

Software	Version	Note
PI Vision	2025 (*)	Requirements are linked to the PI Vision correct functioning

Table 2 - Installation prerequisites

(*)This widget is also compatible with PI Vision 2024, 2023, 2022, 2021, 2020 and 2019.

We suggest using Google Chrome for full compatibility with the widget.

Installation procedure

Widget Installer

To install the widget’s files and common libraries using the widget installer follow the guide at this link:
https://documentation.e-matica.com/docs/WidgetInstaller.

Manual installation

The installation procedure involves copying various folders and files into the predefined PI Vision path.

In particular, copy the following files to:
..\PIPC\PIVision\Scripts\app\editor\symbols\ext

• sym-EWDistributionPlot.js
• sym-EWDistributionPlot-config.html
• sym-EWDistributionPlot-template.html

Then, in the folder:
..\PIPC\PIVision\Public

copy the following folders:

• Images which includes the control icon:
  • EWDistributionPlot.png
• Libs which includes the libraries:
  • EWClasses.js
  • Moment.js
  • D3.js

Then, open the web.config file inside the PIVision folder (..\PIPC\PIVision) and check that debug is set to "true" (Figure 10).
Save the file and restart the IIS.

Figure 10 - web.config

Notes And References

For more information about Vision PI refer to documentation on AVEVA © portal.
For information about the web service to refer to the specific documentation.