Package 'colourvalues' reference manual

Title:	Assigns Colours to Values
Description:	Maps one of the viridis colour palettes, or a user-specified palette to values. Viridis colour maps are created by Stéfan van der Walt and Nathaniel Smith, and were set as the default palette for the 'Python' 'Matplotlib' library <https://matplotlib.org/>. Other palettes available in this library have been derived from 'RColorBrewer' <https://CRAN.R-project.org/package=RColorBrewer> and 'colorspace' <https://CRAN.R-project.org/package=colorspace> packages.
Authors:	David Cooley [aut, cre]
Maintainer:	David Cooley <[email protected]>
License:	GPL-3
Version:	0.3.10
Built:	2024-11-11 05:00:17 UTC
Source:	https://github.com/symbolixau/colourvalues

Blue2green

Description

Data Frame of the blue2green palette

Usage

blue2green()
blue2green()

Blue2red

Description

Data Frame of the blue2red palette

Usage

blue2red()
blue2red()

Blue2yellow

Description

Data Frame of the blue2yellow palette

Usage

blue2yellow()
blue2yellow()

Blues

Description

Data Frame of the blues palette

Usage

blues()
blues()

Brbg

Description

Data Frame of the brbg palette

Usage

brbg()
brbg()

Bugn

Description

Data Frame of the bugn palette

Usage

bugn()
bugn()

Bupu

Description

Data Frame of the bupu palette

Usage

bupu()
bupu()

Cividis

Description

Data frame of the cividis palette

Usage

cividis()
cividis()

Cm

Description

Data Frame of the cm palette

Usage

cm()
cm()

Colour Palettes

Description

List the available colour palettes.

Usage

colour_palettes(colours = NULL)

color_palettes(colours = NULL)
colour_palettes(colours = NULL)

color_palettes(colours = NULL)

Arguments

colours

vector of source colour palettes to return, one or many of "viridis","rcolorbrewer","grdevices","colorspace","colorramp". NULL will reutrn all palettes.

Details

The palettes avaialble in colourvalues have been derived from those avaialble in the libraries

viridis
RColorBrewer
grDevices
colorspaces
colorRamp

Examples

colour_palettes()
colour_palettes( "viridis" )
colour_palettes( colours = c("rcolorbrewer","grdevices") )

colour_palettes()
colour_palettes( "viridis" )
colour_palettes( colours = c("rcolorbrewer","grdevices") )

Colour Values

Description

maps colours to values, returning a vector of hex strings

Usage

colour_values(
  x,
  palette = "viridis",
  alpha = 255,
  na_colour = "#808080FF",
  include_alpha = TRUE,
  summary = FALSE,
  n_summaries = 0,
  format = TRUE,
  digits = 2
)

color_values(
  x,
  palette = "viridis",
  alpha = 255,
  na_colour = "#808080FF",
  include_alpha = TRUE,
  summary = FALSE,
  n_summaries = 0,
  format = TRUE,
  digits = 2
)

