iwanthue: Generate a colour palette by k-means clustering of CIE Lab...

In hues: Distinct Colour Palettes Based on 'iwanthue'

Description

Generate a palette of distinct colours through k-means clustering of CIE Lab colour space.

Usage

iwanthue(
  n,
  hmin = 0,
  hmax = 360,
  cmin = 0,
  cmax = 180,
  lmin = 0,
  lmax = 100,
  plot = FALSE,
  random = FALSE
)

Arguments

n	Numeric. The number of colours to generate.
hmin	Numeric, in the range [0, 360]. The lower limit of the hue range to be clustered.
hmax	Numeric, in the range [0, 360]. The upper limit of the hue range to be clustered.
cmin	Numeric, in the range [0, 180]. The lower limit of the chroma range to be clustered.
cmax	Numeric, in the range [0, 180]. The upper limit of the chroma range to be clustered.
lmin	Numeric, in the range [0, 100]. The lower limit of the luminance range to be clustered.
lmax	Numeric, in the range [0, 100]. The upper limit of the luminance range to be clustered.
plot	Logical. Should the colour swatches be plotted (using swatch())?
random	Logical. If TRUE, clustering will be determined by the existing RNG state. If FALSE, the seed will be set to 1 for clustering, and on exit, the function will restore the pre-existing RNG state.

Details

Note that iwanthue currently doesn't support hmin greater than hmax (which should be allowed, since hue is circular).

Value

A vector of n colours (as hexadecimal strings), representing centers of clusters determined through k-means clustering of the CIE Lab colour space delimited by hmin, hmax, cmin, cmax, lmin and lmax.

References

• Examples follow those presented at iwanthue - colors for data scientists

• iwanthue on GitHub

See Also

swatch

Examples

iwanthue(5)
iwanthue(5, plot=TRUE)
iwanthue(5, 0, 240, 0, 24, 0, 100, plot=TRUE)    # shades
iwanthue(5, 0, 360, 0, 54, 67, 100, plot=TRUE)   # pastel
iwanthue(5, 0, 360, 54, 180, 27, 67, plot=TRUE)  # pimp
iwanthue(5, 0, 360, 36, 180, 13, 73, plot=TRUE)  # intense
iwanthue(3, 0, 300, 60, 180, 73, 100, plot=TRUE) # fluoro
iwanthue(3, 220, 260, 12, 150, 0, 53, plot=TRUE) # blue ocean

Example output

[1] "#503F44" "#964FB8" "#97B2B7" "#94BF58" "#C6624D"
[1] "#503F44" "#964FB8" "#97B2B7" "#94BF58" "#C6624D"
[1] "#C5CEC3" "#7A8177" "#2D4438" "#423122" "#020202"
[1] "#A7C8DA" "#C0D098" "#D9AFD5" "#DBBDA9" "#8BD7C1"
[1] "#9A40D2" "#C84784" "#6B6FC7" "#C55A37" "#6A9C36"
[1] "#BD623A" "#8E41C6" "#6E9A48" "#6977B8" "#BA4C7E"
[1] "#E3CF56" "#68DCD5" "#87E663"
[1] "#456D92" "#233C5D" "#3664BC"

hues documentation built on Dec. 2, 2019, 1:11 a.m.