Skip to contents

Builds a named character vector mapping trajectory group keys to colours. The colour scheme adapts to how many identity (what) and temporal context (when, such as session or trial) levels the aniframe's grouping columns (anicore::get_keys()) have:

Usage

palette_animovement(data, palette = "Dark 3", single_hue = "#3A6FB0")

Arguments

data

An aniframe.

palette

Name of a qualitative palette accepted by grDevices::hcl.colors(). Default "Dark 3".

single_hue

Colour used when neither what nor when has more than one level.

Value

A named character vector of hex colours.

Details

  • single (one of each, or none): a single hue.

  • what (multiple what, one when): one qualitative hue per what level.

  • when (one what, multiple when): one qualitative hue per when level.

  • matrix (multiple of both): one hue per what level, then a lighter-to-darker shade of that hue per when level.

Names of the returned vector match the group keys returned by the internal grouping logic — the redundant axis is dropped when only one side varies.

Examples

af <- anicore::example_anipoint(n_obs = 10, n_individuals = 2, n_keypoints = 1)
palette_animovement(af)
#> 1 | centroid 2 | centroid 
#>    "#E16A86"    "#00AD9A"