% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/trispace.R
\name{trispace}
\alias{trispace}
\title{Trichromatic colour space}
\usage{
trispace(vismodeldata)
}
\arguments{
\item{vismodeldata}{(required) quantum catch colour data. Can be either the result
from \code{\link[=vismodel]{vismodel()}} or independently calculated data (in the form of a data frame
with three columns named 's', 'm', 'l', representing a trichromatic viewer).}
}
\value{
A data frame of class \code{\link{colspace}} consisting of the following columns:
\itemize{
\item \code{s}, \code{m}, \code{l}: the quantum catch data used to calculate
the remaining variables.
\item \code{x}, \code{y}: cartesian coordinates for the points in the
Maxwell triangle.
\item \code{h.theta}: angle theta, in radians, determining the hue of the colour.
\item \code{r.vec}: the r vector (saturation, distance from the center).
}
}
\description{
Calculates coordinates and colourimetric variables that represent reflectance spectra
in a trichromatic chromaticity space.
}
\examples{
data(flowers)
vis.flowers <- vismodel(flowers, visual = "apis", achromatic = "l")
tri.flowers <- colspace(vis.flowers, space = "tri")

}
\references{
Maxwell JC. (1970). On color vision. In: Macadam, D. L. (ed)
Sources of Color Science. Cambridge, MIT Press, 1872 - 1873.

Kelber A, Vorobyev M, Osorio D. (2003). Animal colour vision -
behavioural tests and physiological concepts. Biological Reviews, 78,
81 - 118.

MacLeod DIA, Boynton RM. (1979). Chromaticity diagram showing
cone excitation by stimuli of equal luminance. Journal of the Optical
Society of America, 69, 1183-1186.
}
\author{
Thomas E. White \email{thomas.white026@gmail.com}
}
\keyword{internal}
