Dimensions and Breakdown

Main Use

Dimensions and Attributes are used to drill in and “breakdown” additional data attributes and dimensional data. These tools allow the user to drill in on specific dimensions and attributes.


A dimension is an event’s attribute which is declared as dimension. The declaration could be automatic or manual by the user. The automatic declaration is based on the series of rules such as:
• The type of the data in the attribute is String or Number, and
• The count of unique values of this attribute is between 2 and 2000.

If both conditions are met, the attribute is considered a dimension. This happens during the post-load analysis.

User could change the dimension property of the attribute in Dimensions panel available via the application menu.

Dimension values and their count

The set of unique values of a given dimension is called “dimension values”. The number of timelines where this attribute has this value is called “value count”.

Dimension Filter

User can filter timelines in the current set by the dimension value. The dimension filter panel comes up when user clicks on the button next to the search or duplicating item in the main menu.

This document describes how and where the dimensions are used in TimelinePI application. It includes:
• Filtering by dimension value
• Timeline metrics breakdown by dimension
• Time interval between events – breakdown by dimensions


First column has all activities, ordered by the number, just like in Activity Selector. Second column shows all dimension attributes for the selected activities. The last column shows the unique dimension values for the selected attribute sorted alphabetically.

This panel acts as any other filter, reducing the number of the timelines in the current set.
If the same activity happens several time in a timeline, any of the should have the selected value in order to pass the filter.

Breakdown of timeline metrics

When user clicks on the metric box, the filter comes, it is does now. In addition to it, the user is displayed the Trellis chart which breaks the metric down by the selected dimension.

The chart displays the selected metric for X top dimensions – the dimensions with the highest count of the timelines in it. I would also like to display the count of the timelines next to each dimension value, in the title, like it’s shown for the first couple.

Note: All small charts should have the same X and Y scales.

Setting the filter

Once user clicks on a small chart, the main histogram displays the timelines for the selected dimension value. The histogram title “All timelines” changes to display the actual value of the selected dimension, like Atlanta, Baltimore, etc.

It would be nice to have a simple animation – when user clicks on a small chart, it “flies” toward the main histogram and becomes it.
Removing the filter

If user clicks on the histogram or on the same small chart again – the chart flies back and the histogram displays the unfiltered timelines.
Changing the filter

If user clicks on a small chart for, for example, Atlanta, and then clicks on Baltimore, the Atlanta flies back and the Baltimore flies to the histogram and becomes selected.
Once click clicks “Apply filter”, we create 2 filters: one for the duration (if user changed the sliders) and one for dimension (if user set the filter).
Choosing Dimension

When the panel shows up, the breakdown dimension is not set. Instead, the text in its place says “Chose breakdown dimension”. The area for Trellis charts is empty and text explains why:

Once user clicks on the link, the chose dimension panel comes up, very similar to the filter panel.

Example Video Demonstration



User can filter by the events’s respective attributes:
The user selects the Event, the corresponding Attributes, and then the Values to filter by.


User will select the event and the corresponding attribute to further drill in on the various values.

The breakdown will then show all of the different attributes and the amount of times and percentages they were used in the data set. Filters can then be applied to specific Values.

If the user wants to compare this to a different set that can be done.