---
title: "Heatmap widget"
slug: "heatmap-widget"
updated: 2026-03-20T14:56:29Z
published: 2026-03-20T14:56:29Z
canonical: "docs.calculus.group/heatmap-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.

# Heatmap widget

A heat map is a graphical representation of measured values in which they are displayed in a grid. The color of the data depends on the measured value.

![Graph showing total consumption over several days with highlighted data points.](https://cdn.document360.io/94d0a983-5058-4b02-8d06-1228a999a7a1/Images/Documentation/heatmap.png?sv=2026-02-06&spr=https&st=2026-11-11T14%3A02%3A47Z&se=2026-11-11T15%3A02%3A47Z&sr=c&sp=r&sig=3Xf6PyfgSN8qtpy4B1%2BOIszZcXUuIbZUOX0CShLyG%2FQ%3D)

## Widget control elements

- **Context menu** Lets you select a date range, or download the data in various formats.
- **Hovering over a box** Shows a coaster detailing the measurement for that time and date.

## Widget configuration panel

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

### Heat map data

![Dashboard interface displaying heat map data and configuration options for asset tracking.](https://cdn.document360.io/94d0a983-5058-4b02-8d06-1228a999a7a1/Images/Documentation/2025-08-13 17-00-46.png?sv=2026-02-06&spr=https&st=2026-11-11T14%3A02%3A47Z&se=2026-11-11T15%3A02%3A47Z&sr=c&sp=r&sig=3Xf6PyfgSN8qtpy4B1%2BOIszZcXUuIbZUOX0CShLyG%2FQ%3D)

Fill in the fields below:

- **Fake data** Generates a set of simulated data, useful for configuring widgets when the sensor is not yet sending measurements.
- **Computed measurement** If enabled, you can use a formula to determine the value shown.
- **DataSource** Where the data comes from.
- **Sensor** What data you want to display.
- **Aggregation** The aggregation of the incoming data:
  - **MIN:** shows the minimum value.
  - **MAX:** shows the maximum value.
  - **SUM**: calculates the sum of all values.
  - **AVG:** calculates the average value.
  - **COUNT:** counts the number of values.
  - **FIRST:** shows the first value.
  - **LAST:** shows the last value.
  - **DIFF:** calculates the difference between the first and last value.
- **Label** A description displayed when hovering over a value.
- **Decimals** Up to how many decimal places the measured value should be rounded to.
- **Unit of measurement** The unit for the measured value.

Click **Next** to go to Heat map settings.

### Heat map settings

![Settings for a heat map widget including data display options and color settings.](https://cdn.document360.io/94d0a983-5058-4b02-8d06-1228a999a7a1/Images/Documentation/2025-08-13 17-20-36.png?sv=2026-02-06&spr=https&st=2026-11-11T14%3A02%3A47Z&se=2026-11-11T15%3A02%3A47Z&sr=c&sp=r&sig=3Xf6PyfgSN8qtpy4B1%2BOIszZcXUuIbZUOX0CShLyG%2FQ%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.
- **Text color** Click on the drop icon to choose a color for the shown value.
- **Minimum color** Click on the drop icon to choose a color for the lowest value.
- **Maximum color** Click on the drop icon to choose a color for the highest value.
- **Minimum value (optional)** If specified, limits the lowest value to this value.
- **Maximum value (optional)** If specified, limits the highest value to this value.
- **Order** The position on the dashboard.
- **Refresh in seconds** Leave this at the default.
- **Show label: Data** If enabled, the values are displayed in each box.
- **Show label: X-axis** If enabled, the legend for the X-axis will be displayed.
- **Show label: Y-axis** If enabled, the legend for the Y-axis will be displayed.
- **Folow date range** If enabled, data is shown for the time span selected in the dashboard.
- **Always show last 7 days** If enabled, data is shown for the last 7 days.

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