Package 'INBOtheme' reference manual

Title:	Themes for ggplot2
Description:	Several themes for the ggplot2 package. Among others themes complying with the style guide for the Research Institute for Nature and Forest (INBO) and Elsevier journals.
Authors:	Thierry Onkelinx [aut, cre] , Oona Op de Weerdt [ctb], Nicole De Groof [ctb] , Research Institute for Nature and Forest (INBO) [cph, fnd]
Maintainer:	Thierry Onkelinx <[email protected]>
License:	GPL-3
Version:	0.6.0
Built:	2024-12-16 03:31:13 UTC
Source:	https://github.com/inbo/inbotheme

Calculate a distance matrix between colours for colour blind people

Description

The function calculates the distance matrices for every option. Then aggregates the matrices into a single distance matrix.

Usage

colour_blind_distance(
  colours,
  deutan = TRUE,
  protan = FALSE,
  tritan = FALSE,
  gray = FALSE,
  fun = min,
  method = "emd"
)
colour_blind_distance(
  colours,
  deutan = TRUE,
  protan = FALSE,
  tritan = FALSE,
  gray = FALSE,
  fun = min,
  method = "emd"
)

Arguments

`colours`	a vector of colours
`deutan`	correct for deuteranomaly (red - green colour blindness). Defaults to `TRUE`.
`protan`	correct for protanopia (red - green colour blindness). Defaults to `FALSE`.
`tritan`	correct for tritanopia (blue - yellow colour blindness). Defaults to `FALSE`.
`gray`	correct for monochromacy (unable to distinguish colours). Defaults to `FALSE`.
`fun`	Function to aggregate different colour distance matrices.
`method`	passed to `colordistance::getColorDistanceMatrix()`

Calculate a distance matrix between colours

Description

Calculate a distance matrix between colours

Usage

colour_distance(colours, method = "emd")
colour_distance(colours, method = "emd")

Arguments

`colours`	a vector of colours
`method`	passed to `colordistance::getColorDistanceMatrix()`

Demonstrate colours in a palette

Description

Create an image with a number of rectangles coloured along the input vector.

Usage

demo_palette(colours)
demo_palette(colours)

Arguments

colours

a vector of colours

Colour according to the INBO style guide version >= 2015

Description

Colour according to the INBO style guide as hexadecimal values.

inbo_hoofd
inbo_steun_donkerroos
inbo_steun_blauw
inbo_steun_geelgroen
inbo_oranje
inbo_rood
inbo_bruinrood
inbo_grijs
inbo_lichtgrijs
inbo_grijsblauw
inbo_lichtblauw
inbo_achtergrond
inbo_munt
inbo_lichtgroen
inbo_donkergroen
inbo_groen
inbo_geelgr
inbo_oranje
inbo_geel
inbo_felrood
inbo_groen
inbo_kaki
inbo_oranjerood
inbo_donkerblauw

Author(s)

Thierry Onkelinx, Oona Op de Weerdt, Nicole De Groof

A Colour Palette According the INBO Style Guide Version >= 2015.

Description

A Colour Palette According the INBO Style Guide Version >= 2015.

Usage

inbo_palette(n)
inbo_palette(n)

Arguments

`n`	The number of colours

Value

a vector of n hexadecimal values defining the colours.

Author(s)

Thierry Onkelinx, Oona Op de Weerdt, Nicole De Groof

Deprecated functions

Description

These functions will be removed from INBOtheme in the future.

Usage

inbo.2015.colours(n)

switchColour(new_colour = inbo_steun_blauw)

vlaanderen.2015.colours(n)
inbo.2015.colours(n)

switchColour(new_colour = inbo_steun_blauw)

vlaanderen.2015.colours(n)

Arguments

`n`	The number of colours
`new_colour`	The new default colour.

A Colour Palette for NARA reports.

Description

Deprecated. Use inbo_palette() instead.

Usage

nara_palette(n)
nara_palette(n)

Arguments

`n`	The number of colours

Value

a vector of n hexadecimal values defining the colours.

Order variables to maximise contrasts

Description

Start with variable which has the largest distance between all other variables. Then add the variable with the largest distance to the already selected variables.

Usage

optimal_order(distance, selected = character(0))
optimal_order(distance, selected = character(0))

Arguments

`distance`	a square distance matrix
`selected`	optional vector of preselected variables

Value

a vector variable names

Palette for ordinal variables

Description

The colour ramps depends on the active ggplot2 theme.

Usage

ordinal_palette(n)
ordinal_palette(n)

Arguments

`n`	The number of colours

Standard dimensions for the Elsevier style guide

Description

Several standard dimensions for the Elsevier style guide -page_height Maximal height of a figure (in inch). -page_width Width of a figure covering two columns (in inch). -column_width Width of a figure covering one column (in inch). -medium_width Width of a figure covering 1.5 columns (in inch).

