Plot options for jnd2xyz objects.

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

scaling factor for 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 a square plotting area be used? (defaults to TRUE)

...

additional parameters to be passed to plot, arrows and link{persp} (for 3D plots).

Value

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

Note

the arrow argument accepts three options:

  • 'relative': With this option, arrows will be made relative to the data. Arrows will be centered on the data centroid, and will have an arbitrary length of half the average pairwise distance between points, which can be scaled with the arrow.p argument.

  • 'absolute': With this option, arrows will be made to reflect the visual system underlying the data. Arrows will be centered on the achromatic point in colorspace, and will have length equal to the distance to a monochromatic point (i.e. a color that stimulates approximately 99.9 the arrow.p argument, in which case they cannot be interpreted as described.

  • 'none': no arrows will be included.

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)
# }