Skip to contents

Sketchy boxplot

Source: R/geom-sketch-boxplot.R
geom_sketch_boxplot.Rd

A hand-drawn box-and-whisker plot: a roughened IQR box, a thick median line, rough whiskers, and sketchy outlier points. Uses ggplot2::stat_boxplot() for the five-number summary — the sketch analogue of ggplot2::geom_boxplot().

Usage

GeomSketchBoxplot

geom_sketch_boxplot(
  mapping = NULL,
  data = NULL,
  stat = "boxplot",
  position = "dodge2",
  ...,
  roughness = 0.8,
  bowing = 1,
  n_passes = 2L,
  seed = NULL,
  fill_style = "solid",
  hachure_angle = 45,
  hachure_gap = NULL,
  fill_weight = 0.5,
  outliers = TRUE,
  na.rm = FALSE,
  show.legend = NA,
  inherit.aes = TRUE
)

Format

An object of class GeomSketchBoxplot (inherits from Geom, ggproto, gg) of length 7.

Arguments

mapping

Set of aesthetic mappings created by ggplot2::aes().

data

Data to display.

stat

Statistical transformation. Default "boxplot".

position

Position adjustment. Default "dodge2".

...

Other arguments passed on to the layer.

roughness

Non-negative roughness. Default 0.8 (boxes read cleaner).

bowing

Non-negative bowing multiplier. Default 1.

n_passes

Number of stroke passes. Default 2.

seed

Integer seed. NULL uses getOption("ggsketch.seed", 1L).

fill_style

Box fill style. Default "solid". The box is outline-only until you give it a fill (the default fill is NA); set fill for a solid box, or use e.g. fill_style = "hachure" with a fill for shaded boxes.

hachure_angle, hachure_gap, fill_weight

Fill parameters.

outliers

Draw outlier points? Default TRUE.

na.rm

Remove missing values silently? Default FALSE.

show.legend

Logical; include in legend?

inherit.aes

Override default aesthetics?

Value

A ggplot2 layer object.

See also

Other sketch-geoms: GeomSketchAbline, GeomSketchBracket, GeomSketchCol, GeomSketchCurve, GeomSketchEllipse, GeomSketchHex, GeomSketchLine, GeomSketchLinerange, GeomSketchPath, GeomSketchPoint, GeomSketchPolygon, GeomSketchRect, GeomSketchRibbon, GeomSketchRug, GeomSketchSegment, GeomSketchSmooth, GeomSketchSpoke, GeomSketchViolin, annotate_sketch(), geom_sketch_bin2d(), geom_sketch_contour(), geom_sketch_count(), geom_sketch_density(), geom_sketch_density2d(), geom_sketch_function(), geom_sketch_histogram(), geom_sketch_jitter(), geom_sketch_qq(), geom_sketch_quantile(), geom_sketch_text()

Examples

library(ggplot2)
ggplot(mpg, aes(class, hwy)) +
  geom_sketch_boxplot(seed = 1L) +
  theme_sketch()