redefine `ggplot2::scale_colour_discrete()`

Description

Selects the colours depending on the current set theme.

Usage

scale_colour_discrete(..., type)

scale_color_discrete(..., type)
scale_colour_discrete(..., type)

scale_color_discrete(..., type)

Arguments

`...`	Additional parameters passed on to the scale type,
`type`	Ignored argument. Only present to match the arguments of `ggplot2::scale_fill_discrete()`

Author(s)

Thierry Onkelinx, Oona Op de Weerdt, Nicole De Groof

redefine `ggplot2::scale_colour_gradient()`

Description

Selects the colours depending on the current set theme.

Usage

scale_colour_gradient(
  ...,
  low,
  high,
  space = "Lab",
  na.value = "grey50",
  guide = "colourbar",
  aesthetics = "colour"
)

scale_color_gradient(
  ...,
  low,
  high,
  space = "Lab",
  na.value = "grey50",
  guide = "colourbar",
  aesthetics = "colour"
)
scale_colour_gradient(
  ...,
  low,
  high,
  space = "Lab",
  na.value = "grey50",
  guide = "colourbar",
  aesthetics = "colour"
)

scale_color_gradient(
  ...,
  low,
  high,
  space = "Lab",
  na.value = "grey50",
  guide = "colourbar",
  aesthetics = "colour"
)

Arguments

`...`	Arguments passed on to `continuous_scale` `scale_name` The name of the scale that should be used for error messages associated with this scale. `palette` A palette function that when called with a numeric vector with values between 0 and 1 returns the corresponding output values (e.g., `scales::area_pal()`). `name` The name of the scale. Used as the axis or legend title. If `waiver()`, the default, the name of the scale is taken from the first mapping used for that aesthetic. If `NULL`, the legend title will be omitted. `breaks` One of: `NULL` for no breaks `waiver()` for the default breaks computed by the transformation object A numeric vector of positions A function that takes the limits as input and returns breaks as output (e.g., a function returned by `scales::extended_breaks()`). Also accepts rlang lambda function notation. `minor_breaks` One of: `NULL` for no minor breaks `waiver()` for the default breaks (one minor break between each major break) A numeric vector of positions A function that given the limits returns a vector of minor breaks. Also accepts rlang lambda function notation. `n.breaks` An integer guiding the number of major breaks. The algorithm may choose a slightly different number to ensure nice break labels. Will only have an effect if `breaks = waiver()`. Use `NULL` to use the default number of breaks given by the transformation. `labels` One of: `NULL` for no labels `waiver()` for the default labels computed by the transformation object A character vector giving labels (must be same length as `breaks`) An expression vector (must be the same length as breaks). See ?plotmath for details. A function that takes the breaks as input and returns labels as output. Also accepts rlang lambda function notation. `limits` One of: `NULL` to use the default scale range A numeric vector of length two providing limits of the scale. Use `NA` to refer to the existing minimum or maximum A function that accepts the existing (automatic) limits and returns new limits. Also accepts rlang lambda function notation. Note that setting limits on positional scales will remove data outside of the limits. If the purpose is to zoom, use the limit argument in the coordinate system (see `coord_cartesian()`). `rescaler` A function used to scale the input values to the range [0, 1]. This is always `scales::rescale()`, except for diverging and n colour gradients (i.e., `scale_colour_gradient2()`, `scale_colour_gradientn()`). The `rescaler` is ignored by position scales, which always use `scales::rescale()`. Also accepts rlang lambda function notation. `oob` One of: Function that handles limits outside of the scale limits (out of bounds). Also accepts rlang lambda function notation. The default (`scales::censor()`) replaces out of bounds values with `NA`. `scales::squish()` for squishing out of bounds values into range. `scales::squish_infinite()` for squishing infinite values into range. `trans` For continuous scales, the name of a transformation object or the object itself. Built-in transformations include "asn", "atanh", "boxcox", "date", "exp", "hms", "identity", "log", "log10", "log1p", "log2", "logit", "modulus", "probability", "probit", "pseudo_log", "reciprocal", "reverse", "sqrt" and "time". A transformation object bundles together a transform, its inverse, and methods for generating breaks and labels. Transformation objects are defined in the scales package, and are called `⁠<name>_trans⁠` (e.g., `scales::boxcox_trans()`). You can create your own transformation with `scales::trans_new()`. `expand` For position scales, a vector of range expansion constants used to add some padding around the data to ensure that they are placed some distance away from the axes. Use the convenience function `expansion()` to generate the values for the `expand` argument. The defaults are to expand the scale by 5% on each side for continuous variables, and by 0.6 units on each side for discrete variables. `position` For position scales, The position of the axis. `left` or `right` for y axes, `top` or `bottom` for x axes. `super` The super class to use for the constructed scale
`low`	Colour for the low end of the gradient
`high`	Colour for the high end of the gradient
`space`	colour space in which to calculate gradient. Must be "Lab" - other values are deprecated.
`na.value`	Colour to use for missing values
`guide`	Type of legend. Use `"colourbar"` for continuous colour bar, or `"legend"` for discrete colour legend.
`aesthetics`	Character string or vector of character strings listing the name(s) of the aesthetic(s) that this scale works with. This can be useful, for example, to apply colour settings to the `colour` and `fill` aesthetics at the same time, via `aesthetics = c("colour", "fill")`.

