Inline stacked bar plot — stem

Plots the (possibly weighted) distribution of a single categorical variable as one stacked horizontal bar. Useful as a compact, inline summary of a single item.

Usage

stem_inline(
  data,
  item,
  weight = NULL,
  collapse_item = NULL,
  palette = "div1",
  direction = 1,
  labels = TRUE,
  label_accuracy = 1,
  label_suffix = "",
  label_hide = 0.05,
  label_color = "black",
  label_bicolor = TRUE,
  title_show = FALSE,
  title_quote = FALSE,
  title_wrap = 80
)

Arguments

data: Data frame holding the item (and group) variables.
item: Categorical variable to plot.
weight: Optional survey weights.
collapse_item: Optional named list passed to stem_summarise_cat() to collapse (or rename) item categories.
palette: Name of a Stem palette. See stem_palette().
direction: Palette direction. Use -1 to reverse the colours.
labels: If TRUE, prints a percentage label on each bar.
label_accuracy: Rounding accuracy of labels. 1 gives whole numbers, 0.1 one decimal place.
label_suffix: Suffix appended to labels. Defaults to "".
label_hide: Proportions below this threshold are left unlabelled. Defaults to 0.05 when a group is supplied (to keep small stacked segments unlabelled) and 0 otherwise.
label_color: Colour of the segment labels in grouped (stacked) plots. Defaults to "black".
label_bicolor: If TRUE (default), in grouped (stacked) plots the labels of the two side (extreme) item categories are drawn in white, while all other labels use label_color. Set to FALSE to colour every label with label_color.
title_show: If TRUE, adds a plot title taken from the item's "label" attribute, falling back to the variable name when no label is present. The title is styled (e.g. drawn in bold) by theme_stem(). Defaults to FALSE.
title_quote: If TRUE, wraps the title in low/high double quotation marks („ and “). Defaults to FALSE.
title_wrap: Maximum number of characters per title line; longer titles are wrapped onto several lines so they do not overflow the plot. Use NULL or Inf to disable wrapping. Defaults to 80.

Value

A ggplot2 object.

Examples

if (FALSE) { # \dontrun{
stem_inline(trust, police)
stem_inline(trust, police, weight = W)
} # }