pavo (version 0.3-1)

summary.tcs: Tetracolorspace avian visual model summary

Description

Calculates characteristics of a cloud of points (spectra) in avian tetrahedral color space

Usage

## S3 method for class 'tcs':
summary(object, by = NULL, ...)

Arguments

object

(required) Results of tcs or Can be either the result from vismodel or independently calculated data (in the form of a data frame with four columns, representing the avian cones).

by

either a single value specifying the range of color points for which summary colorspace variables should be calculated (for example, by = 3 indicates summary will be calculated for groups of 3 consecutive color points (rows) in the qu

...

class consistency (ignored)

Value

• a data.frame containing summary statistics with groups of points in rows and the following variables in columns:

  centroid.u, .s, .m, .l the centroids of usml coordinates of points

  c.vol the total volume occupied by the points

  colspan.m the mean hue span

  colspan.v the variance in hue span

  mean.ra mean saturation

  max.ra maximum saturation achieved by the group of points

References

Stoddard, M. C., & Prum, R. O. (2008). Evolution of avian plumage color in a tetrahedral color space: A phylogenetic analysis of new world buntings. The American Naturalist, 171(6), 755-776.

Endler, J. A., & Mielke, P. (2005). Comparing entire colour patterns as birds see them. Biological Journal Of The Linnean Society, 86(4), 405-431.

Examples

data(sicalis)
vis.sicalis <- vismodel(sicalis, visual='avg.uv')
tcs.sicalis <- tcs(vis.sicalis)
summary(tcs.sicalis, by=rep(c('C','T','B'),7))