Dot Matrix Chart
Source: Data Visualisation Catalogue - Dot Matrix Chart
Why This Belongs In The Compiler Gallery
Dot matrix charts test repeated-symbol layout. The visible marks are ordinary point glyphs, but the compiler needs to expand raw category counts into repeated dots with stable row/column positions.
Data Contract
Each raw row is one category total.
| Field | Type | Purpose |
|---|---|---|
category | categorical | Row/group label. |
value | quantitative | Count represented by repeated dots. |
representedValue | quantitative, derived | Value represented by an individual dot. |
cx, cy, r | quantitative, derived | Dot geometry. |
Expected Visual
Each category renders as a compact grid of same-size dots. The first gallery version uses one dot for up to five units, preserving source-row lineage on every generated dot.
Compiler Mapping
| Compiler part | Mapping |
|---|---|
| Data source | category-counts raw rows and derived matrix-dots. |
| Transform | layout with layoutKind: "dotMatrix" expands each count into repeated dot rows. |
| Scales | category: band for labels, color: ordinal(category) for dots. |
| Layers | Category labels and point glyphs. |
Faithfulness Notes
The core repeated-dot expansion is compiler-owned now. Remaining work is a richer symbol template system for pictograms/tally charts, plus exact remainder policies and responsive dot packing.