pavo (version 2.5.0)

jndplot: Perceptually-corrected chromaticity diagrams

Description

Plot options for jnd2xyz objects.

Usage

jndplot(
  x,
  arrow = c("relative", "absolute", "none"),
  achro = FALSE,
  arrow.labels = TRUE,
  arrow.col = "darkgrey",
  arrow.p = 1,
  labels.cex = 1,
  margin = "recommended",
  square = TRUE,
  ...
)

Arguments

x

(required) the output from a jnd2xyz() call.

arrow

If and how arrows indicating receptor vectors should be drawn. Options are "relative" (default), "absolute" or "none". See description.

achro

Logical. Should the achromatic variable be plotted as a dimension? (only available for dichromats and trichromats, defaults to FALSE).

arrow.labels

Logical. Should labels be plotted for receptor arrows? (defaults to TRUE)

arrow.col

color of the arrows and labels.

arrow.p

scaling factor for arrows.

labels.cex

size of the arrow labels.

margin

accepts either "recommended", where the function will choose margin attributes, or a numerical vector of the form c(bottom, left, top, right) which gives the number of lines of margin to be specified on the four sides of the plot. (Default varies depending on plot dimensionality).

square

logical. Should the aspect ratio of the plot be held to 1:1? (defaults to TRUE).

...

additional parameters to be passed to plot(), arrows() and graphics::persp() (for 3D plots).

Value

Creates a plot, details of the plot depend on the input data.

References

Pike, T.W. (2012). Preserving perceptual distances in chromaticity diagrams. Behavioral Ecology, 23, 723-728.

Examples

# NOT RUN {
data(flowers)
vis.flowers <- vismodel(flowers)
cd.flowers <- coldist(vis.flowers)
propxyz <- jnd2xyz(cd.flowers)
plot(propxyz)
# }