colByCategory {karyoploteR} | R 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"))

[Package karyoploteR version 1.14.1 Index]