heatmap
Use for two discrete categories (x and series) with a numeric intensity (y). Long form only: one row per cell. Keep first-seen category order. series is required.
Do not use for a single category comparison (bar) or a continuous scatter cloud (scatter).
x category · y number (intensity) · series required (category)
Rules. Long form only. Keep row order. Both cats discrete. Empty y is a missing cell, not zero. Optional min/max share the color domain across figures.
Example
chart
markvis: 2
type: heatmap
title: Eight o'clock still packs Five Points entries
x: hour
y: entries
series: weekday
hour,weekday,entries
7am,Mon,420
8am,Mon,880
9am,Mon,610
7am,Tue,390
8am,Tue,910
9am,Tue,640| hour | weekday | entries |
|---|---|---|
| 7am | Mon | 420 |
| 8am | Mon | 880 |
| 9am | Mon | 610 |
| 7am | Tue | 390 |
| 8am | Tue | 910 |
| 9am | Tue | 640 |
When the block is wrong
The rows stay, with one line that names the error.
chart
markvis: 2
type: heatmap
title: Missing series
x: hour
y: entries
hour,weekday,entries
7am,Mon,420
8am,Tue,880| hour | weekday | entries |
|---|---|---|
| 7am | Mon | 420 |
| 8am | Tue | 880 |
E_UNKNOWN_FIELD: heatmap requires series
Generated from packages/types/heatmap/ and the type's row in SPEC.md.