Author(s)

Thierry Onkelinx, Oona Op de Weerdt, Nicole De Groof

redefine `ggplot2::scale_colour_gradient2()`

Description

Selects the colours depending on the current set theme.

Usage

scale_colour_gradient2(
  ...,
  low,
  high,
  mid,
  midpoint = 0,
  space = "Lab",
  guide = "colourbar",
  na.value = "grey50",
  aesthetics = "colour"
)

scale_color_gradient2(
  ...,
  low,
  high,
  mid,
  midpoint = 0,
  space = "Lab",
  guide = "colourbar",
  na.value = "grey50",
  aesthetics = "colour"
)
scale_colour_gradient2(
  ...,
  low,
  high,
  mid,
  midpoint = 0,
  space = "Lab",
  guide = "colourbar",
  na.value = "grey50",
  aesthetics = "colour"
)

scale_color_gradient2(
  ...,
  low,
  high,
  mid,
  midpoint = 0,
  space = "Lab",
  guide = "colourbar",
  na.value = "grey50",
  aesthetics = "colour"
)

Arguments

`...`	Arguments passed on to `continuous_scale` `scale_name` The name of the scale that should be used for error messages associated with this scale. `palette` A palette function that when called with a numeric vector with values between 0 and 1 returns the corresponding output values (e.g., `scales::area_pal()`). `name` The name of the scale. Used as the axis or legend title. If `waiver()`, the default, the name of the scale is taken from the first mapping used for that aesthetic. If `NULL`, the legend title will be omitted. `breaks` One of: `NULL` for no breaks `waiver()` for the default breaks computed by the transformation object A numeric vector of positions A function that takes the limits as input and returns breaks as output (e.g., a function returned by `scales::extended_breaks()`). Also accepts rlang lambda function notation. `minor_breaks` One of: `NULL` for no minor breaks `waiver()` for the default breaks (one minor break between each major break) A numeric vector of positions A function that given the limits returns a vector of minor breaks. Also accepts rlang lambda function notation. `n.breaks` An integer guiding the number of major breaks. The algorithm may choose a slightly different number to ensure nice break labels. Will only have an effect if `breaks = waiver()`. Use `NULL` to use the default number of breaks given by the transformation. `labels` One of: `NULL` for no labels `waiver()` for the default labels computed by the transformation object A character vector giving labels (must be same length as `breaks`) An expression vector (must be the same length as breaks). See ?plotmath for details. A function that takes the breaks as input and returns labels as output. Also accepts rlang lambda function notation. `limits` One of: `NULL` to use the default scale range A numeric vector of length two providing limits of the scale. Use `NA` to refer to the existing minimum or maximum A function that accepts the existing (automatic) limits and returns new limits. Also accepts rlang lambda function notation. Note that setting limits on positional scales will remove data outside of the limits. If the purpose is to zoom, use the limit argument in the coordinate system (see `coord_cartesian()`). `rescaler` A function used to scale the input values to the range [0, 1]. This is always `scales::rescale()`, except for diverging and n colour gradients (i.e., `scale_colour_gradient2()`, `scale_colour_gradientn()`). The `rescaler` is ignored by position scales, which always use `scales::rescale()`. Also accepts rlang lambda function notation. `oob` One of: Function that handles limits outside of the scale limits (out of bounds). Also accepts rlang lambda function notation. The default (`scales::censor()`) replaces out of bounds values with `NA`. `scales::squish()` for squishing out of bounds values into range. `scales::squish_infinite()` for squishing infinite values into range. `trans` For continuous scales, the name of a transformation object or the object itself. Built-in transformations include "asn", "atanh", "boxcox", "date", "exp", "hms", "identity", "log", "log10", "log1p", "log2", "logit", "modulus", "probability", "probit", "pseudo_log", "reciprocal", "reverse", "sqrt" and "time". A transformation object bundles together a transform, its inverse, and methods for generating breaks and labels. Transformation objects are defined in the scales package, and are called `⁠<name>_trans⁠` (e.g., `scales::boxcox_trans()`). You can create your own transformation with `scales::trans_new()`. `expand` For position scales, a vector of range expansion constants used to add some padding around the data to ensure that they are placed some distance away from the axes. Use the convenience function `expansion()` to generate the values for the `expand` argument. The defaults are to expand the scale by 5% on each side for continuous variables, and by 0.6 units on each side for discrete variables. `position` For position scales, The position of the axis. `left` or `right` for y axes, `top` or `bottom` for x axes. `super` The super class to use for the constructed scale
`low`	Colour for the low end of the gradient
`high`	Colour for the high end of the gradient
`mid`	colour for mid point
`midpoint`	The midpoint (in data value) of the diverging scale. Defaults to 0.
`space`	colour space in which to calculate gradient. Must be "Lab" - other values are deprecated.
`guide`	Type of legend. Use `"colourbar"` for continuous colour bar, or `"legend"` for discrete colour legend.
`na.value`	Colour to use for missing values
`aesthetics`	Character string or vector of character strings listing the name(s) of the aesthetic(s) that this scale works with. This can be useful, for example, to apply colour settings to the `colour` and `fill` aesthetics at the same time, via `aesthetics = c("colour", "fill")`.

