colByCategory: colByCategory

View source: R/color.R

colByCategoryR Documentation

colByCategory

Description

Given a vector of categorical values, assign a color to each one bases on its category

Usage

colByCategory(categories, colors)

Arguments

categories

A vector of categories. Will be transformed into a factor if it's not one (if characters, integers, etc...)

colors

(color vector, possibly named) The colors to to use for the different categories. If "auto", a rainbow palette will be used. (defaults to "auto")

Details

The vector of values will be first transformed into a factor (if it's not already a factor) and then colors will be selected from the palette in the order defined by the factor levels. If more colors than the ones available in the palette are needed, they will be reused. If the color vector is named using the factor levels and all levels are included, the link bewteen levels and colors will be honored. If the color palette is set to "auto", it will create a palette using "rainbow".

Value

A vector of colors of the same length as value

See Also

kpAddColorRect, colByValue

Examples


colByCategory(c("A", "A", "C", "A", "C", "B"))
#The order of the colors is defined by the order of the factor, not the "natural order" of the elements
colByCategory(c("A", "A", "C", "A", "C", "B"), colors=c("red", "green", "blue"))
#integer categories plus reuse of colors
colByCategory(categories=c(3,3,1,2,1,4,2,3,2,1), colors=c("red", "green", "blue"))


bernatgel/karyoploteR documentation built on Feb. 1, 2024, 11:48 p.m.