F_1_panel.cloud {lattice}  R Documentation 
These are default panel functions controlling cloud
and
wireframe
displays.
panel.cloud(x, y, subscripts, z, groups = NULL, perspective = TRUE, distance = if (perspective) 0.2 else 0, xlim, ylim, zlim, panel.3d.cloud = "panel.3dscatter", panel.3d.wireframe = "panel.3dwire", screen = list(z = 40, x = 60), R.mat = diag(4), aspect = c(1, 1), par.box = NULL, xlab, ylab, zlab, xlab.default, ylab.default, zlab.default, scales.3d, proportion = 0.6, wireframe = FALSE, scpos, ..., at, identifier = "cloud") panel.wireframe(...) panel.3dscatter(x, y, z, rot.mat, distance, groups, type = "p", xlim, ylim, zlim, xlim.scaled, ylim.scaled, zlim.scaled, zero.scaled, col, col.point, col.line, lty, lwd, cex, pch, cross, ..., .scale = FALSE, subscripts, identifier = "3dscatter") panel.3dwire(x, y, z, rot.mat = diag(4), distance, shade = FALSE, shade.colors.palette = trellis.par.get("shade.colors")$palette, light.source = c(0, 0, 1000), xlim, ylim, zlim, xlim.scaled, ylim.scaled, zlim.scaled, col = if (shade) "transparent" else "black", lty = 1, lwd = 1, alpha, col.groups = superpose.polygon$col, polynum = 100, ..., .scale = FALSE, drape = FALSE, at, col.regions = regions$col, alpha.regions = regions$alpha, identifier = "3dwire")
x, y, z 
numeric (or possibly factors) vectors representing the data to be
displayed. The interpretation depends on the context. For
Further, for In 
subscripts 
index specifying which points to draw. The same 
groups 
specification of a grouping variable, passed down from the high level functions. 
perspective 
logical, whether to plot a perspective view. Setting this to

distance 
numeric, between 0 and 1, controls amount of perspective. The
distance of the viewing point from the origin (in the transformed
coordinate system) is 
screen 
A list determining the sequence of rotations to be applied to the
data before being plotted. The initial position starts with the
viewing point along the positive zaxis, and the x and y axes in the
usual position. Each component of the list should be named one of

R.mat 
initial rotation matrix in homogeneous coordinates, to be applied to
the data before 
par.box 
graphical parameters for box, namely, col, lty and lwd. By default
obtained from the parameter 
xlim, ylim, zlim 
limits for the respective axes. As with other lattice functions, these could each be a numeric 2vector or a character vector indicating levels of a factor. 
panel.3d.cloud, panel.3d.wireframe 
functions that draw the datadriven part of the plot (as opposed to
the bounding box and scales) in Any userdefined custom display would probably want to change these
functions. The intention is to pass as much information to this
function as might be useful (not all of which are used by the
defaults). In particular, these functions can expect arguments
called 
aspect 
aspect as in 
xlab, ylab, zlab 
Labels, have to be lists. Typically the user will not manipulate
these, but instead control this via arguments to 
xlab.default 
for internal use 
ylab.default 
for internal use 
zlab.default 
for internal use 
scales.3d 
list defining the scales 
proportion 
numeric scalar, gives the length of arrows as a proportion of the sides 
scpos 
A list with three components x, y and z (each a scalar integer),
describing which of the 12 sides of the cube the scales should be
drawn. The defaults should be OK. Valid values are x: 1, 3, 9, 11;
y: 8, 5, 7, 6 and z: 4, 2, 10, 12. (See comments in the source code
of 
wireframe 
logical, indicating whether this is a wireframe plot 
drape 
logical, whether the facets will be colored by height, in a manner
similar to 
at, col.regions, alpha.regions 
deals with specification of colors when 
rot.mat 
4x4 transformation matrix in homogeneous coordinates. This gives the
rotation matrix combining the 
type 
Character vector, specifying type of cloud plot. Can include one or
more of 
xlim.scaled, ylim.scaled, zlim.scaled 
axis limits (after being scaled to the bounding box) 
zero.scaled 
zaxis location (after being scaled to the bounding box) of the XY
plane in the original data scale, to which lines will be dropped (if
within range) from each point when 
cross 
logical, defaults to This is useful for two reasons. It can be set to 
shade 
logical, indicating whether the surface is to be colored using an illumination model with a single light source 
shade.colors.palette 
a function (or the name of one) that is supposed to calculate the color of a facet when shading is being used. Three pieces of information are available to the function: first, the cosine of the angle between the incident light ray and the normal to the surface (representing foreshortening); second, the cosine of half the angle between the reflected ray and the viewing direction (useful for nonLambertian surfaces); and third, the scaled (average) height of that particular facet with respect to the total plot zaxis limits. All three numbers should be between 0 and 1. The

light.source 
a 3vector representing (in cartesian coordinates) the light source. This is relative to the viewing point being (0, 0, 1/distance) (along the positive zaxis), keeping in mind that all observations are bounded within the [0.5, 0.5] cube 
polynum 
quadrilateral faces are drawn in batches of 
col.groups 
colors for different groups 
col, col.point, col.line, lty, lwd, cex, pch, alpha 
Graphical parameters. Some other arguments (such as 
... 
other parameters, passed down when appropriate 
.scale 
Logical flag, indicating whether 
identifier 
A character string that is prepended to the names of grobs that are created by this panel function. 
These functions together are responsible for the content drawn inside
each panel in cloud
and wireframe
.
panel.wireframe
is a wrapper to panel.cloud
, which does
the actual work.
panel.cloud
is responsible for drawing the content that does
not depend on the data, namely, the bounding box, the arrows/scales,
etc. At some point, depending on whether wireframe
is TRUE, it
calls either panel.3d.wireframe
or panel.3d.cloud
, which
draws the datadriven part of the plot.
The arguments accepted by these two functions are different, since
they have essentially different purposes. For cloud, the data is
unstructured, and x
, y
and z
are all passed to
the panel.3d.cloud
function. For wireframe, on the other hand,
x
and y
are increasing vectors with unique values,
defining a rectangular grid. z
must be a matrix with
length(x) * length(y)
rows, and as many columns as the number
of groups.
panel.3dscatter
is the default panel.3d.cloud
function.
It has a type
argument similar to panel.xyplot
,
and supports grouped displays. It tries to honour depth ordering,
i.e., points and lines closer to the camera are drawn later,
overplotting more distant ones. (Of course there is no absolute
ordering for line segments, so an ad hoc ordering is used. There is no
hidden point removal.)
panel.3dwire
is the default panel.3d.wireframe
function. It calculates polygons corresponding to the facets one by
one, but waits till it has collected information about polynum
facets, and draws them all at once. This avoids the overhead of
drawing grid.polygon
repeatedly, speeding up the rendering
considerably. If shade = TRUE
, these attempt to color the
surface as being illuminated from a light source at
light.source
. palette.shade
is a simple function that
provides the deafult shading colors
Multiple surfaces are drawn if groups
is nonnull in the call
to wireframe
, however, the algorithm is not sophisticated
enough to render intersecting surfaces correctly.
Deepayan Sarkar Deepayan.Sarkar@Rproject.org