Other settings
- Last UpdatedMay 30, 2025
- 4 minute read
- PI System
- PI Event Frames Generator 5.1.7
- Interfaces
-
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.
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).
-