Author(s)

Thierry Onkelinx, Oona Op de Weerdt, Nicole De Groof

redefine `ggplot2::scale_colour_viridis_d()`

Description

Selects the colours depending on the current set theme.

Usage

scale_colour_viridis_d(
  ...,
  alpha = 1,
  begin = 0,
  end = 1,
  direction = 1,
  option = "D",
  aesthetics = "colour"
)

scale_fill_viridis_d(
  ...,
  alpha = 1,
  begin = 0,
  end = 1,
  direction = 1,
  option = "D",
  aesthetics = "fill"
)
scale_colour_viridis_d(
  ...,
  alpha = 1,
  begin = 0,
  end = 1,
  direction = 1,
  option = "D",
  aesthetics = "colour"
)

scale_fill_viridis_d(
  ...,
  alpha = 1,
  begin = 0,
  end = 1,
  direction = 1,
  option = "D",
  aesthetics = "fill"
)

Arguments

`...`	Arguments passed on to `continuous_scale` `scale_name` The name of the scale that should be used for error messages associated with this scale. `palette` A palette function that when called with a numeric vector with values between 0 and 1 returns the corresponding output values (e.g., `scales::area_pal()`). `name` The name of the scale. Used as the axis or legend title. If `waiver()`, the default, the name of the scale is taken from the first mapping used for that aesthetic. If `NULL`, the legend title will be omitted. `breaks` One of: `NULL` for no breaks `waiver()` for the default breaks computed by the transformation object A numeric vector of positions A function that takes the limits as input and returns breaks as output (e.g., a function returned by `scales::extended_breaks()`). Also accepts rlang lambda function notation. `minor_breaks` One of: `NULL` for no minor breaks `waiver()` for the default breaks (one minor break between each major break) A numeric vector of positions A function that given the limits returns a vector of minor breaks. Also accepts rlang lambda function notation. `n.breaks` An integer guiding the number of major breaks. The algorithm may choose a slightly different number to ensure nice break labels. Will only have an effect if `breaks = waiver()`. Use `NULL` to use the default number of breaks given by the transformation. `labels` One of: `NULL` for no labels `waiver()` for the default labels computed by the transformation object A character vector giving labels (must be same length as `breaks`) An expression vector (must be the same length as breaks). See ?plotmath for details. A function that takes the breaks as input and returns labels as output. Also accepts rlang lambda function notation. `limits` One of: `NULL` to use the default scale range A numeric vector of length two providing limits of the scale. Use `NA` to refer to the existing minimum or maximum A function that accepts the existing (automatic) limits and returns new limits. Also accepts rlang lambda function notation. Note that setting limits on positional scales will remove data outside of the limits. If the purpose is to zoom, use the limit argument in the coordinate system (see `coord_cartesian()`). `rescaler` A function used to scale the input values to the range [0, 1]. This is always `scales::rescale()`, except for diverging and n colour gradients (i.e., `scale_colour_gradient2()`, `scale_colour_gradientn()`). The `rescaler` is ignored by position scales, which always use `scales::rescale()`. Also accepts rlang lambda function notation. `oob` One of: Function that handles limits outside of the scale limits (out of bounds). Also accepts rlang lambda function notation. The default (`scales::censor()`) replaces out of bounds values with `NA`. `scales::squish()` for squishing out of bounds values into range. `scales::squish_infinite()` for squishing infinite values into range. `trans` For continuous scales, the name of a transformation object or the object itself. Built-in transformations include "asn", "atanh", "boxcox", "date", "exp", "hms", "identity", "log", "log10", "log1p", "log2", "logit", "modulus", "probability", "probit", "pseudo_log", "reciprocal", "reverse", "sqrt" and "time". A transformation object bundles together a transform, its inverse, and methods for generating breaks and labels. Transformation objects are defined in the scales package, and are called `⁠<name>_trans⁠` (e.g., `scales::boxcox_trans()`). You can create your own transformation with `scales::trans_new()`. `expand` For position scales, a vector of range expansion constants used to add some padding around the data to ensure that they are placed some distance away from the axes. Use the convenience function `expansion()` to generate the values for the `expand` argument. The defaults are to expand the scale by 5% on each side for continuous variables, and by 0.6 units on each side for discrete variables. `position` For position scales, The position of the axis. `left` or `right` for y axes, `top` or `bottom` for x axes. `super` The super class to use for the constructed scale
`alpha`	The alpha transparency, a number in [0,1], see argument alpha in `hsv`.
`begin`, `end`	The (corrected) hue in `⁠[0,1]⁠` at which the color map begins and ends.
`direction`	Sets the order of colors in the scale. If 1, the default, colors are ordered from darkest to lightest. If -1, the order of colors is reversed.
`option`	A character string indicating the color map option to use. Eight options are available: "magma" (or "A") "inferno" (or "B") "plasma" (or "C") "viridis" (or "D") "cividis" (or "E") "rocket" (or "F") "mako" (or "G") "turbo" (or "H")
`aesthetics`	Character string or vector of character strings listing the name(s) of the aesthetic(s) that this scale works with. This can be useful, for example, to apply colour settings to the `colour` and `fill` aesthetics at the same time, via `aesthetics = c("colour", "fill")`.

