1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
\name{plot3d}
\alias{plot3d}
\alias{plot3d.default}
\alias{plot3d.qmesh3d}
\alias{decorate3d}
\title{3D Scatterplot}
\description{
Draws a 3D scatterplot.
}
\usage{
plot3d(x, ...)
\method{plot3d}{default}(x, y, z,
xlab, ylab, zlab, type = "p", col,
size, radius,
add = FALSE, aspect = !add, ...)
\method{plot3d}{qmesh3d}(x, xlab = "x", ylab = "y", zlab = "z", type = c("shade", "wire", "dots"),
add = FALSE, ...)
decorate3d(xlim, ylim, zlim,
xlab = "x", ylab = "y", zlab = "z",
box = TRUE, axes = TRUE, main = NULL, sub = NULL,
top = TRUE, aspect = FALSE, ...)
}
\arguments{
\item{x, y, z}{vectors of points to be plotted. Any reasonable way of defining the
coordinates is acceptable. See the function \code{\link[grDevices]{xyz.coords}}
for details.}
\item{xlab, ylab, zlab}{labels for the coordinates.}
\item{type}{For the default method, a single character indicating the type of item to plot.
Supported types are: 'p' for points, 's' for spheres,
'l' for lines, 'h' for line segments
from \code{z=0}, and 'n' for nothing. For the \code{qmesh3d} method, one of
'shade', 'wire', or 'dots'. Partial matching is used.
}
\item{col}{the colour to be used for plotted items.}
\item{size}{the size for plotted items.}
\item{radius}{the radius of spheres: see Details below.}
\item{add}{whether to add the points to an existing plot.}
\item{aspect}{either a logical indicating whether to adjust the aspect ratio, or a new ratio.}
\item{\dots}{additional parameters which will be passed to \code{\link{par3d}}, \code{\link{material3d}}
or \code{decorate3d}.}
\item{xlim, ylim, zlim}{limits to use for the coordinates.}
\item{box, axes}{whether to draw a box and axes.}
\item{main, sub}{main title and subtitle.}
\item{top}{whether to bring the window to the top when done.}
}
\value{
\code{plot3d} is called for the side effect of drawing the plot; a vector
of object IDs is returned.
\code{decorate3d} adds the usual decorations to a plot: labels, axes, etc.
}
\details{
\code{plot3d} is a partial 3D analogue of plot.default.
Note that since \code{rgl} does not currently support
clipping, all points will be plotted, and \code{xlim}, \code{ylim}, and \code{zlim}
will only be used to increase the respective ranges.
Missing values in the data are skipped, as in standard graphics.
If \code{aspect} is \code{TRUE}, aspect ratios of \code{c(1,1,1)} are passed to
\code{\link{aspect3d}}. If \code{FALSE}, no aspect adjustment is done. In other
cases, the value is passed to \code{\link{aspect3d}}.
With \code{type = "s"}, spheres are drawn centered at the specified locations.
The radius may be controlled by \code{size} (specifying the size relative
to the plot display, with \code{size=1} giving a radius
about 1/20 of the plot region) or \code{radius} (specifying it on the data scale
if an isometric aspect ratio is chosen, or on an average scale
if not).
}
\author{
Duncan Murdoch
}
\seealso{
\code{\link{plot.default}},
\code{\link{open3d}}, \code{\link{par3d}}.
}
\examples{
open3d()
x <- sort(rnorm(1000))
y <- rnorm(1000)
z <- rnorm(1000) + atan2(x,y)
plot3d(x, y, z, col=rainbow(1000), size=2)
}
\keyword{dynamic}
|
