rgl (version 0.84)

plot3d: 3D Scatterplot

Description

Draws a 3D scatterplot.

Usage

plot3d(x, ...)
## S3 method for class 'default':
plot3d(x, y, z,  
	xlab, ylab, zlab, type = "p", col,  
        size, lwd, radius,
	add = FALSE, aspect = !add, ...)
## S3 method for class 'mesh3d':
plot3d(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

x, y, z

vectors of points to be plotted. Any reasonable way of defining the coordinates is acceptable. See the function xyz.coords for details.

xlab, ylab, zlab

labels for the coordinates.

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 z=0, and 'n' for nothing. For the mesh3d m

col

the colour to be used for plotted items.

size

the size for plotted points.

lwd

the line width for plotted items.

radius

the radius of spheres: see Details below.

add

whether to add the points to an existing plot.

aspect

either a logical indicating whether to adjust the aspect ratio, or a new ratio.

...

additional parameters which will be passed to par3d, material3d or decorate3d.

xlim, ylim, zlim

limits to use for the coordinates.

box, axes

whether to draw a box and axes.

main, sub

main title and subtitle.

top

whether to bring the window to the top when done.

Value

• plot3d is called for the side effect of drawing the plot; a vector of object IDs is returned. decorate3d adds the usual decorations to a plot: labels, axes, etc.

Details

plot3d is a partial 3D analogue of plot.default.

Note that since rgl does not currently support clipping, all points will be plotted, and xlim, ylim, and zlim will only be used to increase the respective ranges.

Missing values in the data are skipped, as in standard graphics.

If aspect is TRUE, aspect ratios of c(1,1,1) are passed to aspect3d. If FALSE, no aspect adjustment is done. In other cases, the value is passed to aspect3d.

With type = "s", spheres are drawn centered at the specified locations. The radius may be controlled by size (specifying the size relative to the plot display, with the default size=3 giving a radius about 1/20 of the plot region) or radius (specifying it on the data scale if an isometric aspect ratio is chosen, or on an average scale if not).

See Also

plot.default, open3d, par3d.

Examples

open3d()
  x <- sort(rnorm(1000))
  y <- rnorm(1000)
  z <- rnorm(1000) + atan2(x,y)
  plot3d(x, y, z, col=rainbow(1000))