Skip to content

Commit

Permalink
fixes
Browse files Browse the repository at this point in the history
  • Loading branch information
strengejacke committed Oct 25, 2024
1 parent 6227a46 commit 5718d28
Show file tree
Hide file tree
Showing 7 changed files with 87 additions and 47 deletions.
7 changes: 3 additions & 4 deletions R/scale_color_metro.R
Original file line number Diff line number Diff line change
@@ -1,9 +1,8 @@
#' Metro color palette
#'
#' The palette based on Metro [Metro
#' colors](https://materialui.co/metrocolors).
#' Use `scale_color_metro_d` for *discrete* categories and
#' `scale_color_metro_c` for a *continuous* scale.
#' The palette based on Metro [Metro colors](https://materialui.co/metrocolors).
#' Use `scale_color_metro_d` for *discrete* categories and `scale_color_metro_c`
#' for a *continuous* scale.
#'
#' @inheritParams palette_metro
#' @inheritParams scale_color_flat
Expand Down
2 changes: 1 addition & 1 deletion R/scale_color_okabeito.R
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@
#'
#' The Okabe-Ito palette is only available as a discrete palette.
#' For color-accessible continuous variables, consider
#' [Paul Tol's palettes][scale_color_tol()] or
#' [Paul Tol's palettes][scale_color_tol_discrete()] or
#' [the viridis palettes][ggplot2::scale_colour_viridis_d()].
#'
#' @inheritParams palette_okabeito
Expand Down
47 changes: 28 additions & 19 deletions R/scale_color_tol.R
Original file line number Diff line number Diff line change
@@ -1,20 +1,25 @@
#' Paul Tol discrete/qualitative color palettes
#'
#' Tol (2021) presents a series of palettes built with mathematical principles that
#' are appropriate for diverse types of data. The colors in these schemes are:
#' - Visually distinct for all people, including viewers with color vision deficiencies
#' Tol (2021) presents a series of palettes built with mathematical principles
#' that are appropriate for diverse types of data. The colors in these schemes
#' are:
#' - Visually distinct for all people, including viewers with color vision
#' deficiencies
#' - Distinct from black and white
#' - Distinct on screen and paper,
#' - Cohesive; that is, they match well together
#'
#' Tol provides palettes appropriate to the 3 main types of data:
#' 1. Qualitative data – nominal or categorical data, where magnitude differences are not relevant.
#' 2. Diverging data – data ordered between two extremes where the midpoint is important.
#' 1. Qualitative data – nominal or categorical data, where magnitude
#' differences are not relevant.
#' 2. Diverging data – data ordered between two extremes where the midpoint is
#' important.
#' 3. Sequential data – data ordered from low to high.
#'
#' This function provides the qualitative palettes, as well as discrete rainbow sequential palettes.
#' Available palettes for each type of data are:
#' - Qualitative: bright, high-contrast, vibrant, muted, medium-contrast, pale, dark, light, ground_cover
#' This function provides the qualitative palettes, as well as discrete rainbow
#' sequential palettes. Available palettes for each type of data are:
#' - Qualitative: bright, high-contrast, vibrant, muted, medium-contrast, pale,
#' dark, light, ground_cover
#' - Diverging: sunset, BuRd, PRGn
#' - Sequential: YlOrBr, iridescent, rainbow_discrete, rainbow_smooth
#'
Expand All @@ -27,11 +32,11 @@
#' ## Colors for missing or invalid data
#'
#' A useful feature of Tol's diverging and sequential palettes is that he
#' provides a recommended color to use for data that fall outside the data
#' range represented by the color scale (e.g., for invalid or missing data).
#' These colors are chosen to be highly distinct from the main color palette.
#' provides a recommended color to use for data that fall outside the data range
#' represented by the color scale (e.g., for invalid or missing data). These
#' colors are chosen to be highly distinct from the main color palette.
#'
#' @inheritParams palette_tol
#' @inheritParams palette_tol_discrete
#' @inheritParams scale_color_flat
#'
#' @references
Expand Down Expand Up @@ -73,7 +78,7 @@ scale_color_tol_discrete <- function(palette = "bright", reverse = FALSE, order

# Fill --------------------------------------------------------------------

#' @rdname scale_color_tol
#' @rdname scale_color_tol_discrete
#' @export
scale_fill_tol_discrete <- function(palette = "bright", reverse = FALSE, order = NULL, aesthetics = "fill", ...) {
discrete_scale(
Expand All @@ -85,7 +90,7 @@ scale_fill_tol_discrete <- function(palette = "bright", reverse = FALSE, order =

# Aliases -----------------------------------------------------------------

#' @rdname scale_color_tol
#' @rdname scale_color_tol_discrete
#' @export
scale_colour_tol_discrete <- scale_color_tol_discrete

Expand Down Expand Up @@ -175,19 +180,23 @@ tol_colors <- function(..., palette = "bright") {
#' The palettes proposed by Tol (2021).
#'
#' @param palette Character name of palette. Can be:
#' - Qualitative: `"bright"`, `"high-contrast"`, `"vibrant"`, `"muted"`,` "medium-contrast"`, `"pale"`, `"dark"`, `"light"`, `"ground_cover"`
#' - Qualitative: `"bright"`, `"high-contrast"`, `"vibrant"`, `"muted"`,`
#' "medium-contrast"`, `"pale"`, `"dark"`, `"light"`, `"ground_cover"`
#' - Diverging: `"sunset"`, `"BuRd"`, `"PRGn"`
#' - Sequential: `"YlOrBr"`, `"iridescent"`, `"rainbow_discrete"`, `"rainbow_smooth"`
#' - Sequential: `"YlOrBr"`, `"iridescent"`, `"rainbow_discrete"`,
#' - `"rainbow_smooth"`
#' @param reverse Boolean indicating whether the palette should be reversed.
#' @param order A vector of numbers indicating the order of colors to use (default: `NULL` indicating to use all available colors in order).
#' @param ... For sequential palettes other than `rainbow_discrete`, additional arguments to pass to [`colorRampPalette()`][colorRampPalette].
#' @param order A vector of numbers indicating the order of colors to use
#' (default: `NULL` indicating to use all available colors in order).
#' @param ... For sequential palettes other than `rainbow_discrete`, additional
#' arguments to pass to [`colorRampPalette()`][colorRampPalette].
#'
#' @references
#' Tol, P. (2021). Colour schemes (SRON/EPS Technical Note No. 09-002; Version 3.2).
#' SRON. https://personal.sron.nl/~pault/data/colourschemes.pdf (Original work published 2009)
#'
#' @details This function is usually not called directly, but from within
#' [`scale_color_tol()`][scale_color_tol].
#' [`scale_color_tol()`].
#'
#' @export
palette_tol_discrete <- function(palette = "bright", reverse = FALSE, order = NULL, ...) {
Expand Down
9 changes: 6 additions & 3 deletions man/palette_tol_discrete.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 2 additions & 2 deletions man/scale_color_metro.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion man/scale_color_okabeito.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

63 changes: 46 additions & 17 deletions man/scale_color_tol_discrete.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

0 comments on commit 5718d28

Please sign in to comment.