khroma (version 1.3.0)

scale_tol_discrete: Paul Tol's Discrete Colour Schemes for ggplot2

Description

Provides qualitative colour scales from Paul Tol's Colour Schemes.

Usage

scale_colour_bright(..., reverse = FALSE, aesthetics = "colour")
scale_color_bright(..., reverse = FALSE, aesthetics = "colour")
scale_fill_bright(..., reverse = FALSE, aesthetics = "fill")
scale_colour_contrast(..., reverse = FALSE, aesthetics = "colour")
scale_color_contrast(..., reverse = FALSE, aesthetics = "colour")
scale_fill_contrast(..., reverse = FALSE, aesthetics = "fill")
scale_colour_vibrant(..., reverse = FALSE, aesthetics = "colour")
scale_color_vibrant(..., reverse = FALSE, aesthetics = "colour")
scale_fill_vibrant(..., reverse = FALSE, aesthetics = "fill")
scale_colour_muted(..., reverse = FALSE, aesthetics = "colour")
scale_color_muted(..., reverse = FALSE, aesthetics = "colour")
scale_fill_muted(..., reverse = FALSE, aesthetics = "fill")
scale_colour_pale(..., reverse = FALSE, aesthetics = "colour")
scale_color_pale(..., reverse = FALSE, aesthetics = "colour")
scale_fill_pale(..., reverse = FALSE, aesthetics = "fill")
scale_colour_dark(..., reverse = FALSE, aesthetics = "colour")
scale_color_dark(..., reverse = FALSE, aesthetics = "colour")
scale_fill_dark(..., reverse = FALSE, aesthetics = "fill")
scale_colour_light(..., reverse = FALSE, aesthetics = "colour")
scale_color_light(..., reverse = FALSE, aesthetics = "colour")
scale_fill_light(..., reverse = FALSE, aesthetics = "fill")

Arguments

...

Arguments passed to discrete_scale.

reverse

A logical scalar. Should the resulting vector of colours be reversed?

aesthetics

A character string or vector of character strings listing the name(s) of the aesthetic(s) that this scale works with.

Value

A discrete scale.

Qualitative colour schemes

According to Paul Tol's technical note, the bright, contrast, vibrant and muted colour schemes are colour-blind safe.

The light colour scheme is reasonably distinct for both normal or colour-blind vision and is intended to fill labelled cells.

The pale and dark schemes are not very distinct in either normal or colour-blind vision and should be used as a text background or to highlight a cell in a table.

Refer to the original document for details about the recommended uses (see references).

Details

The qualitative colour schemes are used as given (no interpolation): colours are picked up to the maximum number of supported values.

Palette	Max.
bright	7
contrast	3
vibrant	7
muted	9
pale	6
dark	6
light	9

References

Tol, P. (2018). Colour Schemes. SRON. Technical Note No. SRON/EPS/TN/09-002, issue 3.1. URL: https://personal.sron.nl/~pault/data/colourschemes.pdf

See Also

Other Paul Tol's colour schemes: scale_tol_diverging, scale_tol_sequential

Examples

# NOT RUN {
library(ggplot2)

ggplot2::ggplot(mpg, ggplot2::aes(displ, hwy, colour = class)) +
  ggplot2::geom_point() +
  scale_colour_bright()

ggplot2::ggplot(mpg, ggplot2::aes(displ, hwy, colour = class)) +
  ggplot2::geom_point() +
  scale_colour_vibrant()

ggplot2::ggplot(diamonds, ggplot2::aes(clarity, fill = cut)) +
  ggplot2::geom_bar() +
  scale_fill_muted()

ggplot2::ggplot(diamonds, ggplot2::aes(clarity, fill = cut)) +
  ggplot2::geom_bar() +
  scale_fill_pale()

ggplot2::ggplot(diamonds, ggplot2::aes(clarity, fill = cut)) +
  ggplot2::geom_bar() +
  scale_fill_dark()

ggplot2::ggplot(diamonds, ggplot2::aes(clarity, fill = cut)) +
  ggplot2::geom_bar() +
  scale_fill_light()
# }