BTA Charts
ChartsIntensity & Density

Heatmap

A matrix grid where each cell is colored by a numeric intensity value. The X-axis and Y-axis represent two categorical dimensions, and color encodes the measure. Supports hierarchical axes, row/column totals, and scrolling for large datasets.

Examples

When to Use

  • Comparing a measure across two categorical dimensions simultaneously
  • Correlation or co-occurrence analysis between two sets of categories
  • Time-of-day vs. day-of-week traffic patterns
  • Product vs. region sales performance matrices

Data Roles

Loading data roles...

Settings

Color & Appearance

Color Scheme

dropdown

Sequential color gradient from low to high cell values.

Default: blues

Heatmap Grid

Cell Padding

number

Gap between cells in pixels.

Default: 2

Show Values

boolean

Overlay numeric value labels on each cell.

Default: true

Min Cell Width

number

Minimum cell width in pixels (0 = auto-fit).

Default: 80

Totals

Show Row Totals

boolean

Add a total row summarizing each column.

Default: false

Show Column Totals

boolean

Add a total column summarizing each row.

Default: false

Gradient Colors

Min Color

color

Color for the lowest values in the gradient.

Default: #f7fbff

Max Color

color

Color for the highest values in the gradient.

Default: #08519c

Common settings like Tooltip, Axis, and Small Multiples configuration are covered in Shared Concepts.

Tips & Best Practices

  • Enable "Show Values" to overlay numeric labels on cells for precise reading
  • Use row and column totals to provide summary context alongside the color grid
  • Sequential color schemes like "blues" or "reds" work best for single-measure heatmaps

On this page