Skip to main content
All CollectionsUser Guides
Plugins: Donut chart
Plugins: Donut chart

Aggregate time series data based on a context key

Santiago Pachon Robayo avatar
Written by Santiago Pachon Robayo
Updated over a week ago

In the intricate world of production management, understanding the reasons behind discarded pieces is crucial for optimizing operations.

A donut chart offers a visually engaging and effective way to display such data, including both gross figures and relative contributions by percentage. This chart not only simplifies the presentation of categorical data but also enhances decision-making by grouping time series based on a specific context key found in each data point.

By employing a donut chart, stakeholders can quickly ascertain the main factors leading to waste in the production line, enabling more informed strategies to improve efficiency and reduce costs. Whether assessing the impact of various defects or pinpointing operational inefficiencies, the donut chart serves as a powerful tool for conveying complex information in an accessible and actionable format.

Requirements

1. Understanding the widget

This widget plugin groups time-series data based on a specified context key, creating a donut chart categorized by this key within the selected time range on the dashboard or a custom span.

Note: For optimal performance, the widget is best used on dynamic or multiple-devices dashboards. For an enhanced experience, it's also recommended to use the widget on a desktop rather than a mobile device.

1.1 Data architecture

The following structure is expected for each dot to be grouped by the widget. For more details on a dot's structure, click here.

1.2 Dot Structure

The Dots in the source variable should follow this format:

{
"value": 12,
"timestamp": 1713200780000,
"context": {
"scrap_code": "101"
}
}

The widget employs a 'Category Key' within the context for grouping. In the provided example, the category key is 'scrap_code.' It aggregates the occurrences, computes their percentages, and, if available via global properties, links each key with its corresponding description.

2. Widget settings

  1. Install the plugin from the plugins section on your account.

2. Select the "Donut chart" in the widgets' creation drawer, down in the "plugin" section:

Select a variable using the "ADD VARIABLE" button.

3. Configure these parameters:

  • Category key: Key in the context used for grouping the time series data.

  • Global property (optional): Toggle on if you wish to associate a global property to enrich the context key.

  • Category description key: Label of the global property you are going to describe your context key data.

  • Span: Inherith the span selected in the dashboard or set a custom span for this widget

Did this answer your question?