Gantt Chart+

Overview

Gantt Chart+ displays event frames on a timeline so operators can compare duration, overlap, and sequence.

When to use it

Use this symbol when you need to:

• Review process events, batches, shifts, or downtime on a shared timeline.
• Compare event duration and overlap across groups.

Before you begin

• Prepare an event-frame search with valid start and end times.
• Choose grouping fields that keep the number of lanes readable.

Add and set up the symbol

1. Select the symbol in the PI Vision symbol gallery.
2. Add the required data sources or asset context to the display.
3. Right-click the symbol and open its configuration pane.
4. Configure the minimum data, range, and display settings for a useful result.
5. Confirm that the symbol shows the expected data.

Use the symbol

Hover over an event for details and select it to open the configured event action or details view.

Configure the symbol

Overview and behavior

The Gantt Chart+ displays event frames on a timeline, with each row representing a group or individual event and each bar spanning the event's start-to-end duration. It is purpose-built for visualizing process events, shift patterns, and downtime in PI Vision.

Configure trend

Use the Configuration pane to customize the Gantt Chart+ symbol. The sections below cover title, style, legend, tooltips, bar appearance, data labels, and interactivity.

1. Right-click the symbol and select Configure Gantt Chart to open the configuration pane.
2. Common section - configures the chart headings:

• Title: Toggles the chart title on or off.
• Text: Sets the text displayed as the chart title.

1. Style section - controls the overall visual appearance of the chart:

• Foreground: Sets the text color for the chart.
• Background: Sets the background fill color of the chart.
• Font Size: Sets the base font size for all chart text.

1. Legend section - configures the chart legend. The legend shows all event frame groups with their assigned colors and series values. The displayed values reflect the configured Series property (see Configure Measures below).

• Enabled: Toggles the legend on or off.
• Position: Sets the legend position: Top, Left, Bottom, or Right.
• Alignment: Controls the text alignment of legend entries.
• Font Size: Sets the font size of legend text.

1. Tooltip section - configures the hover tooltip shown when a user points at an event frame bar.

• Enabled: Toggles the hover tooltip on or off.
• Properties: Check or uncheck individual event frame properties to control what appears in the tooltip.

1. Bars section - controls the visual style of the event frame bars:

• Color Mode: Individual assigns a single color to all bars. Series derives each bar's color from the configured Series grouping (see Configure Measures - Series).
• Bar Style: Choose the visual style of the bars:
• Modern

• Classic

• Card

• Radius / Height: Additional settings controlling bar corner radius and row height.

1. Data Labels section - controls the labels displayed inside or on the event frame bars:

• Show: Toggles data labels on or off.
• Value Selection: Select any event frame property to display as a label, then click the + button to add it. Multiple properties can be shown simultaneously (e.g., Name, Attribute, Severity).

• Background: Sets the background fill color of the data label.
• Truncate Overflowing Text: When enabled, labels that do not fit within a bar are hidden rather than overflowing.
• Horizontal / Vertical Alignment: Controls the positioning of the data label within the bar.
• Title: When enabled, displays the property name alongside its value in the label.

• Font Size: Sets the font size of the label text.

1. Interactivity section - controls how the chart responds to user interactions:

• Enable Zoom X: Allows zooming along the time axis.
• Show Zoom Bar X: Toggles a zoom navigation bar at the bottom of the chart.

• Axis X Mode: Choose what happens when the user clicks and drags the chart. Choose between “Pan” and “Range Selection”.
• Pan: will pan the chart left/right
• Range Selection: Will draw a rectangle over the gantt chart, showing the duration of the selected area.
• Row Sizing Mode: Controls how rows are sized. Fit scales all rows to fill the available height. Fixed sets a minimum row height - if rows exceed the chart height, a vertical scrollbar appears.

• Event Select: Defines the action taken when a user clicks an event frame bar:
• Event Details: Takes the user to the event details page
• Open Dialog: Shows the event details dialog window.
• Apply Time Range: Wil apply the event frames time to the current display
• Editing: When enabled, users can edit event frame properties directly from the chart.

Configure measures

Arguments

Arguments define the Y axis rows. When Show Child Events is enabled, each row represents an individual event frame, and rows can be expanded or collapsed to show the hierarchy.

When Show Child Events is disabled, events are grouped by any basic event property or by a configured attribute.

Asset: Groups all event frames by their associated asset - each asset gets its own row.

Other properties (e.g., Severity): Creates one row per unique value of the chosen property.

You can also group rows by a custom event frame attribute.

Series

The Series setting groups event frames by a shared property and assigns each group a color. Setting Series to Asset, for example, gives all event frames from the same asset the same color.

• Property: The event frame property used to define series groups.
• Overlap: When enabled, bars from different series overlap each other instead of stacking side by side.

Overlap On Overlap Off

• Color Mode: Controls bar coloring. Distinct Values assigns a unique color to each series group. multi-state derives bar color from configured multi-state limits.

For multi-state color mode, you must (1) select an attribute for the Series property and (2) enable multi-state for that attribute first.

• Custom Colors: When Color Mode is set to Distinct Values, you can assign specific colors to each series value here.

Multi-state event frames

The Gantt Chart+ can color event frame bars based on the multi-state limits of one of their attributes, providing at-a-glance status coloring across the timeline.

To configure multi-state coloring, follow these steps:

1. Drag the actual event frame attribute onto the display, so it shows up in the attributes list.
2. Right-click the Gantt Chart and select Add multi-state. Configure the limit thresholds and colors.
3. In the configuration pane, navigate to Measures → Series and select the attribute created in step 1.
4. Set Color Mode to multi-state.

Event frame details

When the Event Select property in the Interactivity section is set to Open Dialog, clicking an event frame bar opens a details dialog. The dialog contains three tabs:

• Details

Displays the full information for the selected event frame. Users can also acknowledge or edit the event frame from this view.

• Comments

Shows all comments attached to the event frame. Users can read existing comments and add new ones.

• Attributes

Lists all attributes of the event frame and their current values.

Click the chart icon next to any attribute to view a trend of its value over the event frame's duration.

Troubleshooting and limitations

• Check: If an event is missing, check the search, time range, grouping, and event start and end values.
• Check: Dense or long event searches can make the timeline difficult to read.