Event set cards

Back to: Index of cards

Cards in this section are used to visualize and analyze events in bulk. An event consists of a start and end timestamp, similar to a time range, but can also be enriched with other data to support analysis. To learn more about common events-based workflows, see the Analyze events data page.

The following cards accept an event set and return an event set:

• Time shift event set
• Deduplicate event set

The following cards accept time ranges and return an event set:

• Event set from ranges

The following cards accept a table and return an event set:

• Event set from tabular data

The following cards accept a time series and return an event set:

• Linked event set - this card also accepts an object as an input
• Time series search

The following are available visualizations for events:

• Events plots
• Events timeline

Events plots

Every event set is visualized using an Events plot, which plots events on a time axis at the bottom of the chart. This feature can help to contextualize a time series plot or correlate events with observed phenomenon in the time series.

• Hovering over each event will show the details of that event. You can configure what details to display for each event through the Tooltip settings.
• Events are grouped based on the zoom level of the chart. Hovering over an event group shows a list of events in that group.
• The input data must have a date or timestamp property or column for it to be plottable as multiple events.

Event sets and events plots are backed by transform tables, where each row is treated as a single event. The backing transform table can be accessed through the next actions menu of the event set by selecting Convert > New transform table. You can use the backing transform table to modify or enrich the underlying event data. For example, you may want to compute a color label column for each event. You can then use the column to color code in the Colors settings under Event Options in the Display tab of the Editor panel.

Display options

From the Display tab of any events plot configuration, you can control how events are rendered on the chart, including the color, opacity, tooltip content, and location. Most settings can be applied at the individual event level by selecting an event column to supply the value, allowing for granular customization.

• Time series chart visibility: Quickly toggle the event set onto multiple time series charts to maintain context across visualizations. This is especially useful when comparing different time series over the same set of events. Note that as an events plot is only present on one time series chart, toggling it off of that chart will remove the plot from your analysis. Learn more.
• Colors: Configure how the color for each event is determined.
  • Select color
    • Single: Apply one color to all events in the event set.
    • Variable: Use a property or column of the event set to supply the color for each event (represented by a hexadecimal color string).
  • Cycle through colors by column value: Assign a different color for each value of a chosen property or column; colors are automatically assigned.
• Render in chart: Display events as highlights on the chart, with customizable opacity to control the visual prominence of events.
• Render on X axis: Show an events axis and customizable tooltips for each event on-hover. All tooltips show the event range and duration. The following tooltip options are available:
  • Object view: Display the title and prominent properties of the object, as configured in the Ontology. This option is only supported if the event set is based on an object set or includes an object column.
  • Custom: Select from the event set's columns to define the title and description for the event tooltip. Additional fields can be shown, along with event range and duration.

Events timeline

View an object set of events through time, segmented into categories if desired.

Does not support transform tables and only takes in an object set as input. Consider using Vega plots as an alternative visualization for an events timeline.