Complete ggplot2 theme for Stem. — theme

A complete ggplot2 theme carrying the Stem look. Because it is complete, the Stem plotting functions do not apply it themselves; instead activate it globally with ggplot2::theme_set() so every plot picks it up:

Usage

theme_stem(
  ink = "black",
  paper = "white",
  accent = "#35978F",
  family = "Calibri",
  label_size = 14,
  ...
)

Arguments

ink: Foreground colour used for text, titles and axis lines. Also passed to ggplot2::element_geom() as the default geom foreground colour.
paper: Background colour used behind the panel, plot, strips and legend keys. Also passed to ggplot2::element_geom() as the default geom background colour. Use NA for a transparent background (useful when exporting plots to be placed on a coloured surface).
accent: Accent colour passed to ggplot2::element_geom() as the default geom accent colour (e.g. the fill of ggplot2::geom_smooth()). Defaults to the primary Stem brand colour.
family: Font family for all text. Defaults to "Calibri", the Stem house font. Pass "" to use the graphics device's default family (useful on machines where Calibri is not installed).
label_size: Point size of the numeric labels drawn inside the plot (the stem_label values printed by stem_barplot() and friends). Passed to ggplot2::element_geom() as fontsize, so it is given in points, like the other text sizes of the theme. Defaults to 14, matching the label size used by the Stem apps.
...: Arguments to be passed to ggplot2::theme(), overriding the Stem defaults.

Value

A complete ggplot2 ggplot2::theme() object.

Details

ggplot2::theme_set(theme_stem())

It can still be added to an individual plot with + theme_stem() in the usual way. The theme is built on ggplot2::theme_grey() with the Stem overrides layered on top.

Examples

if (FALSE) { # \dontrun{
# Activate globally for the whole session.
ggplot2::theme_set(theme_stem())
stem_barplot(trust, government)

# Or add it to a single plot.
stem_barplot(trust, government) + theme_stem()
} # }