# Heatmap

The **Heatmap** shows how data points are distributed across two dimensions. The plot area is divided into *buckets* (grid cells), and each bucket is colored based on how many points fall into it. This makes clusters, gaps, and density patterns in the data easy to spot.

<div data-full-width="false"><figure><img src="/files/jktwzOFjCySK2eQwukLN" alt="Heatmap" width="489"><figcaption></figcaption></figure></div>

📊 **How to read it** (with default colors):

* **Blue** = fewer points in a bucket
* **Red** = more points in a bucket
* Buckets between these extremes are shaded on a blue-to-red gradient.

**Settings**

Accessible via the ⚙️ (settings wheel) in the top-right corner of the plot:

* **X and Y axes** – Select which variables define the horizontal and vertical dimensions.
* **Plot limits** – The limits on the x or y axes, or *auto* to take the min/max from the data
* **Resample signals** – Relevant when your signals have different timestamps. See [Resampling](/docs/marple-insight/user-manuals/visualisation/resampling.md) for more details.
* **Color range** – Change the lower and upper colors (default is blue–red) or the bucket count fraction. Buckets with fewer points than a specified fraction of the most populated bucket are shown in the lower color. Buckets with more points are shaded on a gradient up to the upper color.
* **Opacity** – Opacity of the plot
* &#x20;**Filters** – Filter datapoints based on conditions&#x20;

## Discover the Heatmap in 1 minute

{% embed url="<https://www.youtube.com/watch?index=22&list=PLtVuqpI9QpJAFtUEvuS23Z47XGHrRc_P9&v=2l1ZurtpCOg>" %}

Want to discover more Marple features in 1 minute? Check out other [1 Minute Marple videos](/docs/other-resources/1-minute-marple-videos.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.marpledata.com/docs/marple-insight/user-manuals/visualisation/plot-types/heatmap.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
