Skip to main content

Event Filters

This guide explains how to create, configure, and apply logical rules to filter and highlight devices based on real-time telemetry conditions.

Written by Ken Panitz

Overview

Event Filters let you monitor your site by isolating and highlighting devices that meet specific telemetry criteria (for example, finding all piezometers reporting water levels above a certain threshold, or tiltmeters exceeding safety angles).

Applied filters run logical queries against sensor data and immediately update the map to show which instruments are in an active alarm or notice state.

To open the Event Filters Panel:

  • Click the Event Filters (filter icon) in the left Work Panel.


Event Filters Layout

The panel displays a list of filters and management tools:

Each filter card shows:

  • Filter Name: The descriptive name of the filter.

  • Toggle Checkbox: Enables or disables the filter on the map.

  • Metadata Details: Displays tags indicating if the filter is "Unsaved", "Shared with team", or generated "From: [View State Name]". It also shows the count of targeted devices and conditions.


Creating and Configuring Filters

1. Create a New Filter

  1. Click the + Create Filter button at the top of the list.

  2. A draft filter (e.g., "New Filter") will be created and automatically selected.

  3. The Selection Inspector will open on the right side of the screen.

2. Configure in the Selection Inspector

In the right-side inspector, you can edit the filter rules:

  • Name: Type a descriptive name for the filter.

  • Target Devices: Select which device types or specific groups this filter applies to.

  • Define Conditions: Add rules based on telemetry channels.

    • Example: Select Pressure channel -> choose operator > -> enter value 150.

    • You can group rules using logical connectors: AND (all conditions must be true) and OR (at least one condition must be true).

  • Save/Delete: Save the filter to the server (choose to keep it Private or check Shared to share it with the project team) or delete it.


Applying Filters to the Map

To run an event filter on your project, use either of two methods:

  • Method A: Left Work Panel

    • Click the Checkbox Toggle on the right side of the filter card in the Event Filters panel.

  • Method B: Scene View Controls (Device State Bar)

    • Click the Filter Funnel Icon (orange button) on the Device State Bar in the 3D scene view to open the Event Filters popover dropdown.

    • Search or check the checkboxes for target filters directly over the map canvas, or click Clear all.

  • When enabled:

    • The map canvas dynamically filters out or dims devices that do not meet the conditions.

    • Devices matching the filter criteria highlight on the map and display filter badges on their labels.

    • The Device State Bar updates the count of active Filtered devices.

  • You can toggle multiple event filters simultaneously to combine queries.

Did this answer your question?