> For the complete documentation index, see [llms.txt](https://docs.rasgoml.com/rasgo-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rasgoml.com/rasgo-docs/rasgo-0.1/all-transforms/heatmap.md).

# Heatmap

Generate an x / y heatmap, which uses the number of rows in each x/y bin as a density overlay to a 2-d histogram

## Parameters

| Name         | Type         | Description                                                                                                            | Is Optional |
| ------------ | ------------ | ---------------------------------------------------------------------------------------------------------------------- | ----------- |
| x\_axis      | column       | numeric column to use as the x axis                                                                                    |             |
| y\_axis      | column       | numeric column to use as the y axis                                                                                    |             |
| filters      | filter\_list | Filter logic on one or more columns. Can choose between a simple comparison filter or advanced filter using free text. | True        |
| num\_buckets | value        | max number of buckets to create; defaults to 100                                                                       | True        |

## Example

```python
ds = rasgo.get.dataset(id)

ds2 = ds.heatmap(x_axis='TEMPERATURE',
  y_axis='PRECIPITATION')
ds2.preview()
```

## Source Code

{% embed url="<https://github.com/rasgointelligence/RasgoTransforms/blob/main/rasgotransforms/rasgotransforms/transforms/heatmap/heatmap.sql>" %}