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

# Heatmap

> A heatmap of point data, driven from firmware.

<Info>
  **Category:** Display · **Reads data:** yes (points) · **Sends commands:** no
</Info>

## Mental model

A **Heatmap is a thermal camera view.** It renders a grid of points as a color
gradient — dense/hot vs. sparse/cool — for pressure maps, coverage, or intensity.

## When to use it

* Pressure or intensity across a surface (e.g. a foot pressure sensor)
* Density / coverage visualization

## Settings

### Style

* **Color scheme** · **custom colors**
* **Min / Max value** — scale
* **Point shape** · **size**
* **Contour color / width**

## Example — push points from firmware

The Arduino library has a dedicated helper:

```cpp theme={null}
std::vector<HeatMapPoint> pts = { {0,0,10}, {1,0,42}, {2,1,88} };  // x, y, value
device.updateHeatMap(targetId, "pressureMap", pts);
```

## Script API example

The same interactions from a [dashboard script](/script/overview):

```js theme={null}
widget.on('pressureMap', 'update', () => {
  widget.setText('mapStatus', 'Updated ' + new Date().toLocaleTimeString());
});
```

<Card title="Arduino API" icon="microchip" href="/firmware/arduino/api-reference#updating-widgets">
  updateHeatMap and other widget helpers.
</Card>