Produces a static 3D tetrahedral plot.

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

## Examples

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