treemap

Use for nested area by size. x label, y value ≥ 0, optional series parent. Omit series → flat leaves. With series → two levels only (parent → children). Negatives → E_NEGATIVE_VALUE. Rows with y ≤ 0 stay in the table but are omitted from paint.

Do not use for deeper trees, path strings, or sunburst / circular layouts.

x category (label) · y number (≥ 0) · series optional (parent)

Rules. Flat or two levels only. Rows with y≤0 omitted from paint. A repeated label under the same parent → E_DUP_KEY.

Example

markvis: 2
type: treemap
title: Red Line still carries Midtown mornings
x: station
y: boardings
series: line

station,line,boardings
Five Points,Red,4200
Midtown,Red,3100
Arts Center,Red,1800
Airport,Gold,3600
Peachtree Center,Gold,2200

Red Line still carries Midtown mornings

station	line	boardings
Five Points	Red	4200
Midtown	Red	3100
Arts Center	Red	1800
Airport	Gold	3600
Peachtree Center	Gold	2200

When the block is wrong

The rows stay, with one line that names the error.

markvis: 2
type: treemap
title: Negative
x: station
y: boardings

station,boardings
Five Points,1200
Midtown,-40

station	boardings
Five Points	1200
Midtown	-40

E_NEGATIVE_VALUE: treemap values must be >= 0

Generated from packages/types/treemap/ and the type's row in SPEC.md.