## S3 method for class 'character'
colour_values_to_hex(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'logical'
colour_values_to_hex(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'factor'
colour_values_to_hex(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'Date'
colour_values_to_hex(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'POSIXct'
colour_values_to_hex(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'POSIXlt'
colour_values_to_hex(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)
colour_values(
  x,
  palette = "viridis",
  alpha = 255,
  na_colour = "#808080FF",
  include_alpha = TRUE,
  summary = FALSE,
  n_summaries = 0,
  format = TRUE,
  digits = 2
)

color_values(
  x,
  palette = "viridis",
  alpha = 255,
  na_colour = "#808080FF",
  include_alpha = TRUE,
  summary = FALSE,
  n_summaries = 0,
  format = TRUE,
  digits = 2
)

## S3 method for class 'character'
colour_values_to_hex(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'logical'
colour_values_to_hex(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'factor'
colour_values_to_hex(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'Date'
colour_values_to_hex(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'POSIXct'
colour_values_to_hex(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'POSIXlt'
colour_values_to_hex(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

Arguments

`x`	vector of values to map to a colour
`palette`	colour palette. See details and examples
`alpha`	optional. Single value in [0,255] applied to all colours, or a decimal in [0, 1) (to indicate a percentage, noting 1 is excluded), or a vector of numeric values the same length as `x`. The numeric vector will be scaled into the range [0,255]. If a matrix palette is supplied this argument is ignored.
`na_colour`	hex string colour to use for NA values in the form `#RRGGBBAA`.
`include_alpha`	logical indicating if the returned hex or matrix should include the alpha values. Defaults to `TRUE`.
`summary`	logical indicating if a summary of the colours should be returned as well as the full colour mapping. This will be the unique elements of `x` mapped to the colour.
`n_summaries`	positive integer. If supplied a summary colour palette will be returned in a list, containing `n_summaries` equally spaced values of `x` in the range `[min(x),max(x)]`, and their associated colours. If a non-numeric `x` is used this value is ignored
`format`	logical indicating if the summary values should be formatted.
`digits`	number of decimal places to show in the summary

Details

The palette can either be

String - use colour_palettes() to view available palettes
Matrix - At least 5 rows, and 3 (or 4) columns representing the red, green and blue (and alpha) values

The matrix palette requires 5 rows because the colours are interpolated using a cubic b-spline. This method requires 5 values.

Examples


## in-built palettes
colour_values(x = 1:5) ## default is "viridis"
colour_values(x = 1:5, palette = "inferno")
colour_values(x = 1:5, palette = "plasma")
colour_values(x = 1:5, palette = "magma")
colour_values(x = 1:5, palette = "cividis")
colour_values(x = 1:5, palette = "rainbow")

## matrix palette
n <- 100
m <- grDevices::colorRamp(c("red", "green"))( (1:n)/n )
df <- data.frame(a = 10, x = 1:n)
df$col <- colour_values(df$x, palette = m)
barplot(height = df$a, col = df$col, border = NA, space = 0)

## with an alpha column on the palette
n <- 100
m <- grDevices::colorRamp(c("red", "green"))( (1:n)/n )
m <- cbind(m, seq(0, 255, length.out = 100))
df <- data.frame(a = 10, x = 1:n)
df$col <- colour_values(df$x, palette = m)
barplot(height = df$a, col = df$col, border = NA, space = 0)

## single alpha value for all colours
df <- data.frame(a = 10, x = 1:255)
df$col <- colour_values(df$x, alpha = 50)
barplot(height = df$a, col = df$col, border = NA, space = 0)

## vector of alpha values
df <- data.frame(a = 10, x = 1:300, y = rep(c(1:50, 50:1), 3) )
df$col <- colour_values(df$x, alpha = df$y)
barplot(height = df$a, col = df$col, border = NA, space = 0)

## returning a summary palette
colour_values(-10:10, n_summaries = 5)

colour_values(x = runif(20, 0, 1), n_summaries = 3, digits = 2)
colour_values(x = runif(20, 0, 1), n_summaries = 3, digits = 10)

## Formatting output
## default is TRUE
colour_values(
  x = seq(as.Date("2023-01-01"), as.Date("2023-01-31"), by = 1)
  , n_summaries = 5
)
colour_values(
  x = seq(as.Date("2023-01-01"), as.Date("2023-01-31"), by = 1)
  , n_summaries = 5
  , format = FALSE
)

## in-built palettes
colour_values(x = 1:5) ## default is "viridis"
colour_values(x = 1:5, palette = "inferno")
colour_values(x = 1:5, palette = "plasma")
colour_values(x = 1:5, palette = "magma")
colour_values(x = 1:5, palette = "cividis")
colour_values(x = 1:5, palette = "rainbow")

## matrix palette
n <- 100
m <- grDevices::colorRamp(c("red", "green"))( (1:n)/n )
df <- data.frame(a = 10, x = 1:n)
df$col <- colour_values(df$x, palette = m)
barplot(height = df$a, col = df$col, border = NA, space = 0)

## with an alpha column on the palette
n <- 100
m <- grDevices::colorRamp(c("red", "green"))( (1:n)/n )
m <- cbind(m, seq(0, 255, length.out = 100))
df <- data.frame(a = 10, x = 1:n)
df$col <- colour_values(df$x, palette = m)
barplot(height = df$a, col = df$col, border = NA, space = 0)

## single alpha value for all colours
df <- data.frame(a = 10, x = 1:255)
df$col <- colour_values(df$x, alpha = 50)
barplot(height = df$a, col = df$col, border = NA, space = 0)

## vector of alpha values
df <- data.frame(a = 10, x = 1:300, y = rep(c(1:50, 50:1), 3) )
df$col <- colour_values(df$x, alpha = df$y)
barplot(height = df$a, col = df$col, border = NA, space = 0)

## returning a summary palette
colour_values(-10:10, n_summaries = 5)

colour_values(x = runif(20, 0, 1), n_summaries = 3, digits = 2)
colour_values(x = runif(20, 0, 1), n_summaries = 3, digits = 10)

## Formatting output
## default is TRUE
colour_values(
  x = seq(as.Date("2023-01-01"), as.Date("2023-01-31"), by = 1)
  , n_summaries = 5
)
colour_values(
  x = seq(as.Date("2023-01-01"), as.Date("2023-01-31"), by = 1)
  , n_summaries = 5
  , format = FALSE
)

Colour Values RGB

Description

Maps colours to values, returning a matrix of RGB(A) values

Usage

colour_values_rgb(
  x,
  palette = "viridis",
  alpha = 255,
  na_colour = "#808080FF",
  include_alpha = TRUE,
  summary = FALSE,
  n_summaries = 0,
  format = TRUE,
  digits = 2
)

color_values_rgb(
  x,
  palette = "viridis",
  alpha = 255,
  na_colour = "#808080FF",
  include_alpha = TRUE,
  summary = FALSE,
  n_summaries = 0,
  format = TRUE,
  digits = 2
)

## S3 method for class 'character'
colour_values_to_rgb(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'logical'
colour_values_to_rgb(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'factor'
colour_values_to_rgb(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'Date'
colour_values_to_rgb(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'POSIXct'
colour_values_to_rgb(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'POSIXlt'
colour_values_to_rgb(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)
colour_values_rgb(
  x,
  palette = "viridis",
  alpha = 255,
  na_colour = "#808080FF",
  include_alpha = TRUE,
  summary = FALSE,
  n_summaries = 0,
  format = TRUE,
  digits = 2
)

color_values_rgb(
  x,
  palette = "viridis",
  alpha = 255,
  na_colour = "#808080FF",
  include_alpha = TRUE,
  summary = FALSE,
  n_summaries = 0,
  format = TRUE,
  digits = 2
)

## S3 method for class 'character'
colour_values_to_rgb(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'logical'
colour_values_to_rgb(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'factor'
colour_values_to_rgb(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'Date'
colour_values_to_rgb(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'POSIXct'
colour_values_to_rgb(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

## S3 method for class 'POSIXlt'
colour_values_to_rgb(
  x,
  palette,
  alpha,
  na_colour,
  include_alpha,
  summary,
  n_summaries,
  format,
  digits
)

Arguments

`x`	vector of values to map to a colour
`palette`	colour palette. See details and examples
`alpha`	optional. Single value in [0,255] applied to all colours, or a decimal in [0, 1) (to indicate a percentage, noting 1 is excluded), or a vector of numeric values the same length as `x`. The numeric vector will be scaled into the range [0,255]. If a matrix palette is supplied this argument is ignored.
`na_colour`	hex string colour to use for NA values in the form `#RRGGBBAA`.
`include_alpha`	logical indicating if the returned hex or matrix should include the alpha values. Defaults to `TRUE`.
`summary`	logical indicating if a summary of the colours should be returned as well as the full colour mapping. This will be the unique elements of `x` mapped to the colour.
`n_summaries`	positive integer. If supplied a summary colour palette will be returned in a list, containing `n_summaries` equally spaced values of `x` in the range `[min(x),max(x)]`, and their associated colours. If a non-numeric `x` is used this value is ignored
`format`	logical indicating if the summary values should be formatted.
`digits`	number of decimal places to show in the summary

Details

The palette can either be

String - use colour_palettes() to view available palettes
Matrix - At least 5 rows, and 3 (or 4) columns representing the red, green and blue (and alpha) values

The matrix palette requires 5 rows because the colours are interpolated using a cubic b-spline. This method requires 5 values.

Examples


colour_values_rgb(1:5)
colour_values_rgb(1:5, include_alpha = FALSE)
colour_values_rgb(-25:25, n_summaries = 5)


colour_values_rgb(1:5)
colour_values_rgb(1:5, include_alpha = FALSE)
colour_values_rgb(-25:25, n_summaries = 5)

Convert Colour

Description

Converts colours between RRGGBBAA and hex strings, in both directions.

Usage

convert_colour(x)

convert_colours(x)

convert_color(x)

convert_colors(x)
convert_colour(x)

convert_colours(x)

convert_color(x)

convert_colors(x)

Arguments

`x`	character vector of hex strings, or numeric matrix of RRGGBBAA values

Details

If a combination of hex strings with and without alpha values are supplied, those without are assumed to have an alpha value of FF and will be returned in the RRGGBBAA matrix

Examples


convert_colour(c("#FFAA00"))
convert_colour(c("#FFAA00","#FF00AAFF"))

convert_colour(matrix(c(255,170,0),ncol = 3))
convert_colour(matrix(c(255,170,0,255),ncol = 4))


convert_colour(c("#FFAA00"))
convert_colour(c("#FFAA00","#FF00AAFF"))

convert_colour(matrix(c(255,170,0),ncol = 3))
convert_colour(matrix(c(255,170,0,255),ncol = 4))

Cyan2yellow

Description

Data Frame of the cyan2yellow palette

Usage

cyan2yellow()
cyan2yellow()

Diverge_hcl

Description

Data Frame of the diverge_hcl palette

Usage

diverge_hcl()
diverge_hcl()

Diverge_hsv

Description

Data Frame of the diverge_hsv palette

Usage

diverge_hsv()
diverge_hsv()

Get Palette

Description

retrieves one of the available palettes

Usage

get_palette(palette, rgb = TRUE)
get_palette(palette, rgb = TRUE)

Arguments

`palette`	one of the available paletes. See colour_palettes
`rgb`	logical indicating if the palette should be returned as an RGB matrix `TRUE`, or a vector of hex strings `FALSE`

Value

3 column matrix if rgb = TRUE, otherwise a 256-length vector.

Examples


get_palette( "viridis" )
get_palette( "rainbow" )

get_palette( "viridis" )
get_palette( "rainbow" )

Gnbu

Description

Data Frame of the gnbu palette

Usage

gnbu()
gnbu()

Green2red

Description

Data Frame of the green2red palette

Usage

green2red()
green2red()

Greens

Description

Data Frame of the greens palette

Usage

greens()
greens()

Greys

Description

Data Frame of the greys palette

Usage

greys()
greys()

Heat

Description

Data Frame of the heat palette

Usage

heat()
heat()

Heat_hcl

Description

Data Frame of the heat_hcl palette

Usage

heat_hcl()
heat_hcl()

Inferno

Description

Data frame of the inferno palette

Usage

inferno()
inferno()

Magenta2green

Description

Data Frame of the magenta2green palette

Usage

magenta2green()
magenta2green()

Magma

Description

Data frame of the magma palette

Usage

magma()
magma()

Matlab_like

Description

Data Frame of the matlab_like palette

Usage

matlab_like()
matlab_like()

Matlab_like2

Description

Data Frame of the matlab_like2 palette

Usage

matlab_like2()
matlab_like2()

Oranges

Description

Data Frame of the oranges palette

Usage

oranges()
oranges()

Orrd

Description

Data Frame of the orrd palette

Usage

orrd()
orrd()

Piyg

Description

Data Frame of the piyg palette

Usage

piyg()
piyg()

Plasma

Description

Data frame of the plasma palette

Usage

plasma()
plasma()

Prgn

Description

Data Frame of the prgn palette

Usage

prgn()
prgn()

Pubu

Description

Data Frame of the pubu palette

Usage

pubu()
pubu()

Pubugn

Description

Data Frame of the pubugn palette

Usage

pubugn()
pubugn()

Puor

Description

Data Frame of the puor palette

Usage

puor()
puor()

Purd

Description

Data Frame of the purd palette

Usage

purd()
purd()

Purples

Description

Data Frame of the purples palette

Usage

purples()
purples()

Rainbow

Description

Data Frame of the rainbow palette

Usage

rainbow()
rainbow()

Rainbow_hcl

Description

Data Frame of the rainbow_hcl palette

Usage

rainbow_hcl()
rainbow_hcl()

Rdbu

Description

Data Frame of the rdbu palette

Usage

rdbu()
rdbu()

Rdgy

Description

Data Frame of the rdgy palette

Usage

rdgy()
rdgy()

Rdpu

Description

Data Frame of the rdpu palette

Usage

rdpu()
rdpu()

Rdylbu

Description

Data Frame of the rdylbu palette

Usage

rdylbu()
rdylbu()

Rdylgn

Description

Data Frame of the rdylgn palette

Usage

rdylgn()
rdylgn()

Reds

Description

Data Frame of the reds palette

Usage

reds()
reds()

Sequential_hcl

Description

Data Frame of the sequential_hcl palette

Usage

sequential_hcl()
sequential_hcl()

Show Colours

Description

Plots all the selected colours. See colour_palettes for avaialble colours.

Usage

show_colours(colours = colour_palettes())
show_colours(colours = colour_palettes())

Arguments

colours

vector of colour palettes

Examples


## view all the colour palettes
show_colours()

## view a selection of colour palettes
show_colours( colours = colour_palettes( c("viridis", "grdevices") ) )



## view all the colour palettes
show_colours()

## view a selection of colour palettes
show_colours( colours = colour_palettes( c("viridis", "grdevices") ) )

Spectral

Description

Data Frame of the spectral palette

Usage

spectral()
spectral()

Terrain

Description

Data frame of the terrain palette

Usage

terrain()
terrain()

Terrain_hcl

Description

Data Frame of the terrain_hcl palette

Usage

terrain_hcl()
terrain_hcl()

Topo

Description

Data Frame of the topo palette

Usage

topo()
topo()

Viridis

Description

Data frame of the viridis palette

Usage

viridis()
viridis()

Ygobb

Description

Data Frame of the ygobb palette

Usage

ygobb()
ygobb()

Ylgn

Description

Data Frame of the ylgn palette

Usage

ylgn()
ylgn()

Ylgnbu

Description

Data Frame of the ylgnbu palette

Usage

ylgnbu()
ylgnbu()

Ylorbr

Description

Data Frame of the ylorbr palette

Usage

ylorbr()
ylorbr()

Ylorrd

Description

Data Frame of the ylorrd palette

Usage

ylorrd()
ylorrd()

Package 'colourvalues'

Help Index

Blue2green

Description

Usage

Blue2red

Description

Usage

Blue2yellow

Description

Usage

Blues

Description

Usage

Brbg

Description

Usage

Bugn

Description

Usage

Bupu

Description

Usage

Cividis

Description

Usage

Cm

Description

Usage

Colour Palettes

Description

Usage

Arguments

Details

Examples

Colour Values

Description

Usage

Arguments

Details

See Also

Examples

Colour Values RGB

Description

Usage

Arguments

Details

See Also

Examples

Convert Colour

Description

Usage

Arguments

Details

Examples

Cyan2yellow

Description

Usage

Diverge_hcl

Description

Usage

Diverge_hsv

Description

Usage

Get Palette

Description

Usage

Arguments

Value

Examples

Gnbu

Description

Usage

Green2red

Description

Usage

Greens

Description

Usage

Greys