Skip to content
Software AthleteSoftware Athlete
How to Annotate Process Data in PI Vision using Event Frames

PI Vision how-to

How to Annotate Process Data in PI Vision using Event Frames

Use Combo Chart+ to select a time range on a PI Vision trend and save the operational context as an Event Frame that teams can search, review, and comment on later.

Updated August 28, 2026 · Originally published August 3, 2024 · Reviewed by Software Athlete PI Vision engineering

Before you begin

Prerequisites

  • Combo Chart+ from Vision Library+ must be installed and available in the PI Vision symbol gallery.
  • You need edit access to the PI Vision display and a process data source such as a PI Point or AF attribute.
  • An approved Event Frame template and target AF asset must be available. If you need a new template, create it in PI System Explorer first.
  • Your PI System permissions must allow the intended Event Frame creation and comment or edit actions. Ask the PI administrator to confirm access before rollout.

Combo Chart+ stores an annotation as an Event Frame rather than drawing temporary text on the display. The selected chart interval supplies the start and end times; the creation form records the event name, asset, severity, description, and other configured context.

Combo Chart+ showing Event Frame annotations across a PI Vision process trend
The colored ranges align Event Frames with the process data that they describe.

1. Prepare the Event Frame template

In PI System Explorer, open Library → Event Frame Templates. Create a template for this annotation workflow, or confirm which existing template users should select.

Add attributes only when the annotation needs structured fields such as cause, category, work order, or responsible team. Confirm that the template is available in the AF database used by the PI Vision display.

2. Add and configure Combo Chart+

Open the PI Vision display in edit mode. Select Combo Chart+ in the symbol gallery, add the required PI Point or AF attribute, then right-click the symbol and open its configuration pane.

Confirm that the chart shows the expected process data and time range before adding Event Frames. This separates a data-source or retrieval problem from an event-search problem.

3. Display existing Event Frames

  1. In the configuration pane, open Events → Display and switch Enabled on.
  2. Right-click the chart and choose Events Search Criteria….
  3. Configure the Event Frame search for the correct AF database, template, asset context, and display time range, then select Apply.
  4. Use the Display settings to choose whether the chart shows event regions, start/end lines, and labels.
Expected result: matching Event Frames appear as colored time ranges. Selecting an event label opens its details, attributes, and comments.
Combo Chart+ configured to display Event Frames on a PI Vision trend
Verify the event search and visual style before enabling operators to create annotations.

4. Enable Event Frame creation

Open Events → Creation and switch Enabled on. Select the approved Event Frame template and specify the AF asset for newly created events.

Make sure the chart toolbar is visible. After creation is configured, the toolbar includes the Create Event Frame action.

5. Select the interval and save the annotation

  1. Set the chart interaction mode to Select.
  2. Drag across the trend to mark the start and end time of the process condition.
  3. Select Create Event Frame in the chart toolbar.
  4. Review the name, asset, start and end times, severity, and description in the creation window.
  5. Select Save. Add a comment later if the investigation produces more context.
Selecting a time range for a new Event Frame in PI Vision Combo Chart+
The selected range becomes the proposed Event Frame boundary.
Event Frame creation form for a PI Vision process annotation
Review the asset, timestamps, severity, name, and description before saving.

Verify the saved annotation

  • Keep the chart on a time range that includes the new Event Frame and confirm that its region or boundary markers appear.
  • Select the event label and verify the name, asset, start/end times, severity, description, attributes, and comments.
  • Reload the display and repeat the same Event Frame search to confirm the annotation is stored and discoverable.
  • When required by your operating procedure, confirm the Event Frame in PI System Explorer or a downstream Event Frame view.

Troubleshooting

No Event Frames appear: confirm that Events → Display is enabled, the display time overlaps the events, and the Events Search Criteria target the correct database, template, and asset context.
No creation action appears: confirm that Events → Creation is enabled, a template and asset are selected, and the chart toolbar is shown.
The selection zooms instead of creating a range: switch the toolbar interaction mode from Zoom or Pan to Select.
Save fails or fields are read-only: verify the template, target asset, and the user's PI AF permissions with the PI administrator. Do not broaden access beyond the workflow's approved users.
Events Table+ used to review Event Frame annotations after creation
For a broader follow-up workflow, surface saved annotations in an Event Frame table or management display.

To review and update annotations across a wider event population, continue with advanced Event Frame management in PI Vision.

Common implementation questions

Event Frame annotation FAQ

Where is a Combo Chart+ annotation stored?

It is created as an Event Frame in the configured AF database, using the selected template and asset.

Can users add comments after the Event Frame is created?

Yes, when their permissions allow it. Open the event details from its chart label and use the Comments view.

Which interaction mode should operators use?

Use Select to draw the Event Frame time range. Zoom changes the visible range, while Pan moves through an already zoomed chart.

Leave a comment

Your email address will not be published..

Cart 0

Your cart is currently empty.

Start Shopping