Author(s)

Thierry Onkelinx, Oona Op de Weerdt, Nicole De Groof

redefine `ggplot2::scale_fill_discrete()`

Description

Selects the colours depending on the current set theme.

Usage

scale_fill_discrete(..., type)
scale_fill_discrete(..., type)

Arguments

...

Additional parameters passed on to the scale type,

type

One of the following:

A character vector of color codes. The codes are used for a 'manual' color scale as long as the number of codes exceeds the number of data levels (if there are more levels than codes, scale_colour_hue()/scale_fill_hue() are used to construct the default scale). If this is a named vector, then the color values will be matched to levels based on the names of the vectors. Data values that don't match will be set as na.value.
A list of character vectors of color codes. The minimum length vector that exceeds the number of data levels is chosen for the color scaling. This is useful if you want to change the color palette based on the number of levels.
A function that returns a discrete colour/fill scale (e.g., scale_fill_hue(), scale_fill_brewer(), etc).

Author(s)

Thierry Onkelinx, Oona Op de Weerdt, Nicole De Groof

redefine `ggplot2::scale_fill_gradient()`

Description

Selects the colours depending on the current set theme.

Usage

scale_fill_gradient(
  ...,
  low,
  high,
  space = "Lab",
  na.value = "grey50",
  guide = "colourbar",
  aesthetics = "fill"
)
scale_fill_gradient(
  ...,
  low,
  high,
  space = "Lab",
  na.value = "grey50",
  guide = "colourbar",
  aesthetics = "fill"
)

Arguments

`...`	Arguments passed on to `continuous_scale` `scale_name` The name of the scale that should be used for error messages associated with this scale. `palette` A palette function that when called with a numeric vector with values between 0 and 1 returns the corresponding output values (e.g., `scales::area_pal()`). `name` The name of the scale. Used as the axis or legend title. If `waiver()`, the default, the name of the scale is taken from the first mapping used for that aesthetic. If `NULL`, the legend title will be omitted. `breaks` One of: `NULL` for no breaks `waiver()` for the default breaks computed by the transformation object A numeric vector of positions A function that takes the limits as input and returns breaks as output (e.g., a function returned by `scales::extended_breaks()`). Also accepts rlang lambda function notation. `minor_breaks` One of: `NULL` for no minor breaks `waiver()` for the default breaks (one minor break between each major break) A numeric vector of positions A function that given the limits returns a vector of minor breaks. Also accepts rlang lambda function notation. `n.breaks` An integer guiding the number of major breaks. The algorithm may choose a slightly different number to ensure nice break labels. Will only have an effect if `breaks = waiver()`. Use `NULL` to use the default number of breaks given by the transformation. `labels` One of: `NULL` for no labels `waiver()` for the default labels computed by the transformation object A character vector giving labels (must be same length as `breaks`) An expression vector (must be the same length as breaks). See ?plotmath for details. A function that takes the breaks as input and returns labels as output. Also accepts rlang lambda function notation. `limits` One of: `NULL` to use the default scale range A numeric vector of length two providing limits of the scale. Use `NA` to refer to the existing minimum or maximum A function that accepts the existing (automatic) limits and returns new limits. Also accepts rlang lambda function notation. Note that setting limits on positional scales will remove data outside of the limits. If the purpose is to zoom, use the limit argument in the coordinate system (see `coord_cartesian()`). `rescaler` A function used to scale the input values to the range [0, 1]. This is always `scales::rescale()`, except for diverging and n colour gradients (i.e., `scale_colour_gradient2()`, `scale_colour_gradientn()`). The `rescaler` is ignored by position scales, which always use `scales::rescale()`. Also accepts rlang lambda function notation. `oob` One of: Function that handles limits outside of the scale limits (out of bounds). Also accepts rlang lambda function notation. The default (`scales::censor()`) replaces out of bounds values with `NA`. `scales::squish()` for squishing out of bounds values into range. `scales::squish_infinite()` for squishing infinite values into range. `trans` For continuous scales, the name of a transformation object or the object itself. Built-in transformations include "asn", "atanh", "boxcox", "date", "exp", "hms", "identity", "log", "log10", "log1p", "log2", "logit", "modulus", "probability", "probit", "pseudo_log", "reciprocal", "reverse", "sqrt" and "time". A transformation object bundles together a transform, its inverse, and methods for generating breaks and labels. Transformation objects are defined in the scales package, and are called `⁠<name>_trans⁠` (e.g., `scales::boxcox_trans()`). You can create your own transformation with `scales::trans_new()`. `expand` For position scales, a vector of range expansion constants used to add some padding around the data to ensure that they are placed some distance away from the axes. Use the convenience function `expansion()` to generate the values for the `expand` argument. The defaults are to expand the scale by 5% on each side for continuous variables, and by 0.6 units on each side for discrete variables. `position` For position scales, The position of the axis. `left` or `right` for y axes, `top` or `bottom` for x axes. `super` The super class to use for the constructed scale
`low`	Colour for the low end of the gradient
`high`	Colour for the high end of the gradient
`space`	colour space in which to calculate gradient. Must be "Lab" - other values are deprecated.
`na.value`	Colour to use for missing values
`guide`	Type of legend. Use `"colourbar"` for continuous colour bar, or `"legend"` for discrete colour legend.
`aesthetics`	Character string or vector of character strings listing the name(s) of the aesthetic(s) that this scale works with. This can be useful, for example, to apply colour settings to the `colour` and `fill` aesthetics at the same time, via `aesthetics = c("colour", "fill")`.

