Skip to contents

Sketchy hexagonal heatmap

Source: R/geom-sketch-hex.R
geom_sketch_hex.Rd

Bins data into hexagons and draws each as a hand-drawn hexagon shaded by count — the sketch analogue of ggplot2::geom_hex() / ggplot2::stat_bin_hex(). Requires the optional hexbin package.

Usage

GeomSketchHex

geom_sketch_hex(
  mapping = NULL,
  data = NULL,
  stat = "binhex",
  position = "identity",
  ...,
  bins = 30,
  binwidth = NULL,
  roughness = 1,
  bowing = 1,
  n_passes = 2L,
  seed = NULL,
  fill_style = "hachure",
  hachure_angle = 45,
  hachure_gap = NULL,
  fill_weight = 0.5,
  na.rm = FALSE,
  show.legend = NA,
  inherit.aes = TRUE
)

Format

An object of class GeomSketchHex (inherits from Geom, ggproto, gg) of length 6.

Arguments

mapping

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

data

Data to display.

stat

Statistical transformation. Default "identity" for geom_sketch_col(); "count" for geom_sketch_bar().

position

Position adjustment. Default "stack".

...

Other arguments passed on to the layer.

bins

Number of hexagons in each direction. Default 30.

binwidth

Hexagon width(s); overrides bins when supplied.

roughness

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

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

One of "hachure", "cross_hatch", "zigzag", "zigzag_line", "scribble", "dots", "dashed", or "solid". Default "hachure".

hachure_angle

Fill line angle in degrees. Default 45.

hachure_gap

Fill line gap in data units (NULL = 15% of bar width).

fill_weight

Stroke weight for fill lines. Default 0.5.

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, GeomSketchBoxplot, GeomSketchBracket, GeomSketchCol, GeomSketchCurve, GeomSketchEllipse, 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)
if (requireNamespace("hexbin", quietly = TRUE)) {
  ggplot(faithful, aes(eruptions, waiting)) +
    geom_sketch_hex(bins = 12, seed = 1L) +
    scale_fill_viridis_c() +
    theme_sketch()
}