Skip to main content

scale-brewer

Discrete ColorBrewer colour/fill scale.

palette names a ColorBrewer set such as "Set1" or "Spectral".

Usage

scale-brewer(
  ..args,
)

Parameters

Parameter	Default	Description
..args		Named arguments forwarded to the colour/fill scale.

Keys accepted by ..args:

• palette: ColorBrewer set name resolved through brewer-palette, e.g. "Set1" or "Spectral"; default "Set1".
• name: Axis or legend title, as a string or content; none (default) falls back to the mapped column name.
• limits: Array of level names selecting which levels appear and in which order; none (default) keeps the trained levels. A level name must be a string, because a discrete scale reads a bare number as a position rather than as a level, so quote a numeric level as "1".
• oob: Handling of rows whose level falls outside limits: "drop" (default) removes them; "squish" censors too, since clamping has no meaning on levels.
• labels: Array of labels in level order, a function of the level returning a string or content, or auto (default) to print the level itself.

Returns

Deferred scale spec consumed by scales.

Examples

Colour groups with a discrete ColorBrewer palette.

#let d = ((x: 1, y: 1, g: "a"), (x: 2, y: 2, g: "b"), (x: 3, y: 3, g: "c"))
#plot(
  data: d,
  mapping: aes(x: "x", y: "y", colour: "g"),
  layers: (geom-point(size: 3pt),),
  scales: scales(colour: scale-brewer(palette: "Set1")),
  width: 10cm,
  height: 6cm,
)

See also

scales, scale-distiller, scale-fermenter.