Skip to contents

Add boxplot

Usage

add_boxplot(
  plot,
  dodge_width = NULL,
  alpha = 0.3,
  saturation = 1,
  show_whiskers = TRUE,
  show_outliers = TRUE,
  box_width = 0.6,
  whiskers_width = 0.8,
  outlier.size = 0.5,
  coef = 1.5,
  outlier.shape = 19,
  outlier.alpha = 1,
  linewidth = 0.25,
  preserve = "total",
  ...
)

Arguments

plot

A tidyplot generated with the function tidyplot().

dodge_width

For adjusting the distance between grouped objects. Defaults to 0.8.

alpha

A number between 0 and 1 for the opacity of an object. A value of 0 is completely transparent, 1 is completely opaque.

saturation

A number between 0 and 1 for the color saturation of an object. A value of 0 is completely desaturated (white), 1 is the original color.

show_whiskers

Whether to show boxplot whiskers. Defaults to TRUE.

show_outliers

Whether to show outliers. Defaults to TRUE.

box_width

Width of the boxplot. Defaults to 0.6.

whiskers_width

Width of the whiskers. Defaults to 0.8.

outlier.size

Size of the outliers. Defaults to 0.5.

coef

Length of the whiskers as multiple of IQR. Defaults to 1.5.

outlier.shape

Shape of the outliers. Defaults to 19.

outlier.alpha

Opacity of the outliers. Defaults to 1.

linewidth

Thickness of the line in points (pt). Typical values range between 0.25 and 1.

preserve

Should dodging preserve the "total" width of all elements at a position, or the width of a "single" element?

...

Arguments passed on to the geom function.

Value

A tidyplot object.

Examples

study %>%
  tidyplot(x = treatment, y = score, color = treatment) %>%
  add_boxplot()


# Changing arguments:
study %>%
  tidyplot(x = treatment, y = score, color = treatment) %>%
  add_boxplot(show_whiskers = FALSE)


study %>%
  tidyplot(x = treatment, y = score, color = treatment) %>%
  add_boxplot(show_outliers = FALSE)


study %>%
  tidyplot(x = treatment, y = score, color = treatment) %>%
  add_boxplot(box_width = 0.2)


study %>%
  tidyplot(x = treatment, y = score, color = treatment) %>%
  add_boxplot(whiskers_width = 0.2)