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

PI Event Frames Generator

Other settings

  • Last UpdatedMay 30, 2025
  • 4 minute read
  • Referenced elements

    Specifies the PI AF elements (equipment /assets /units) associated with the event. If there are multiple elements, the first element in the list must be the primary referenced element for the event frame.

  • Enable

    Activate/deactivate the PI EFGen configuration node, for testing and troubleshooting.

  • Log debug messages

    Activate/deactivate debugging output.

  • Merge consecutive event frames

    Merges consecutive event frames if they have the same name, occur within the cache time period configured, and belong to the same PI EFGen configuration. If PIBaGen compatibility mode is enabled, event frames must also have the same product and recipe event frame attributes at the top level. If the name is identical and product and recipe event frame attributes are omitted, the events are merged. Merge Consecutive is enabled by default for Procedure (top) level event frame configurations if PIBaGen compatibility mode is enabled.

    Merging is only applicable for Procedure level and Unit Procedure (2nd) level configurations. If merging is enabled for both Procedure and Unit Procedure level configurations, Unit Procedure event frames will be merged under their separate parent Procedure event frames first. The Procedure event frames will subsequently be merged. The following figure demonstrates this merge behavior.

    Merge consecutive event frames

    When event frames are merged, the start time is taken from the first event and the end time is taken from the second event. Event frame attributes are assigned the values from the second source event frame.

  • Recovery Time

    Specifies the period for which events are to be recovered. At startup, the interface checks archived values for active points for the specified period and generates or corrects event frames accordingly. If no recovery time is specified or recovery time is less than cache time, the interface recovers events for the cache time that is configured. Events that start before the recovery period and end after it are not recovered.

  • Evaluation Delay

    Specifies the time, expressed in seconds, that the interface waits before evaluating PI point values to populate the event frame name and event frame attributes. This does not affect event start or end time.

    The time that the Batch Active tag becomes Active is the "Batch Start Time". The time that the Batch Active tag becomes Inactive is the "Batch End Time". The "Evaluation Delay Time" is the "Batch Start Time" plus the Evaluation Delay.

    By default, values are read at the event start time (delay is 0). To read values at the end of the event, specify -1. If the event ends before the evaluation delay elapses, values are read at the event’s end time.

    Note: We do not recommend setting an Evaluation Delay if the Name new Event Frames using setting in the Converter tab is set to Active Point value. This can cause unexpected results when naming Event Frames or introduce incorrect start times for Procedure level Event Frames.

  • Alternative Evaluation Delay

    You have the option of choosing to use an Alternative Evaluation Delay. This option ensures that you will get a value "AT or BEFORE" the Batch End Time, as opposed to the default evaluation delay, which gives you a value at the Batch Start Time plus the evaluation delay that you set as part of each configuration.

    When a Batch Active tag becomes active, a delay of "Evaluation delay" seconds is allowed to elapse before getting a value for the Batch ID.

    • If the "Batch End Time" is greater than or equal to the "Evaluation Delay Time": after a Batch becomes active the name is retrieved at the time of the "Evaluation Delay Time". The value is retrieved "AT or BEFORE" this time.

    • If the "Batch End Time" is less than the "Evaluation Delay Time": after a Batch becomes active the name is retrieved at the time of the "Batch End Time". The value retrieved "AT or BEFORE" this time.

    • If the Evaluation Delay time is set to -1: after a Batch becomes active the name is retrieved at the time of the "Batch End Time". The value is retrieved "AT or BEFORE" this time.

      The following table provides a description of the values returned for each of the evaluation delay settings:

      Setting

      Description

      AtOrBefore

      Return a recorded value at the passed time; or if no value exists at that time, then the previous recorded value is returned.

      AtOrAfter

      Return a recorded value at the passed time; or if no value exists at that time, the next recorded value is returned.

      Interpolated

      Return an interpolated value for this time. Discrete points (step attribute = 1) will simply carry the previous value forward.

      Auto

      For a continuous point (step attribute = 0) treat as Interpolated. For a discrete point (step attribute = 1) treat as AtOrBefore.

      Before

      Return the first recorded value before the passed time.

      After

      Return the first recorded value after the passed time.

      Compressed

      Return a recorded value at the passed time or return an error if none exists. (For ArcValue).

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