Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

Analytics and Notifications for PI System Explorer (PI Server 2018)

Create event frames automatically to track inefficiency

Create event frames automatically to track inefficiency

  • Last UpdatedJan 10, 2025
  • 3 minute read

We created a sample analysis to track how the efficiency of a process deviates from the target efficiency in Build an expression analysis to study efficiency deviation. In this example, we create event frames to capture data any time the 15-minute running-average efficiency drops below 90%.

Prerequisite: Complete the steps in Build an expression analysis to study efficiency deviation.

  1. In the Library browser, expand Templates.

  2. Right-click Event Frame Templates and then click New Template to create a new event frame template.

  3. In the Name field, enter EfficiencyAnomaly.

  4. In the Naming Pattern field, specify the name of the event frames produced from the template.

    You can use substitution parameters to specify a varying name. PI AF resolves the parameters when creating the event frames. Then, each event frame will have a unique, identifiable name.

    1. Click the arrow next to the field to see valid substitution parameters that you can add to the name.

    2. Select %ELEMENT%.

    3. Select %STARTTIME:yyyy-MM-dd HH:mm:ss.fff%.

      The STARTTIME substitution parameter includes the date-time formatting pattern to use.

    A screenshot of the General tab in PI System Explorer that shows the name and naming pattern for a new event frame template named EfficiencyAnomaly.

  5. Click the Attribute Templates tab.

  6. Create a new PI point data reference attribute using an attribute template.

    1. Click New Attribute Template.

    2. In the Name field, enter Efficiency.

    3. Click Settings and enter the following configuration string in the Tag name field:

      .\Elements[.]|Efficiency; uom=%

    4. From the Default UOM list, select percent.

      A screenshot of the Attribute template tab in PI System Explorer that shows percent assigned as the default UOM for the new Efficiency attribute template.

  7. In the Elements pane, click Ethylene, the element for which you built an analysis in Build an expression analysis to study efficiency deviation.

  8. Click the Analyses tab.

  9. Click New Analysis .

    • Name

      Enter EfficiencyAnomalyEvent.

    • Analysis Type

      Click Event Frame Generation.

  10. From the Event Frame Template list, select EfficiencyAnomaly.

    This is the event frame template you created in the earlier steps.

  11. Enter expressions that specify the start and end of the event frame:

    • StartTrigger1

      TagAvg('Efficiency', '*-15m', '*') <90

    Creates an event frame whenever the 15-minute average efficiency drops below 90%.

    • EndTrigger

      TagAvg('Efficiency', '*-15m', '*') >92

    Ends the event frame whenever the 15-minute average efficiency has recovered and exceeds 92%.

  12. Click Evaluate to check the current values of the expressions.

    The Value column is populated with either True or False for each condition.

    1. For the Scheduling option, click Periodic.

    2. Click Configure and set the analysis to run every minute.

  13. Specify scheduling for the analysis.

    1. For the Scheduling option, click Periodic.

    2. Click Configure and set the analysis to run every minute.

  14. Check in your work.

TitleResults for “How to create a CRG?”Also Available in