Event Filter+ for AVEVA PI Vision

PI Vision Event Frame filter that narrows event tables, charts and KPIs

Let operators slice an event dashboard without editing it. Event Filter+ lists the values found in your Event Frames, such as reason code, asset or severity, and one selection narrows Events Table+, the event analytics symbols and the other compatible Vision Library+ symbols on the same display.

Event Filter+ in PI Vision listing downtime root causes with Maintenance selected, beside an Event Analytics KPI+ card and an events table narrowed to 5 of 46 events, next to the configuration pane with the argument Root Cause
Event Filter+ with one root cause selected: the KPI card and the event table narrow to 5 of 46 events. Demo data. Select the image to enlarge.

PI Vision Event Frame filter for tables, charts and KPIs

Build one event dashboard for every reason, asset and product, and let operators narrow it to the events they care about.

One selection narrows the other Event Frame symbols

Select a value in Event Filter+ and the compatible event symbols on the display show only the matching Event Frames.

  • Works with Events Table+, Event Analytics Chart+, KPI+, Pie+ and Pivot+, Event Comparison Chart+, Gantt Chart+ and Event Frame Form+.
  • Filtered symbols show a filter indicator with a count such as "10 of 46 events", so a filtered view is never mistaken for the full result.
  • Clear the selection to show every event again; other filters on the display stay active.
  • Each symbol keeps its own Event Frame search; the filter narrows the events it has already loaded.
A PI Vision display with Event Filter+ on the left with Maintenance and Operator error checked, two Event Analytics KPI+ cards for those reasons and an events table, with the indicator 10 of 46 events
Two reasons selected: the KPI cards and the event table narrow to 10 of 46 events. Demo data. Select the image to enlarge.

Filter choices from Event Frame attributes and properties

Build the list from the field your teams already think in. Every distinct value in the loaded events becomes a choice, so a new reason code appears without editing the display.

  • Event Frame attributes such as reason code, reported by or production line.
  • Event properties such as asset, template, severity, name or start time.
  • Two arguments combined into one choice, such as "Maintenance - Operator".
  • A search field narrows a long list without changing the filter definition.
Event Filter+ with elec typed into its search field, leaving three root causes, one of them selected, and the event table narrowed to 1 of 46 events, next to the Value list showing event properties such as StartTime, Asset and Severity and the attributes Root Cause and Reported By
The search field narrows the list; the Value list offers event properties and Event Frame attributes. Demo data. Select the image to enlarge.

Event lists, trees and date groups

Present the choices in the form that fits the question: a flat list, a hierarchy or periods of a date.

Single or multiple selection in a list or tree

Let operators focus on one cause, or compare several causes side by side.

  • Single selection that can be kept from ever being empty, or multiple selection with All to select or clear every value.
  • Two or more arguments, such as root cause and reported by, shown as an expandable tree.
  • Selecting a branch of the tree filters every event below it.
  • Radio buttons or checkboxes next to each item make the selection obvious.
Event Filter+ as a tree with root causes as branches and Automatic or Operator below, with the Maintenance branch and the Operator item under Operator error checked, beside two KPI cards and the event table with 7 of 46 events, next to the Layout settings with View Tree and the Selection settings with Mode Multiple
Tree view from two arguments: the whole Maintenance branch and one item under Operator error give 7 of 46 events. Demo data. Select the image to enlarge.

Group events by date and time

Turn timestamps into a few meaningful choices instead of one entry per time.

  • Date and time arguments such as the start time grouped by year, quarter, month, week, day of week or hour.
  • Day, month and year by default, or any of the other group intervals in the settings.
  • Events without a value are listed as "No Data", so they can be filtered too.
  • Combine a date group with other filters, for example one weekday and one root cause.
Event Filter+ listing the event start time grouped by day of week with Wednesday checked, beside the KPI cards and event table narrowed to 14 of 46 events, next to the Arguments settings with Value StartTime and Group Interval Day of Week
Start times grouped by day of week; Wednesday selected leaves 14 of 46 events. Demo data. Select the image to enlarge.

Combine PI Vision event filters and link them to assets

Layer several filters on one display, connect asset selections to the event symbols, and fit the filter into the dashboard.

Several filters, cascades and linked channels

Combine filters such as weekday and reason code, and connect selections to other symbols through named channels.

  • Several Event Filter+ symbols on one display: events must match every active filter.
  • Turn Ignore Master off and a filter lists only the values the other filters leave, with its own count.
  • Output Mode Master, Linked or Both, and linked inputs from other symbols.
  • A linked channel can join assets and events, for example passing the assets selected in Asset Filter+ to the event symbols.
