Create donut plot using Cartesian coordinates system

There are two arguments absolutely needed in aes() mappings:

cat A discrete categories vector.
val A numerical values vector.

Usage

geom_donut(
  mapping = NULL,
  data = NULL,
  show.legend = NA,
  na.rm = FALSE,
  inherit.aes = TRUE,
  init_angle = 0,
  x0 = 0,
  y0 = 0,
  r1 = 1,
  r2 = 0.65,
  color = "black",
  alpha = 1,
  linewidth = 0.5,
  spotlight_max = FALSE,
  spotlight_cat = NULL,
  spotlight_position = NULL,
  labels_with_tick = FALSE,
  labels_family = "",
  labels_size = 5,
  labels_col = "black",
  labels_hjust = 0.5,
  labels_vjust = 0.5,
  labels_fontface = "plain",
  labels_lineheight = 1.2,
  tick_lwd = 1,
  ...
)

Arguments

mapping: Set of aesthetic mappings created by aes() or aes_(). If specified and inherit.aes = TRUE (the default), it is combined with the default mapping at the top level of the plot. You must supply mapping if there is no plot mapping.
data: to be displayed in this layer
show.legend: logical. Should this layer be included in the legends? NA, the default, includes if any aesthetics are mapped. FALSE never includes, and TRUE always includes. It can also be a named logical vector to finely select the aesthetics to display.
na.rm: If FALSE, the default, missing values are removed with a warning. If TRUE, missing values are silently removed.
inherit.aes: If FALSE, overrides the default aesthetics, rather than combining with them.
init_angle: Starting angle
x0: Init position x
y0: Init position y
r1: Outer circle radius
r2: Inner circle radius, should inferior to r1 value. r1 and r2 values are swapped otherwise.
color: Plot border colour
alpha: Filling colour transparency [0,1]
linewidth: Plot border size
spotlight_max: TRUE if we want the max value category to drive the positions of all categories
spotlight_cat: Should be a value inside categories vector. When it is provided, it is this category position which drives the positions of all categories
spotlight_position: It is used to position the category spotlighted. Value should be in c("top","right", "bottom", "left"). When a valid spotlight_cat is provided or spotlight_max is set to TRUE, the default spotlight_position value is set to TRUE
labels_with_tick: TRUE if we want tick when labelling categories
labels_family: Labels font family
labels_size: Labels font size
labels_col: Labels colour
labels_hjust: Labels horizontal adjusting
labels_vjust: Labels vertical adjusting
labels_fontface: Labels font face
labels_lineheight: Labels line height
tick_lwd: Ticks Size
...: other arguments passed on to layer().

Value

A ggplot2 layer.

Examples

my_df <- data.frame(cat = c("Apple", "Banana", "Pineapple"), val = c(2.65, 4.5, 6.25))
my_df |>
  ggplot2::ggplot() +
  geom_donut(ggplot2::aes(cat = cat, val = val)) +
  ggplot2::coord_equal()