1. Navigate to the Analytics module by clicking on the icon on the Modules sidebar on the left side of the iTwin IoT application. This window houses previously created analyses completed by you or shared with you. 

 

 

2. To create a new correlation analysis click the blue "+ Correlation Analysis" button at the top of the page. The next screen will be the Analysis configuration screen, an example shown below. We will walk through the configuration options below.

 

 

A. Analysis Name- Input a name for the analysis so that you can navigate back to it and share it.

B. Target Sensor Selection- The target sensor is the sensor you will select that you want to compare other sensors against to find potential correlations and relationships. A sensor selection window like the one below will open for you to select the target sensor.

Note: Only one target sensor can be selected for each analysis.

 

 

Certain sensor metrics may also have additional configuration options, as seen in the example below.

For information about metrics, visit this page: Sensor Metric Definitions.

For information about metric configuration options visit this page: Sensor Configuration Parameters for Calculated Metrics

 

 

C. Advanced Settings- Clicking the Advanced Settings expansion dropdown reveals two additional configuration options.

Analysis Time Range- The Time Range selection allows you to pick a time frame for the data to be included in the analysis. The "Auto" toggle automates the time range selection, optimizing both data quality and processing performance.

Sampling Interval- The sampling interval averages the data over the selected timeframe to then compare between the target sensor and the comparison sensors. This can be useful if comparing sensors with differing sampling intervals or if reducing the number of data points you want to run in the analysis.

Interval selection smooths the data analysis; too short may add noise, but too long may miss key trends in the data. If you don't want to manually configure the Sampling Interval, you can select "Auto" and the system will choose a sampling interval for you.

D. Comparison Sensor Selection- The comparison sensors will be the sensors that you wish to run the analysis on to find possible correlations with the target sensor. The same window as the target sensor selection will appear, allowing you to select up to 25 sensors to analyze against the target sensor.

E. Comparison Sensor Configuration- A tile will appear for each comparison sensor you select. You can then select the metric and metric unit for each comparison sensor.

F. Save & Run Analysis- Clicking the "Save & Run" button will begin running the analysis and direct you back to the main Analytics page, where a progress bar will show you the status of the currently running analysis.

 

 

 A "Completed" message will appear when the analysis is finished running, and you can then open the analysis output!