Author(s)

Thierry Onkelinx, Oona Op de Weerdt, Nicole De Groof

redefine `ggplot2::scale_fill_gradient2()`

Description

Selects the colours depending on the current set theme.

Usage

scale_fill_gradient2(
  ...,
  low,
  high,
  mid,
  midpoint = 0,
  space = "Lab",
  guide = "colourbar",
  na.value = "grey50",
  aesthetics = "fill"
)
scale_fill_gradient2(
  ...,
  low,
  high,
  mid,
  midpoint = 0,
  space = "Lab",
  guide = "colourbar",
  na.value = "grey50",
  aesthetics = "fill"
)

Arguments

`...`	Arguments passed on to `continuous_scale` `scale_name` The name of the scale that should be used for error messages associated with this scale. `palette` A palette function that when called with a numeric vector with values between 0 and 1 returns the corresponding output values (e.g., `scales::area_pal()`). `name` The name of the scale. Used as the axis or legend title. If `waiver()`, the default, the name of the scale is taken from the first mapping used for that aesthetic. If `NULL`, the legend title will be omitted. `breaks` One of: `NULL` for no breaks `waiver()` for the default breaks computed by the transformation object A numeric vector of positions A function that takes the limits as input and returns breaks as output (e.g., a function returned by `scales::extended_breaks()`). Also accepts rlang lambda function notation. `minor_breaks` One of: `NULL` for no minor breaks `waiver()` for the default breaks (one minor break between each major break) A numeric vector of positions A function that given the limits returns a vector of minor breaks. Also accepts rlang lambda function notation. `n.breaks` An integer guiding the number of major breaks. The algorithm may choose a slightly different number to ensure nice break labels. Will only have an effect if `breaks = waiver()`. Use `NULL` to use the default number of breaks given by the transformation. `labels` One of: `NULL` for no labels `waiver()` for the default labels computed by the transformation object A character vector giving labels (must be same length as `breaks`) An expression vector (must be the same length as breaks). See ?plotmath for details. A function that takes the breaks as input and returns labels as output. Also accepts rlang lambda function notation. `limits` One of: `NULL` to use the default scale range A numeric vector of length two providing limits of the scale. Use `NA` to refer to the existing minimum or maximum A function that accepts the existing (automatic) limits and returns new limits. Also accepts rlang lambda function notation. Note that setting limits on positional scales will remove data outside of the limits. If the purpose is to zoom, use the limit argument in the coordinate system (see `coord_cartesian()`). `rescaler` A function used to scale the input values to the range [0, 1]. This is always `scales::rescale()`, except for diverging and n colour gradients (i.e., `scale_colour_gradient2()`, `scale_colour_gradientn()`). The `rescaler` is ignored by position scales, which always use `scales::rescale()`. Also accepts rlang lambda function notation. `oob` One of: Function that handles limits outside of the scale limits (out of bounds). Also accepts rlang lambda function notation. The default (`scales::censor()`) replaces out of bounds values with `NA`. `scales::squish()` for squishing out of bounds values into range. `scales::squish_infinite()` for squishing infinite values into range. `trans` For continuous scales, the name of a transformation object or the object itself. Built-in transformations include "asn", "atanh", "boxcox", "date", "exp", "hms", "identity", "log", "log10", "log1p", "log2", "logit", "modulus", "probability", "probit", "pseudo_log", "reciprocal", "reverse", "sqrt" and "time". A transformation object bundles together a transform, its inverse, and methods for generating breaks and labels. Transformation objects are defined in the scales package, and are called `⁠<name>_trans⁠` (e.g., `scales::boxcox_trans()`). You can create your own transformation with `scales::trans_new()`. `expand` For position scales, a vector of range expansion constants used to add some padding around the data to ensure that they are placed some distance away from the axes. Use the convenience function `expansion()` to generate the values for the `expand` argument. The defaults are to expand the scale by 5% on each side for continuous variables, and by 0.6 units on each side for discrete variables. `position` For position scales, The position of the axis. `left` or `right` for y axes, `top` or `bottom` for x axes. `super` The super class to use for the constructed scale
`low`	Colour for the low end of the gradient
`high`	Colour for the high end of the gradient
`mid`	colour for mid point
`midpoint`	The midpoint (in data value) of the diverging scale. Defaults to 0.
`space`	colour space in which to calculate gradient. Must be "Lab" - other values are deprecated.
`guide`	Type of legend. Use `"colourbar"` for continuous colour bar, or `"legend"` for discrete colour legend.
`na.value`	Colour to use for missing values
`aesthetics`	Character string or vector of character strings listing the name(s) of the aesthetic(s) that this scale works with. This can be useful, for example, to apply colour settings to the `colour` and `fill` aesthetics at the same time, via `aesthetics = c("colour", "fill")`.

