scale-grey

Discrete greyscale colour/fill scale.

start and end bound the grey range in [0, 1].

Usage

scale-grey(
  ..args,
)

Parameters

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

Keys accepted by ..args:

  • start: Lightness of the first grey, a number in [0, 1]; default 0.2.
  • end: Lightness of the last grey, a number in [0, 1]; default 0.8.
  • 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 along a discrete greyscale ramp.

#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-grey(start: 0.1, end: 0.8)),
  width: 10cm,
  height: 6cm,
)

Scatter chart of three points coloured by group along a discrete greyscale ramp from light to dark.

Scatter chart of three points coloured by group along a discrete greyscale ramp from light to dark.

See also

scales, scale-brewer.

Back to top