pavo (version 2.0.0)

tetraplot: Plot a static tetrahedral colorspace

Description

Produces a static 3D tetrahedral plot.

Usage

tetraplot(tcsdata, theta = 45, phi = 10, perspective = FALSE,
  range = c(1, 2), r = 1e+06, zoom = 1, achro = TRUE,
  achro.col = "grey", achro.size = 1, achro.line = FALSE,
  achro.lwd = 1, achro.lty = 3, tetrahedron = TRUE, vert.cex = 1,
  vert.range = c(1, 2), out.lwd = 1, out.lcol = "darkgrey",
  margin = c(0, 0, 0, 0), type = "p", view, scale.y, axis, grid,
  vertexsize, labels = FALSE, ...)

Arguments

tcsdata

(required) a data frame, possibly a result from the colspace or tetraspace function, containing values for the 'x', 'y' and 'z' coordinates as columns (labeled as such).

theta

angle to rotate the plot in the xy plane (defaults to 45).

phi

angle to rotate the plot in the yz plane (defaults to 10).

perspective

logical, should perspective be forced by using point size to reflect distance from the plane of view? (defaults to FALSE)

range,

vert.range multiplier applied to cex and vert.cex, respectively, to indicate the size range variation reflecting the distance from the plane of view.

r

the distance of the eyepoint from the center of the plotting box. Very high values approximate an orthographic projection (defaults to 1e6). See persp for details.

zoom

zooms in (values greater than 1) or out (values between 0 and 1) from the plotting area.

achro

logical. Should the achromatic center be plotted? (defaults to TRUE)

achro.col, achro.size, achro.lwd, achro.lty

graphical parameters for the achromatic coordinates.

achro.line

logical. Should the achromatic line be plotted? (defaults to FALSE)

tetrahedron

logical. Should the tetrahedron be plotted? (defaults to TRUE)

vert.cex

size of the points at the vertices (defaults to 1).

out.lwd, out.lcol

graphical parameters for the tetrahedral outline.

margin

vector of four numbers specifying drawing margins (defaults to c(0, 0, 0, 0)).

type

accepts a vector of length 1 or 2 with 'p' for points and/or 'l' for lines from the point to the base of the tetrahedron.

view, scale.y, axis, grid

deprecated arguments.

labels

logical. Should the name of each cone be printed next to the corresponding vertex?

Value

tetraplot creates a 3D plot.

References

Stoddard, M. C., & Prum, R. O. (2008). Evolution of avian plumage color in a tetrahedral color space: A phylogenetic analysis of new world buntings. The American Naturalist, 171(6), 755-776.

Endler, J. A., & Mielke, P. (2005). Comparing entire colour patterns as birds see them. Biological Journal Of The Linnean Society, 86(4), 405-431.

See Also

spheres3d,rgl.postscript, rgl.snapshot,rgl.material

Examples

# NOT RUN {
# For plotting
data(sicalis)
vis.sicalis <- vismodel(sicalis, visual = 'avg.uv')
tcs.sicalis <- colspace(vis.sicalis, space = 'tcs')
plot(tcs.sicalis)

# }
# NOT RUN {
# }