---
title: "Pie widget"
slug: "pie-widget"
updated: 2026-03-20T14:56:16Z
published: 2026-03-20T14:56:16Z
canonical: "docs.calculus.group/pie-widget"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.calculus.group/llms.txt
> Use this file to discover all available pages before exploring further.

# Pie widget

A pie is a chart that shows the relative contribution of different parts to a total. Each segment represent the contribution of a part as a percentage of the whole.

![Pie chart showing electricity consumption distribution among various categories and components.](https://cdn.document360.io/94d0a983-5058-4b02-8d06-1228a999a7a1/Images/Documentation/chart_pie.png?sv=2026-02-06&spr=https&st=2026-11-11T14%3A02%3A51Z&se=2026-11-11T15%3A02%3A51Z&sr=c&sp=r&sig=LS1clnJIY45oBiFgVcU4zut3Xu0FQCuPi%2FFfmUcmjKg%3D)

## Widget control elements

- **Context menu** Lets you select a date range, or download the data in various formats.
- **Hovering over a segment** Shows a coaster detailing the measurement for that sensor.
- **Clicking on a segment** Highlights the segment.

## Widget configuration panel

In the widget selection panel, click on **Pie**. A new panel will appear where you can configure the widget.

### Pie data

![Dashboard interface displaying sensor options for engine monitoring and data selection.](https://cdn.document360.io/94d0a983-5058-4b02-8d06-1228a999a7a1/Images/Documentation/2025-08-13 16-24-28.png?sv=2026-02-06&spr=https&st=2026-11-11T14%3A02%3A51Z&se=2026-11-11T15%3A02%3A51Z&sr=c&sp=r&sig=LS1clnJIY45oBiFgVcU4zut3Xu0FQCuPi%2FFfmUcmjKg%3D)

#### Select sensors

The first step is to add at least one measurement to the chart. Press the **Add Sensors** button, a panel will appear where you can select the sensors you want to include in the chart. Click **Save**.

![Dashboard settings for pie chart data and widget configuration options displayed on screen.](https://cdn.document360.io/94d0a983-5058-4b02-8d06-1228a999a7a1/Images/Documentation/2025-08-13 16-21-53.png?sv=2026-02-06&spr=https&st=2026-11-11T14%3A02%3A51Z&se=2026-11-11T15%3A02%3A51Z&sr=c&sp=r&sig=LS1clnJIY45oBiFgVcU4zut3Xu0FQCuPi%2FFfmUcmjKg%3D)

Fill in the fields below:

- **Decimals** Up to how many decimal places the value should be displayed.
- **Unit of measurement** The unit for the measured value.
- **Show string data** Enable this if the measurement data is a string.

Click **Next** to go to Pie settings.

### Pie settings

![Dashboard settings for a pie chart widget with various configuration options displayed.](https://cdn.document360.io/94d0a983-5058-4b02-8d06-1228a999a7a1/Images/Documentation/2025-08-13 16-22-05.png?sv=2026-02-06&spr=https&st=2026-11-11T14%3A02%3A51Z&se=2026-11-11T15%3A02%3A51Z&sr=c&sp=r&sig=LS1clnJIY45oBiFgVcU4zut3Xu0FQCuPi%2FFfmUcmjKg%3D)

Fill in the fields below:

- **Title** A title or description for the widget.
- **Widget width** The width of the widget, as a factor of the total screen width.
- **Height** The height of the widget in pixels.
- **Order** The position on the dashboard.
- **Refresh in seconds** Leave this at the default.

### Color Settings

![Dashboard settings for pie chart configuration and color mapping options displayed.](https://cdn.document360.io/94d0a983-5058-4b02-8d06-1228a999a7a1/Images/Documentation/2025-08-13 16-22-28.png?sv=2026-02-06&spr=https&st=2026-11-11T14%3A02%3A51Z&se=2026-11-11T15%3A02%3A51Z&sr=c&sp=r&sig=LS1clnJIY45oBiFgVcU4zut3Xu0FQCuPi%2FFfmUcmjKg%3D)

Fill in the fields below:

- **Color scheme** Choose a color palette for the chart.

Click **Save** to add the widget to the dashboard.