Learn R Programming

⚠️There's a newer version (2.9.0) of this package.Take me there.

pavo

=======

An R package for the spectral and spatial analysis of color patterns

Currently maintained by Rafael Maia, Thomas White, and Hugo Gruson.

About

pavo is an R package developed with the goal of establishing a flexible and integrated workflow for working with spectral and spatial colour data. It includes functions that take advantage of new data classes to work seamlessly from importing raw spectra and images, to visualisation and analysis. It provides flexible ways to input spectral data from a variety of equipment manufacturers, process these data, extract variables, and produce publication-quality figures.

pavo was written with the following workflow in mind:

  • Organise data by importing and processing spectra and images (e.g., to remove noise, negative values, smooth curves, etc.).
  • Analyse the resulting files, using spectral analyses of shape (hue, saturation, brightness), visual models based on perceptual data, and/or spatial adjacency and boundary strength analyses.
  • Visualise the output, with multiple options provided for exploration, presentation, and analysis.

Need more information, or help with the package?

Citing pavo

The manuscript describing the current iteration of the package has been published and are free to access:

Maia R., Gruson H., Endler J.A., and White T.E. 2019 pavo 2: New tools for the spectral and spatial analysis of colour in R. Methods in Ecology and Evolution, 10(7):1097‑107.

Install

This is the development page for pavo. The stable release is available from CRAN. Simply use install.packages("pavo") to install.

If you want to install the bleeding edge version of pavo, you can:

# install.packages("remotes")
remotes::install_github("rmaia/pavo")
  • download files from GitHub and install using $R CMD INSTALL or, from within R:
install.packages(path, type = "source", repos = NULL)

Copy Link

Version

Install

install.packages('pavo')

Monthly Downloads

898

Version

2.3.0

License

GPL (>= 2)

Issues

Pull Requests

Stars

Forks

Maintainer

Rafael Maia

Last Published

December 11th, 2019

Functions in pavo (2.3.0)

coldist2mat

Convert coldist to distance matrix
explorespec

Plot spectral curves
diplot

Plot a dichromat segment
dispace

Dichromatic colour space
flowers

Reflectance spectra from a suite of native Australian flowers, collected around Cairns, Queensland.
img_conversion

Convert images between class rimg and cimg or magick-image
colspace

Model spectra in a colorspace
irrad2flux

Converts between irradiance and photon (quantum) flux
is.colspace

Test if object is of class 'colspace'
classify

Identify colour classes in an image for adjacency analyses
coc

Color opponent coding model
bootcoldist

Bootstrap colour distance confidence intervals
parse_procspec

Import ProcSpec spectra file
is.vismodel

Test if object is of class 'vismodel'
legendtetra

Add legend to a static tetrahedral colourspace
sensdata

Retrieve or plot in-built spectral sensitivity data
jndrot

segspace

Segment classification
getimg

Import image data
cieplot

CIE plot
cie

CIE colour spaces
cocplot

Plot the colour opponent coding diagram
coldist

Colour distances
getspec

Import spectra files
pavo-package

pavo: Perceptual Analysis, Visualization and Organization of Spectral Colour Data
peakshape

Peak shape descriptors
hexagon

Colour hexagon
jnd2xyz

Convert JND distances into perceptually-corrected Cartesian coordinates
hexplot

Plot a colour hexagon
spec2rgb

Spectrum to rgb colour conversion
points.colspace

Plot points in a colourspace
plotsmooth

Plot loess smoothed curves
plot.colspace

Plot spectra in a colourspace
subset.rspec

Subset rspec, vismodel, and colspace objects
jndplot

Perceptually-corrected chromaticity diagrams
parse_avantes

Import Avantes binary file
merge.rspec

Merge two rspec objects
plot.rimg

Plot unprocessed or colour-classified images
projplot

2D projection of a tetrahedral colourspace
summary.vismodel

Visual model summary
segplot

Plot the segment-analysis model
summary.rspec

Colourimetric variables
procimg

Process images
summary.colspace

Colourspace data summary
trispace

Trichromatic colour space
ttvertex

vertex for the tetrahedral color space
vissyst

Animal visual systems data
vismodel

Visual models
procspec

Process spectra
tcspace

Tetrahedral colourspace
summary.rimg

Image summary
transmissiondata

Default ocular transmission data
tcsplot

Interactive plot of a tetrahedral colourspace
triplot

Plot a Maxwell triangle
tetraplot

Plot a static tetrahedral colorspace
teal

Angle-resolved reflectance data for the iridescent wing patch of a male green-winged teal (Anas carolinensis)
sensmodel

Modeling spectral sensitivity
sicalis

Spectral curves from three body regions of stripe-tailed yellow finch (Sicalis citrina) males
plot.rspec

Plot spectra
vol

Plot a tetrahedral colour space
voloverlap

Colour volume overlap
categorical

Categorical fly-visual model
adjacent

Run an adjacency and boundary strength analysis
bgandilum

Default background and illuminant data
as.rspec

Convert data to an rspec object
axistetra

Plot reference axes in a static tetrahedral colourspace
catplot

Plot the categorical colour vision model
aggspec

Aggregate reflectance spectra
aggplot

Plot aggregated reflectance spectra
as.rimg

Convert data to an rimg object