Matrix (2-D), vector, or one value containing the values
where the image is to be plotted.
At least one of them should be one number, as this will determine where the
image is plotted, parallel to the (y-z) plane (x one number),
to the (x-z) plane (y one number) or to the (z-y) plane (z one number).
If two are vectors, the first vector should be of length equal to
nrow(colvar) and the second should be of length equal to
ncol(colvar).
colvar
The variable used for coloring.
Values of colvar equal to NULL, NA, or FALSE
will toggle off coloration according to colvar. This gives good results
only if border is given a color, or when shade is >0 (see persp).
col
Color palette to be used for the colvar variable.
If col is NULL and colvar is specified,
then a red-yellow-blue colorscheme (jet.col) will be used.
If col is NULL and colvar is not specified, then
col will be "black".
colkey
A logical, NULL (default), or a list with parameters
for the color key (legend). List parameters should be one of
side, plot, length, width, dist, shift, addlines, col.clab, cex.clab,
side.clab, line.clab, adj.clab, font.clab
and the axis parameters at, labels, tick, line, pos, outer, font, lty, lwd,
lwd.ticks, col.box, col.axis, col.ticks, hadj, padj, cex.axis, mgp, tck, tcl, las.
The defaults for the parameters are side = 4, plot = TRUE, length = 1, width = 1,
dist = 0, shift = 0, addlines = FALSE, col.clab = NULL, cex.clab = par("cex.lab"),
side.clab = NULL, line.clab = NULL, adj.clab = NULL, font.clab = NULL)
See colkey.
The default is to draw the color key on side = 4, i.e. in the right margin.
If colkey = NULL then a color key will be added only if col is a vector.
Setting colkey = list(plot = FALSE) will create room for the color key
without drawing it.
if colkey = FALSE, no color key legend will be added.
clab
Only if colkey = TRUE, the label to be written on top of the
color key. The label will be written at the same level as the main title.
to lower it, clab can be made a vector, with the first values empty
strings.
clim
Only if colvar is specified, the range of the color variable, used
for the color key. Values of colvar that extend the range will be put to NA.
theta, phi
The angles defining the viewing direction.
theta gives the azimuthal direction and phi the colatitude.
see persp.
panel.first
A function to be evaluated after the plot axes are
set up but before any plotting takes place.
This can be useful for drawing background grids or scatterplot smooths.
The function should have as argument the transformation matrix, e.g. it should
be defined as function(pmat). See example of persp3D and last example of voxel3D.
bty
The type of the box, the default only drawing background panels.
Only effective if the persp
argument (box) equals TRUE (this is the default). See perspbox.
dDepth
When a contour is added on an image, the image polygons may
hide some contour segments. To avoid that, the viewing depth of the segments
can be artificially decreased with the factor dDepth times the
persp argument expand (usually = 1), to make them
appear in front of the polygons. Too large values of dDepth
may create visible artifacts.
addbox
If TRUE will draw a box around the
plot.
add
Logical. If TRUE, then the contours will be added to the current plot.
If FALSE a new plot is started.
plot
Logical. If TRUE (default), a plot is created,
otherwise the viewing transformation matrix is returned (as invisible).
...
additional arguments passed to the plotting methods.
The following persp arguments can be specified:
xlim, ylim, zlim, xlab, ylab, zlab, main, sub, r, d,
scale, expand, box, axes, nticks, ticktype.
The arguments xlim, ylim, zlim only affect the axes.
All objects will be plotted, including those that fall out of these ranges.
To select objects only within the axis limits, use plotdev.
In addition, the perspbox arguments
col.axis, col.panel, lwd.panel, col.grid, lwd.grid can
also be given a value.
The arguments lty, lwd can also be specified.
shade and lighting arguments will have no effect.
alpha can be given a value inbetween 0 and 1 to make colors transparent.
The arguments after ... must be matched exactly.
Value
Returns the viewing transformation matrix.
See trans3D.