theme_ds4psy: A basic and flexible plot theme (using ggplot2 and unikn).

Description

theme_ds4psy provides a generic ds4psy theme to use in ggplot2 commands.

Usage

theme_ds4psy(
  base_size = 11,
  base_family = "",
  base_line_size = base_size/22,
  base_rect_size = base_size/22,
  col_title = grey(0, 1),
  col_txt_1 = grey(0.1, 1),
  col_txt_2 = grey(0.2, 1),
  col_txt_3 = grey(0.1, 1),
  col_bgrnd = "transparent",
  col_panel = grey(1, 1),
  col_strip = "transparent",
  col_axes = grey(0, 1),
  col_gridx = grey(0.75, 1),
  col_gridy = grey(0.75, 1),
  col_brdrs = "transparent"
)

Value

A ggplot2 theme.

Arguments

base_size: Base font size (optional, numeric). Default: base_size = 11.
base_family: Base font family (optional, character). Default: base_family = "". Options include "mono", "sans" (default), and "serif".
base_line_size: Base line size (optional, numeric). Default: base_line_size = base_size/22.
base_rect_size: Base rectangle size (optional, numeric). Default: base_rect_size = base_size/22.
col_title: Color of plot title (and tag). Default: col_title = grey(.0, 1) (i.e., "black").
col_txt_1: Color of primary text (headings and axis labels). Default: col_title = grey(.1, 1).
col_txt_2: Color of secondary text (caption, legend, axes labels/ticks). Default: col_title = grey(.2, 1).
col_txt_3: Color of other text (facet strip labels). Default: col_title = grey(.1, 1).
col_bgrnd: Color of plot background. Default: col_bgrnd = "transparent".
col_panel: Color of panel background(s). Default: col_panel = grey(1.0, 1) (i.e., "white").
col_strip: Color of facet strips. Default: col_strip = "transparent".
col_axes: Color of (x and y) axes. Default: col_axes = grey(.00, 1) (i.e., "black").
col_gridx: Color of (major and minor) panel lines (through x/vertical). Default: col_gridx = grey(.75, 1) (i.e., light "grey").
col_gridy: Color of (major and minor) panel lines (through y/horizontal). Default: col_gridy = grey(.75, 1) (i.e., light "grey").
col_brdrs: Color of (panel and strip) borders. Default: col_brdrs = "transparent".

Details

The theme is lightweight and no-nonsense, but somewhat opinionated (e.g., in using transparency and grid lines, and relying on grey tones for emphasizing data with color accents).

Basic sizes and the colors of text elements, backgrounds, and lines can be specified. However, excessive customization rarely yields aesthetic improvements over the standard ggplot2 themes.

Examples

Run this code


# \donttest{

# Plotting iris dataset (using ggplot2 and unikn):

library('ggplot2')  # theme_ds4psy() requires ggplot2
library('unikn')    # for colors and usecol() function
   
ggplot(datasets::iris) +
  geom_jitter(aes(x = Petal.Length, y = Petal.Width, color = Species), size = 3, alpha = 2/3) +
  scale_color_manual(values = usecol(pal = c(Pinky, Seeblau, Seegruen))) +
  labs(title = "Iris petals",
       subtitle = "The subtitle of this plot", 
       caption = "Data from datasets::iris") +
  theme_ds4psy()

ggplot(datasets::iris) +
  geom_jitter(aes(x = Sepal.Length, y = Sepal.Width, color = Species), size = 3, alpha = 2/3) +
  facet_wrap(~Species) +
  scale_color_manual(values = usecol(pal = c(Pinky, Seeblau, Seegruen))) +
  labs(tag = "A",
       title = "Iris sepals",
       subtitle = "Demo plot with facets and default colors", 
       caption = "Data from datasets::iris") + 
  coord_fixed(ratio = 3/2) + 
  theme_ds4psy()

# A unikn::Seeblau look:

ggplot(datasets::iris) +
  geom_jitter(aes(x = Sepal.Length, y = Sepal.Width, color = Species), size = 3, alpha = 2/3) +
  facet_wrap(~Species) +
  scale_color_manual(values = usecol(pal = c(Pinky, Seeblau, Seegruen))) +
  labs(tag = "B",
       title = "Iris sepals",
       subtitle = "Demo plot in unikn::Seeblau colors", 
       caption = "Data from datasets::iris") + 
  coord_fixed(ratio = 3/2) + 
  theme_ds4psy(col_title = pal_seeblau[[4]], col_strip = pal_seeblau[[1]], col_brdrs = Grau)

# }