Fast Fourier Transform

- PI Vision Widget -

Revision History

Revision No.	Date	Author	Document ID	Description of changes
9.0	June 2025	RS	EW_FastFourierTransform_v9.0	-Compatibility PIVision 2024 -Added Get support-Added rest provider -Graphic restyle
8.1	November 2023	MDC	EW_FastFourierTransform_v8.1	Edit calls with external PIWebAPI
8.0	August 2023	FP	EW_FastFourierTransform_v8.0	Compatibility PIVision 2023
7.0	August 2022	AM	EW_FastFourierTransform_v7.0	Compatibility PIVision 2022
6.1	May 2022	MDC	EW_FastFourierTransform_v6.1	Axis bugfix
6.0	October 2021	MDC	EW_FastFourierTransform_v6.0	Compatibility PIVision 2021
4.0	October 2020	OS	EW_FastFourierTransform_v4.0	Compatibility PIVision 2020
1.7.1	September 2020	MDV	EW_FastFourierTransform_v1.7	Revision of documentation
1.7	April 2019	GI	EW_FastFourierTransform_v1.7	New Linear Graphic mode, bug fixes
1.6	March 2019	GI	EW_FastFourierTransform_v1.6	First version documentation

Document References

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

Introduction

The EW FFT (Fast Fourier Transform) widget allows you to view, through the use of a three-dimensional graph, the link between the Frequency and the Amplitude (or other magnitude) of a signal in the time interval defined by the display PI- Vision. Frequency and Amplitude are two attributes that have a PI Point as their data reference.

The PI Vision of AVEVA is available from 2017 and allows viewing real-time data from PI Data Archive and data organized in assets from the AVEVA Asset Framework (PI AF). In order to achieve PI Vision displays, simply access to https://webServer/PIVision (indicating the correct name of the webserver machine).

The most recent versions of most HTML5 compatible browsers are supported on computers, tablets and phones running Android and iOS.

In PI Vision the configuration of the elements is quite intuitive and is characterized by a simple drag-and-drop of the control into the display.

Definitions, Acronyms And Abbreviations

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

Term	Definition
FFT	Fast Fourier Transform
AF	Asset Framework

Operating Principles And Use

To insert the Fast Fourier Transform widget in a PI Vision display, it is necessary to first select the control icon, and then the elements to be displayed and then drag them onto the display.

Figure 1 - PI Vision Menu

Then by selecting the contextual menu you can access the specific configuration of the widget.

Figure 2 - Contextual Menu

Figure 3 - Widget Example

Functionality and use

To use the FFT widget, it is necessary to define an AF category within which the three attributes associated with the PI Points are present:

• Amplitude;
• Scan;
• Frequency.

Figura 4 - Example of AF categorization

The widget extracts the time intervals in which the scan attribute is equal to 1, and generates a menu from which it is possible to select the time range for which to display on the graph the values ​​of amplitude and frequency.
Once the desired range has been selected from the menu, the widget represents the sampled amplitude and frequency values ​​in that interval in the three-dimensional graph.
Through the menu on the left, shown in Figure 3 and visible if a range has been selected, it is possible to temporarily customize the maximums and minimums of the Y and Z axes (Frequency and Magnitude in the previous image).
By using the menu on the left-bottom in Figure 3, regarding Frequency and Magnitude, it is possible to set the domain of the axes visualized in the plot.

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 users to choose the language with which the user visualizes labels and configuration parameters.

Figure 5 - Language selection

Configurations

Figure 6 - Configurations

In the Configuration section it is possible to change different parameter:

• Select if the widget will interact with the trends;
• The graph type;
• The server web api;
• The scan attribute;
• FFT category
• Conversion factor;
• Table with the name and label of frequency and amplitude attributes;
• REST Provider

Interaction

You can define whether the widget should interact with the Trend widget standard.

Figure 7 - Trend interaction

Graph Type

You can choose between two graphic modes, Linear or Surface (see Figure 12 e Figure 13)

Figure 8 - Graph type

Server web api

Text input that allows the user to insert the path of the Server Web API.

Figure 9 - Server Web API

Scan attribute

Indicate the name of the Scan attribute

Figure 10 - Scan attribute

FFT category

Indicate the name of the AF Category for the FFT Widget

Figure 11 - FFT category

Conversion factor

Indicate a numerical value as a conversion factor for the amplitudes

Figure 12 - Conversion factor

Frequency/Amplitude attribute

Indicate the name of the Frequency and Amplitude attributes and the label of the axis

Figure 13 - Conversion factor

REST Provider

Allows the user to select between default or custom protocol for api requests.

Figure 14 - REST Provider selection

Appearance Settings

In the Appearance settings section it is possible to change the value and color of:

• Title;
• Text size;
• Title color;
• Text color;
• Background color;
• Truncate interval color;

Figure 15 - Appearance settings

Colors selection

To configure the different colors simply select the color drop-down menu and choose the gradation on the first horizontal scrollbar, the possible point of the color palette and indicate with the second horizontal scrollbar the eventual transparency level. To confirm, select the button.

Figure 16 - Choice of color

Contacts

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 17 - 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	2024 (*)	Requirements are linked to the PI Vision correct functioning

Table 1 - Installation prerequisites

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

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

Installation procedure

The installation procedure involves the copy of different folders and files in the predefined PI Vision path.

In particular it is necessary to copy the following filed in the folder ..\PIPC\PIVision\Scripts\app\editor\symbols\ext:

• sym-EWFFT.js;
• sym-EWFFT-config.html;
• sym-EWFFT-template.html;

and in the folder ..\PIPC\PIVision\Public the following folders:

• Images that contains the control icon:

  • EWFFT.png;

• Libs with the libraries used:

  • EWClasses.js;
  • Moment.js;
  • Plotly.min.js.

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

Figure 18 - 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.