guide-axis-theta

Customise the theta (angular) axis under coord-radial.

The returned spec carries customisation only; it is bound to the theta axis when passed through guides as theta: guide-axis-theta(...), and applied by the radial axis renderer. When bound the renderer draws an outer axis arc spanning the active theta range; without it the radial axis remains spoke-only.

Usage

guide-axis-theta(
  angle: 0,
  minor-ticks: false,
  cap: "none",
)

Parameters

Parameter Default Description
angle 0 Tick-label rotation in degrees: 0 horizontal, 45 readable diagonal, 90 vertical.
minor-ticks false Whether to draw short tick marks at half-step positions between major theta breaks.
cap "none" Where to trim the axis arc: "none" (full sweep), "both", "upper", or "lower".

Returns

Guide dictionary tagged kind: "guide", consumed by guides.

Examples

Rotate theta tick labels on a radar plot.

#let d = (
  (axis: "speed", value: 4),
  (axis: "comfort", value: 3),
  (axis: "range", value: 5),
  (axis: "boot", value: 2),
)
#plot(
  data: d,
  mapping: aes(x: "axis", y: "value"),
  layers: (geom-col(),),
  coord: coord-radial(),
  guides: guides(theta: guide-axis-theta(angle: 30, minor-ticks: true)),
  width: 8cm,
  height: 8cm,
)

Radial bar chart with theta-axis category labels tilted 30 degrees and minor ticks between major spokes.

Radial bar chart with theta-axis category labels tilted 30 degrees and minor ticks between major spokes.

See also

guides, guide-axis, coord-radial.

Back to top