colors3d: Map values to a 3D legend in RGB colorspace.

View source: R/functions.R

colors3dR Documentation

Map values to a 3D legend in RGB colorspace.

Description

This function returns a color value for each row of the 3-column dataset supplied, by transforming the input data and using it as RGB values.

Usage

colors3d(data, trans = "none", order = 1, inversion = 1, opacity = NULL)

Arguments

data

Matrix or data frame with 3 numeric columns.

trans

Either "none" (defaut, histogram is rescaled) or "rank" (histogram is flattened).

order

Integer from 1 to 6, each denoting a unique permutation of variables-to-color band mapping. Under the default value of 1, the three variables in 'data' are respectively mapped onto the R, G, and B bands of colorspace.

inversion

Integer from 1 to 8, each denoting a unique combination of variables to reverse before mapping. Under the default value of 1, all three variables are mapped with positive values at the high end of the color band. Together with the 'order' parameter, this allows all possible 48 unique mappings of a given set of variables onto 3D colorspace.

opacity

Not currently used.

Value

Character vector of colors.

Examples

d <- expand.grid(x = 1:49, y = 1:49)
d$z <- cos(sqrt((d$x-25)^2 + (d$y-25)^2))
plot(d[, 1:2], col = colors3d(d), pch = 15, cex = 2)

plot(d[, 1:2], col = colors3d(d, order = 2, inversion = 2), pch = 15, cex = 2)

matthewkling/colormap documentation built on Nov. 4, 2023, 10:44 p.m.