Author(s)

Thierry Onkelinx, Oona Op de Weerdt, Nicole De Groof

Show a palette on a single row

Description

Show a palette on a single row

Usage

show_palette(colours)
show_palette(colours)

Arguments

colours

a vector of colours

Switch the default colour of all `ggplot2` `geoms`.

Description

Switch the default colour of all ggplot2 geoms.

Usage

switch_colour(new_colour = inbo_steun_blauw)
switch_colour(new_colour = inbo_steun_blauw)

Arguments

new_colour

The new default colour.

Examples

  switch_colour("black")
switch_colour("black")

Theme in compliance with the style guide of Elsevier journals

Description

This theme is based on http://cdn.elsevier.com/assets/pdf_file/0010/109963/Artwork.pdf

Usage

theme_elsevier(base_size = 7, base_family = "")
theme_elsevier(base_size = 7, base_family = "")

Arguments

`base_size`	base font size
`base_family`	base font type

Examples

  library(ggplot2)
  p <- ggplot(mtcars, aes(x = mpg, y = drat)) + geom_point()
  p.elsevier <- p + theme_elsevier()
library(ggplot2)
  p <- ggplot(mtcars, aes(x = mpg, y = drat)) + geom_point()
  p.elsevier <- p + theme_elsevier()

The theme in compliance with the INBO style guide version >= 2015.

Description

The theme in compliance with the INBO style guide version >= 2015.

Usage

theme_inbo(base_size = 12, base_family = "", transparent = FALSE)

theme_inbo2015(base_size = 12, base_family, transparent = FALSE)
theme_inbo(base_size = 12, base_family = "", transparent = FALSE)

theme_inbo2015(base_size = 12, base_family, transparent = FALSE)

Arguments

`base_size`	base font size, given in pts.
`base_family`	base font family
`transparent`	Make backgrounds transparent. `FALSE`: all backgrounds are white, `TRUE`: all backgrounds are transparent. You can pass a vector to transparent. In that case, it will check whether the values `"plot"`, `"panel"` and/or `"legend"` are present. The according items will be transparent. Transparent panel will use grey instead of white grid lines.

Author(s)

Thierry Onkelinx, Oona Op de Weerdt, Nicole De Groof

Examples

  library(ggplot2)
  p <- ggplot(mtcars, aes(x = mpg, y = drat)) + geom_point()
  p.inbo <- p + theme_inbo()
library(ggplot2)
  p <- ggplot(mtcars, aes(x = mpg, y = drat)) + geom_point()
  p.inbo <- p + theme_inbo()

a `ggplot2` theme which removes labels, ticks and titles from both axes.

Description

a ggplot2 theme which removes labels, ticks and titles from both axes.

Usage

theme_map()
theme_map()

Examples

  library(ggplot2)
  p <- ggplot(mtcars, aes(x = mpg, y = drat)) + geom_point()
  p.map <- p + theme_map()
