pavo (version 0.5-6)

summary.tcs: Tetracolorspace avian visual model summary

Description

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

Usage

"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 quantum catch color data frame) or a vector containing identifications for the rows in the quantum catch color data frame (in which case summaries will be calculated for each group of points sharing the same identification). If by is left blank, the summary statistics are calculated accross all color points in the data.

...

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 pointsc.vol the total volume occupied by the pointscolspan.m the mean hue spancolspan.v the variance in hue spanmean.ra mean saturationmax.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

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