Two Event Filter+ symbols, start day with Wednesday selected and root cause with Maintenance selected, narrowing a KPI card and the event table to 2 of 46 events; the root cause filter lists only the eight reasons left by the weekday filter and shows its own count of 14 of 46 events, next to the Filtering settings with Filter Indicator Full, Ignore Master Off and Output Mode Master
Two filters combined: Wednesday and Maintenance leave 2 of 46 events; the root cause list shows only the reasons that occur on Wednesdays. Demo data. Select the image to enlarge.

Collapsible filter panel, header and themes

Keep the filter as small as the display needs and match it to the rest of the dashboard.

  • A static list, or a collapsible header that opens on click, closes on select and can start expanded.
  • Header with your own title or the current selection.
  • Theme presets with surface and container styles, or a custom theme with background and text colours, font, font size and padding.
  • Checkboxes and radio buttons follow the selected theme.
Event Filter+ in the Light theme as a collapsible list, opened from a header that shows the selection Maintenance, beside another filter and the event table, next to the Layout settings with Type Collapsible, Collapse on Select On and Start Expanded Off and the Header settings with Text Selection
Collapsible filter in the Light theme, with the selection in the header. Demo data. Select the image to enlarge.

PI Vision Event Frame filter examples

Four common ways teams use Event Filter+ on their event dashboards.

Downtime by reason

Data
Downtime Event Frames with a reason code attribute
Settings
Argument Root Cause, multiple selection, Events Table+ and Event Analytics KPI+ beside it
Shows
The downtime events and durations of the selected reasons, with "x of y events" on every narrowed symbol

Batches by product

Data
Batch Event Frames with a product attribute
Settings
Single selection that is never empty, Event Comparison Chart+ beside it
Shows
The batches of one product compared, without editing the chart’s search

Events by weekday or month

Data
The start time of any Event Frame
Settings
Argument Start Time with Group Interval Day of Week, Event Analytics KPI+ beside it
Shows
Event counts and durations recalculated for the selected days

Events of the selected assets

Data
An AF search and an Event Frame search on the same assets
Settings
Asset Filter+ with a linked output AssetPath, mapped to the target property Asset
Shows
The events of exactly the assets selected in the asset filter

Event Filter+ FAQ

Questions we are asked most often. Read the Event Filter+ documentation or ask a technical question.

When do we use Event Filter+ instead of Asset Filter+, and which symbols follow it?

Use Event Filter+ to narrow Event Frames by their attributes or properties, such as reason code, product, asset or start time. Its selection narrows Events Table+, Event Analytics Chart+, KPI+, Pie+ and Pivot+, Event Comparison Chart+, Gantt Chart+, Event Frame Form+ and other Event Filter+ symbols on the same display. Use Asset Filter+ to narrow asset symbols such as Asset Comparison Table+ by AF attributes. Asset and event filters are kept apart; a linked channel connects them when an asset selection should narrow the events. Native PI Vision symbols are not filtered.

Why does a symbol not change when we select a value?

The target symbol must take part in Event Frame filtering and load the events the filter refers to. Filtering applies to the events a symbol has already loaded; it does not run a new search, so each symbol’s own search, time range and result limit must include every event the filter can select. Also check that the symbol does not have Ignore Master switched on.

Why is a value missing from the filter list?

The list is built from the Event Frames Event Filter+ loads with its own search criteria. A value that does not occur on any loaded event, for example a reason code that was not used in the time range, does not appear. Give Event Filter+ the same search criteria as the symbols it filters. With Ignore Master off, the list also leaves out values that the other filters on the display have already excluded.

Can we combine several filters on one display?

Yes. Place several Event Filter+ symbols, for example one for the weekday and one for the reason code; the other symbols then show only the events that match every active filter. Turn Ignore Master off on a filter to have it list only the values the other filters leave.

What do we need to run it?

PI Vision 2021 or later with PI Web API, and PI AF Server 2018 SP2 or later with Event Frames. Event Filter+ runs in PI Vision and uses each user’s existing PI permissions.

How do we get Event Filter+?

Event Filter+ is part of Vision Library+, together with the other Vision Library+ symbols. Request a trial to test it in your own PI Vision environment.

Try Event Filter+ in your PI Vision

Event Filter+ is included in Vision Library+, the PI Vision custom symbol library from Software Athlete. Test it on your own displays and data.