# Heatmap

To learn more about heatmap charts and how to create one, please view this [video](https://youtu.be/pBA8COL7BUQ?si=tXBXlqs39uaOFQna).

The Heatmap displays information in a two-dimensional grid of cells. Each cell represents a grouping of data.

| Features                                                           | Quantity | Notes               |
| ------------------------------------------------------------------ | -------- | ------------------- |
| Required [Dimensions](/immerse/measures-and-dimensions#dimensions) | 2        | X Axis and Y Axis.  |
| Required [Measures](/immerse/measures-and-dimensions#measures)     | 1        | Measure cell color. |

Cell color indicates the relative value of the cells, from one end of the spectrum to the other.

Heatmaps are ideal for spotting outliers, which show up vividly on the color spectrum. They work best when the number of groupings is not too large, since large numbers of groupings cause the heatmap to exceed the viewport, making comparison harder (for such scenarios, consider using a [Scatter Plot](/immerse/immerse-chart-types/scatter-plot)).

## Heatmap Example

Create a new Heatmap. Choose a **Data Source**. This example uses NBA Play-by-play Stats from [nbastuffer.com](https://www.nbastuffer.com/access-exportable-nba-stats/).

Set the **X Axis** dimension to *converted\_x* with **Binning On** and **Y Axis** dimension set to *converted\_y* with **Binning On**. The *converted* values represent the coordinate location on the basketball court, versus the *original* values, which represent the distance from the goal (as though all shots were half-court).

![](https://files.buildwithfern.com/heavyai.docs.buildwithfern.com/heavyai/1234ec3fbe3bd2c8a7aaec230d8aa3b7773058113dc5ec6578984a2638d907b0/docs/assets/3_heatmap-1.png)

You can turn off **NULL DIMENSIONS** to get a chart that more closely resembles a basketball court.

![](https://files.buildwithfern.com/heavyai.docs.buildwithfern.com/heavyai/1319402378b437606a247c17ed8288ce623d369dfdb49fa70e4b0d70da4ae836/docs/assets/3_heatmap-2.png)

If you change the **COLOR PALETTE** to the red-to-green spectrum and reverse the direction, you can discern the highest average scoring locations (in green) from the lowest (in red) using commonly understood visual cues.

![](https://files.buildwithfern.com/heavyai.docs.buildwithfern.com/heavyai/2e552659a2da583f9fc0a44fc06f967ffe35338d06682c677ee5c808fd6c3720/docs/assets/3_heatmap-3.png)

You can edit the chart title and axes labels to give them more meaningful names.

![](https://files.buildwithfern.com/heavyai.docs.buildwithfern.com/heavyai/1b01cb1c4b7182f85e89504cac1b58cc14e063cd38a24499de73b08b6aaf6df6/docs/assets/3_heatmap-4-1-3-3-3-3-3-4-4-5-5-12.png)