scale-fermenter
Binned ColorBrewer colour/fill scale (fermenter).
Usage
scale-fermenter(
..args,
)Parameters
| Parameter | Default | Description |
|---|---|---|
..args |
Named arguments forwarded to the colour/fill scale. |
Keys accepted by ..args:
palette: ColorBrewer set name resolved throughbrewer-palette, e.g."Set1"or"Spectral"; default"Spectral".n-breaks: Integer number of equal-width bins used whenbreaksisauto; default 5.breaks: Array of bin edges, a function of the trained values returning edges (thebreaks-*helpers return such a function), ticked at the bin midpoints and overridingn-breaks, orauto(default) to cutn-breaksequal-width bins.direction:1(default) keeps the palette order; a negative value reverses it.name: Axis or legend title, as a string or content;none(default) falls back to the mapped column name.limits: Domain as a(lo, hi)pair, where either side may beautoto train that side from the data;none(default) trains both sides.oob: Handling of rows outsidelimits:"drop"(default) removes them,"squish"clamps them to the nearest limit.labels: Array of labels aligned with the breaks, a function of the break value returning a string or content (theformat-*helpers return such a function), orauto(default) to format each break.
Returns
Deferred scale spec consumed by scales.
Examples
Bin a numeric fill into ColorBrewer stepped bands.
#let d = range(0, 12).map(i => (x: i, y: i, w: i + 1))
#plot(
data: d,
mapping: aes(x: "x", y: "y", fill: "w"),
layers: (geom-point(size: 5pt),),
scales: scales(fill: scale-fermenter(palette: "Spectral", n-breaks: 5)),
width: 10cm,
height: 6cm,
)