library(ggplot2)
  p <- ggplot(mtcars, aes(x = mpg, y = drat)) + geom_point()
  p.map <- p + theme_map()

The theme for NARA reports.

Description

Deprecated. Use theme_inbo() instead.

Usage

theme_nara(base_size = 12, base_family = "")
theme_nara(base_size = 12, base_family = "")

Arguments

`base_size`	base font size, given in pts.
`base_family`	base font family

The theme in compliance with the Flanders style guide version >= 2015.

Description

The theme in compliance with the Flanders style guide version >= 2015.

Usage

theme_vlaanderen2015(base_size = 12, base_family = "", transparent = FALSE)
theme_vlaanderen2015(base_size = 12, base_family = "", transparent = FALSE)

Arguments

`base_size`	base font size, given in pts.
`base_family`	base font family
`transparent`	Make backgrounds transparent. `FALSE`: all backgrounds are white, `TRUE`: all backgrounds are transparent. You can pass a vector to transparent. In that case, it will check whether the values `"plot"`, `"panel"` and/or `"legend"` are present. The according items will be transparent. Transparent panel will use grey instead of white grid lines.

Author(s)

Thierry Onkelinx, Nicole De Groof

Examples

  library(ggplot2)
  p <- ggplot(mtcars, aes(x = mpg, y = drat)) + geom_point()
  p.vl <- p + theme_vlaanderen2015()
library(ggplot2)
  p <- ggplot(mtcars, aes(x = mpg, y = drat)) + geom_point()
  p.vl <- p + theme_vlaanderen2015()

A Colour Palette Ranging From a Dark Red over Medium Orange to Light Green.

Description

A Colour Palette Ranging From a Dark Red over Medium Orange to Light Green.

Usage

traffic_palette(n)
traffic_palette(n)

Arguments

`n`	The number of colours

Value

a vector of n hexadecimal values defining the colours.

Some colours for the corporate style of vlaanderen.be. Taken from level 1, and level 2 palette 7

Description

Colour according to the Flanders style guide as hexadecimal values.

vl_yellow
vl_darkyellow
vl_black
vl_grey1
vl_grey2
vl_grey3
vl_grey4
vl_grey5
vl_grey6
vl_grey7
vl_lightgreen
vl_darkgreen
vl_lightblue
vl_darkblue
vl_lightred
vl_darkred
vl_lightbrown
vl_darkbrown

Author(s)

Thierry Onkelinx

References

http://webstijlgids.vlaanderen.be/element/kleurgebruik

A colour pallet according the Flanders style guide version >= 2015.

Description

A colour pallet according the Flanders style guide version >= 2015.

Usage

vlaanderen_palette(n)
vlaanderen_palette(n)

Arguments

`n`	The number of colours

Value

a vector of n hexadecimal values defining the colours.

Author(s)

Thierry Onkelinx

References

http://webstijlgids.vlaanderen.be/element/kleurgebruik

Package 'INBOtheme'

Help Index

Calculate a distance matrix between colours for colour blind people

Description

Usage

Arguments

Calculate a distance matrix between colours

Description

Usage

Arguments

Demonstrate colours in a palette

Description

Usage

Arguments

See Also

Colour according to the INBO style guide version >= 2015

Description

Author(s)

See Also

A Colour Palette According the INBO Style Guide Version >= 2015.

Description

Usage

Arguments

Value

Author(s)

See Also

Deprecated functions

Description

Usage

Arguments

A Colour Palette for NARA reports.

Description

Usage

Arguments

Value

See Also

Order variables to maximise contrasts

Description

Usage

Arguments

Value

Palette for ordinal variables

Description

Usage

Arguments

Standard dimensions for the Elsevier style guide

Description

See Also

redefine ggplot2::scale_colour_discrete()

Description

Usage

Arguments

Author(s)

See Also

redefine ggplot2::scale_colour_gradient()

Description

Usage

Arguments

Author(s)

See Also

redefine ggplot2::scale_colour_gradient2()

Description

Usage

Arguments

Author(s)

See Also

redefine ggplot2::scale_colour_viridis_d()

Description

Usage

Arguments

Author(s)

See Also

redefine ggplot2::scale_fill_discrete()

Description

Usage

Arguments

Author(s)

See Also

redefine ggplot2::scale_fill_gradient()

Description

redefine `ggplot2::scale_colour_discrete()`

redefine `ggplot2::scale_colour_gradient()`

redefine `ggplot2::scale_colour_gradient2()`

redefine `ggplot2::scale_colour_viridis_d()`

redefine `ggplot2::scale_fill_discrete()`

redefine `ggplot2::scale_fill_gradient()`

redefine `ggplot2::scale_fill_gradient2()`

Switch the default colour of all `ggplot2` `geoms`.

a `ggplot2` theme which removes labels, ticks and titles from both axes.