Learn how to configure and manage analyses

New analyses are listed on the Analyses tab. You can check on analysis status, whether or not an analysis is associated with a template, and find the analysis type, name, and its current backfilling/recalculation status.

To view the expression and scheduling for an analysis, select it from the Analyses viewer.

You can perform these tasks from the Analyses viewer:

• Create analyses

  You can click (New Analysis) at the top of the viewer, or right-click anywhere in the viewer and click New.

• Enable or disable a selected analysis

  You can select an analysis and click (Enable Analysis) or (Disable Analysis) at the top of the viewer.

• Set display columns

  You can right-click any column heading and select headings to display.

• Preview results

  You can preview results for an analysis to see how it operates over a specified time range by right-clicking an analysis and selecting Preview Results. You can export the results table to a spreadsheet or you can copy selected rows from the results table into other applications.

  For information on viewing trend charts for output times that are specified relative to trigger times, see Learn about trend charts and Preview Results.

• Backfill or recalculate data for an analysis

  You can execute an analysis over an earlier time period to backfill or recalculate data, as described in Backfill or recalculate data for an analysis.

  An expression, rollup, or SQC analysis can backfill or recalculate data if the analyses outputs are mapped to PI point attributes. You can backfill the missing data in a time range and retain existing data, or you can recalculate, which deletes and recalculates data in the time range.

  An event frame generation analysis can also recalculate event frames over a specified time period. The recalculation process, however, automatically deletes all existing event frames for that time period, as well as annotations on affected event frames.

  In order to backfill/recalculate, you need Execute permission on the analyses. Proper permission can be obtained by mapping your account to Asset Analytics Recalculation identity. Note that recalculation is only available for PI Analysis Service 2016 R2 or later. In addition, Data Archive that stores PI points must be running version 2016 R2 or later.

• Enable automatic recalculation for an analysis

  From PI AF 2017 R2, you can automatically recalculate analyses. Although automatic recalculation is globally enabled by default, you need to opt in at individual analysis (template) level if you expect late-arriving or out-of-order data that may trigger recalculation.

  An analysis listed with means automatic recalculation is enabled. See Configure automatic recalculation of analyses and analyses templates for more information.

• Open templates

  An analysis listed with alongside is based on an analysis template. You can open the template directly from the analysis by right-clicking the analysis and selecting Go to Template.

  Note: You can go to the analysis directly from the attribute by right-clicking the attribute and clicking Go to Analysis. If there is no analysis configured on the attribute, you will see New Analysis instead.

• Audit Trail Events

  You can open the audit log directly from the analysis by right-clicking the analysis and selecting Audit Trail Events. For more information on audit trail, see Track PI AF changes with Audit Trail.

• Reset to template

  Only scheduling changes can be made to an analysis that is based on an analysis template. To revert an analysis' scheduling to template scheduling, right-click the analysis and click Reset to Template.

• Convert to template

  If the element for an analysis is derived from an element template, you can convert the analysis to an analysis template on that element template by right-clicking the analysis and selecting Convert to Template. This feature enables you to develop and debug an analysis against a specific element before generalizing it as a template.

  Note: If any of the analysis outputs write to a specific PI point, you will be prompted to choose how to specify the PI point in the analysis template to ensure the outputs of derived analyses write to unique PI points.

To create specific types of analyses, see:

• Create an expression analysis

• Create a rollup analysis

• Create an event frame generation analysis

• Create an SQC analysis