scale-y-reverse

Continuous y scale flipped bottom-to-top.

Thin wrapper over scale-y-continuous with transform: "reverse". Tick labels stay in data units; only the axis direction reverses.

Usage

scale-y-reverse(
  name: none,
  limits: none,
  breaks: auto,
  labels: auto,
)

Parameters

Parameter Default Description
name none Axis title. Overrides any name set via labs when both are present.
limits none Pair (lo, hi) clipping the trained domain, or none for automatic limits.
breaks auto Array of break values, or auto for automatic tick selection.
labels auto Array of tick labels aligned with breaks, or auto.

Returns

Scale object consumed by plot.

Examples

Reverse the y axis so larger values sit at the bottom.

#let d = range(1, 11).map(i => (x: i, y: i))
#plot(
  data: d,
  mapping: aes(x: "x", y: "y"),
  layers: (geom-point(size: 2pt),),
  scales: (scale-y-reverse(name: "y"),),
  width: 10cm,
  height: 6cm,
)

Scatter chart of ten diagonal points on a reversed y axis where larger values sit at the bottom while tick labels remain in data units.

Scatter chart of ten diagonal points on a reversed y axis where larger values sit at the bottom while tick labels remain in data units.

Useful for ranking displays where rank 1 should sit at the top.

#let d = (
  (team: "A", rank: 1),
  (team: "B", rank: 2),
  (team: "C", rank: 3),
  (team: "D", rank: 4),
)
#plot(
  data: d,
  mapping: aes(x: "team", y: "rank"),
  layers: (geom-point(size: 4pt),),
  scales: (scale-y-reverse(name: "Rank", breaks: (1, 2, 3, 4)),),
  width: 10cm,
  height: 6cm,
)

Scatter chart of four ranked teams on a reversed y axis so rank 1 sits at the top, with breaks pinned at 1 through 4.

Scatter chart of four ranked teams on a reversed y axis so rank 1 sits at the top, with breaks pinned at 1 through 4.

See also

scale-y-continuous, scale-x-reverse.

Back to top