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.
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.
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
- In the configuration pane, open Events → Display and switch Enabled on.
- Right-click the chart and choose Events Search Criteria….
- Configure the Event Frame search for the correct AF database, template, asset context, and display time range, then select Apply.
- Use the Display settings to choose whether the chart shows event regions, start/end lines, and labels.
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
- Set the chart interaction mode to Select.
- Drag across the trend to mark the start and end time of the process condition.
- Select Create Event Frame in the chart toolbar.
- Review the name, asset, start and end times, severity, and description in the creation window.
- Select Save. Add a comment later if the investigation produces more context.
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
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.
