Skip to contents

Sketchy jittered points

Source: R/geom-sketch-jitter.R
geom_sketch_jitter.Rd

A convenience wrapper around geom_sketch_point() that adds a small amount of random position noise to reduce overplotting — the sketch analogue of ggplot2::geom_jitter().

Usage

geom_sketch_jitter(
  mapping = NULL,
  data = NULL,
  stat = "identity",
  position = NULL,
  ...,
  width = NULL,
  height = NULL,
  roughness = 0.5,
  bowing = 1,
  n_passes = 2L,
  seed = NULL,
  na.rm = FALSE,
  show.legend = NA,
  inherit.aes = TRUE
)

Arguments

mapping

Set of aesthetic mappings. Supports x, y, colour, size, alpha, and roughness.

data

Data to display.

stat

Statistical transformation (default "identity").

position

Position adjustment (default "identity").

...

Other arguments passed on to the layer.

width, height

Amount of horizontal/vertical jitter (passed to ggplot2::position_jitter()). NULL uses 40% of the data resolution.

roughness

Non-negative roughness parameter (0 = straight). Default 1.

bowing

Non-negative bowing multiplier. Default 1.

n_passes

Number of stroke passes for the double-stroke effect. Default 2.

seed

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

na.rm

If FALSE (default), missing values are removed with a warning.

show.legend

Logical. Should this layer be included in the legend?

inherit.aes

If FALSE, override the default aesthetics.

Value

A ggplot2 layer object.

See also

Other sketch-geoms: GeomSketchAbline, GeomSketchBoxplot, 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_qq(), geom_sketch_quantile(), geom_sketch_text()

Examples

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