colourvision-package {colourvision}

Colour Vision Models

Description

Colour vision models, colour spaces and colour thresholds. Provides flexibility to build user-defined colour vision models for n number of photoreceptor types. Also includes Vorobyev & Osorio (1998) Receptor Noise Limited models <doi:10.1098/rspb.1998.0302>, Chittka (1992) colour hexagon <doi:10.1007/BF00199331>, and Endler & Mielke (2005) model <doi:10.1111/j.1095-8312.2005.00540.x>. Models have been extended to accept any number of photoreceptor types.

Details

The DESCRIPTION file:

Package:	colourvision
Type:	Package
Title:	Colour Vision Models
Version:	2.0.4
Date:	2021-07-31
Author:	Felipe M. Gawryszewski
Maintainer:	Felipe Malheiros Gawrysewski <[e-mail]>
Description:	Colour vision models, colour spaces and colour thresholds. Provides flexibility to build user-defined colour vision models for n number of photoreceptor types. Also includes Vorobyev & Osorio (1998) Receptor Noise Limited models <doi:10.1098/rspb.1998.0302>, Chittka (1992) colour hexagon <doi:10.1007/BF00199331>, and Endler & Mielke (2005) model <doi:10.1111/j.1095-8312.2005.00540.x>. Models have been extended to accept any number of photoreceptor types.
License:	GPL-2
Imports:	graphics, stats, utils, Matrix
Suggests:	testthat, knitr, rmarkdown, corrplot, rgl
VignetteBuilder:	knitr

Index of help topics:

CTTKhexagon             Chittka (1992) colour hexagon
CTTKhexagon3D           Chittka (1992) colour space for tetrachromatic
                        animals.
CTTKmodel               Chittka (1992) colour vision model
D65                     CIE Standard Illuminant D65 in quantum flux
                        (umol/m2/s)
EMline                  Endler and Mielke (2005) 1-D colour space
EMmodel                 Endler and Mielke (2005) colour vision model
EMtetrahedron           Endler and Mielke (2005) tetrahedron colour
                        space
EMtriangle              Endler and Mielke (2005) triangle colour space
GENmodel                N-dimensional generic colour vision model
GENplot                 Generic model colour space 2D and 1D plot
GENplot3d               Generic model colour space 3D plot
Q                       Total photon capture
Qr                      Photoreceptor relative quantum catch
RNLmodel                Receptor Noise Limited Models (Vorobyev &
                        Osorio 1998)
RNLplot                 Receptor noise limited model 2D and 1D plot
RNLplot3d               Receptor noise limited model 3D plot
RNLthres                Colour thresholds based on the Receptor Noise
                        Limited Model (Vorobyev & Osorio 1998).
Rb                      Brazilian savannah background reflectance
                        spectrum.
bee                     Honeybee photoreceptors
colour_space            N-dimensional colour spaces
colourvision-package    Colour Vision Models
deltaS                  Chromaticity distances
energytoflux            Irradiance from energy to quantum units.
logistic                Logistic curve
noise_e                 Receptor noise
photor                  Photoreceptor sensitivity spectra.
plot.colourvision       Plot colour vision models into chromaticity
                        diagrams
plot3d.colourvision     Plot colour vision models into 3D chromaticity
                        diagrams.
radarplot               Radar plot
spec.denoise            Smooth function for reflectance spectra.

Author(s)

Felipe M. Gawryszewski

Maintainer: Felipe Malheiros Gawrysewski <[e-mail]>

References

Gawryszewski, F.M. 2018. Colour vision models: Some simulations, a general n-dimensional model, and the colourvision R package. Ecology and Evolution, 10.1002/ece3.4288.

Examples

##Honeybee photoreceptor sensitivity curves
data("bee")

##Grey background:
## with 10 percent. reflectance from 300 to 700nm:
Rb <- data.frame(300:700, rep(10, length(300:700)))

## Read CIE D65 standard illuminant already converted to quantum flux:
data("D65")

##Reflectance data
## with a sigmoid spectrum and midpoint at 500nm and 550 nm
R1<-logistic(x=seq(300,700,1), x0=500, L=50, k=0.04)
R2<-logistic(x=seq(300,700,1), x0=550, L=50, k=0.04)
R<-cbind(R1, R2[,2])

## Run colour vision model:
model<-CTTKmodel(photo="tri", R=R, I=D65, Rb=Rb,
C=bee)

##plot data in the colour space
plot(model)