Trellis Arguments for 3D Functions
USAGE:
trellis.3d.function(
aspect = c(1,1),
distance = .2,
par.box = ,
perspective = TRUE,
R.mat = diag(4),
scales = list(cex = 0.5, col = 1, lty = 1, lwd = 1,
distance = rep(1, 3), arrows = T),
screen = list(z = 40, x = -60),
zlab = ,
zoom = 1,
...
)
These arguments are common to the Trellis display functions that
operate with 3D data: in particular,
clouds
and
wireframe
.
See the documentation for the display functions themselves to read about
any special restrictions on these arguments.
ARGUMENTS:
- aspect
-
a vector of two values giving physical aspect ratio control.
The first value
controls each panel's ratio y-size/x-size.
The second value is the ratio z-size/x-size.
By default,
aspect=c(1,1)
.
Notice that this argument, for 3D functions, differs from that of
the standard trellis display functions.
- distance
-
controls the amount of perspective, as in the distance from the object
to the viewer.
Smaller values increase the perspective; 0 implies the viewer is right
at the object, 1 that the viewer is infinitely far away
(orthogonal projection).
- par.box
-
A list giving graphical parameters to be applied to the 3-D box enclosing
the point-cloud or wireframe.
The default parameters are given by
trellis.par.get("box.3d")
.
- perspective
-
if
TRUE
, a perspective transformation is used for the data; otherwise,
the transformation is orthogonal.
- R.mat
-
An initial 4 by 4 rotation matrix (homogeneous coordinates).
This can be used, for example, if a prior function returned a rotation matrix
for a particular view.
By default, this is the identity matrix.
- scales
-
A list giving graphical parameters to be applied to the x-, y-,
and z-axis labels of the 3-D display.
The
distance
component determines the distance of
an arrow-label from the edge of the 3-D box.
The
arrows
component is a logical value that tells whether
the axes should be drawn by simple symbolic arrows (
arrows=T
, the default)
or by tick marks and tick labels (
arrows=F
).
NOTE: this is a more restrictive version than the
scales
argument
described in
trellis.args
; some features of 3-D scales
are still under construction.
- screen
-
A list describing the rotations applied to the data before plotting.
Each component of the list should be a single number giving the
degrees of rotation; the name of the component tells which axis to rotate
about. The default value is to rotate 40 degrees about the z axis followed by
a rotation of -60 degrees about the x axis.
- zlab
-
character string giving a label for the z-axis.
By default, the expression given for
z
in
formula
.
- zoom
-
Overall scale factor for the drawn object.
Zoom values other than 1 can be used to enlarge or compress the object.
- ...
-
other arguments are passed down to the function
panel
.
Specifically, graphically parameters such as
cex
,
col
,
font
, and
pch
will affect the appearance of the plotting symbol in
clouds
; and
col
,
lty
, and
lwd
will affect the appearance of surface grid of
wireframe
.