scatterplot3d

From scatterplot3d v0.3-5 by Uwe Ligges with contributions from Andrea Preusser

3D Scatter Plot

Plots a three dimensional (3D) point cloud perspectively.

Keywords: hplot

Usage

scatterplot3d(x, y=NULL, z=NULL, color=par("col"), main=NULL,
    sub=NULL, xlim=NULL, ylim=NULL, zlim=NULL, xlab=NULL,
    ylab=NULL, zlab=NULL, scale.y=1, angle=40, axis=TRUE,
    tick.marks=TRUE, label.tick.marks=TRUE, 
    x.ticklabs=NULL, y.ticklabs=NULL, z.ticklabs=NULL,
    y.margin.add=0, grid=TRUE, box=TRUE, lab=par("lab"),
    lab.z=mean(lab[1:2]), type=par("type"), highlight.3d=FALSE,
    mar=c(5,3,4,3)+0.1, col.axis=par("col.axis"),
    col.grid="grey", col.lab=par("col.lab"),
    cex.axis=par("cex.axis"), cex.lab=0.8 * par("cex.lab"),
    font.axis=par("font.axis"), font.lab=par("font.lab"),
    lty.axis=par("lty"), lty.grid=par("lty"), log="", ...)

Arguments

x: the coordinates of points in the plot.
y: the y coordinates of points in the plot, optional if x is an appropriate structure.
z: the z coordinates of points in the plot, optional if x is an appropriate structure.
color: colors of points in the plot, optional if x is an appropriate structure. Will be ignored if highlight.3d = TRUE.
main: an overall title for the plot.
sub: sub-title.
xlim, ylim, zlim: the x, y and z limits (min, max) of the plot.
xlab, ylab, zlab: titles for the x, y and z axis.
scale.y: scale of y axis related to x- and z axis.
angle: angle between x and y axis (Attention: result depends on scaling. For 180 < angle < 360 the returned functions xyz.convert and points3d will not work properly.).
axis: a logical value indicating whether axes should be drawn on the plot.
tick.marks: a logical value indicating whether tick marks should be drawn on the plot (only if axis = TRUE).
label.tick.marks: a logical value indicating whether tick marks should be labeled on the plot (only if axis = TRUE and tick.marks = TRUE).
x.ticklabs, y.ticklabs, z.ticklabs: vector of tick mark labels.
y.margin.add: add additional space between tickmark labels and axis label of the y axis
grid: a logical value indicating whether a grid should be drawn on the plot.
box: a logical value indicating whether a box should be drawn around the plot.
lab: a numerical vector of the form c(x, y, len). The values of x and y give the (approximate) number of tickmarks on the x and y axes.
lab.z: the same as lab, but for z axis.
type: character indicating the type of plot: "p" for points, "l" for lines, "h" for vertical lines to x-y-plane, etc.
highlight.3d: points will be drawn in different colors related to y coordinates (only if type = "p" or type = "h", else color will be used). On some devices not all colors can be displayed. In this case try the postscript device
mar: A numerical vector of the form c(bottom, left, top, right) which gives the lines of margin to be specified on the four sides of the plot.
col.axis, col.grid, col.lab: the color to be used for axis / grid / axis labels.
cex.axis, cex.lab: the magnification to be used for axis annotation / labels relative to the current.
font.axis, font.lab: the font to be used for axis annotation / labels.
lty.axis, lty.grid: the line type to be used for axis / grid.
log: Not yet implemented! A character string which contains "x" (if the x axis is to be logarithmic), "y", "z", "xy", "xz", "yz", "xyz".
...: more graphical parameters can be given as arguments, pch = 16 or pch = 20 may be nice.

Value

xyz.convertfunction which converts coordinates from 3D (x, y, z) to 2D-projection (x, y) of scatterplot3d. Usefull to plot objects into existing plot.
points3dfunction which draws points or lines into the existing plot.

Note

Some graphical parameters can only be set as arguments in scatterplot3d but not in par, e.g. mar. Other arguments in par may be splitted into several arguments in scatterplot3d, e.g. for specifying the line type. And finally some of the arguments in par do not work, e.g. many of those for axis calculation. So the recommended way is to try the specification of graphical parameters at first as arguments in scatterplot3d and at last as arguments in par.

Examples

## On some devices not all colors can be displayed.
    ## Try the postscript device or use highlight.3d = FALSE.

    ## example 1
    z <- seq(-10, 10, 0.01)
    x <- cos(z)
    y <- sin(z)
    scatterplot3d(x, y, z, highlight.3d=TRUE, col.axis="blue",
        col.grid="lightblue", main="scatterplot3d -- example 1", pch=20)

    ## example 2
    temp <- seq(-pi, 0, length = 50)
    x <- as.vector(rep(1, 50) %*% t(cos(temp)))
    y <- as.vector(cos(temp) %*% t(sin(temp)))
    z <- as.vector(sin(temp) %*% t(sin(temp)))
    scatterplot3d(x, y, z, highlight.3d=TRUE, 
        col.axis="blue", col.grid="lightblue",
        main="scatterplot3d -- example 2", pch=20)

    ## example 3
    temp <- seq(-pi, 0, length = 50)
    x <- as.vector(rep(1, 50) %*% t(cos(temp)))
    y <- as.vector(cos(temp) %*% t(sin(temp)))
    z <- 10 * as.vector(sin(temp) %*% t(sin(temp)))
    color <- rep("green", length(x))
    temp <- seq(-10, 10, 0.01)
    x <- c(x, cos(temp))
    y <- c(y, sin(temp))
    z <- c(z, temp)
    color <- c(color, rep("red", length(temp)))
    scatterplot3d(x, y, z, color, pch=20, zlim=c(-2, 10),
        main="scatterplot3d -- example 3")

    ## example 4
    my.mat <- matrix(runif(25), nrow=5)
    dimnames(my.mat) <- list(LETTERS[1:5], letters[11:15])
    my.mat # the matrix we want to plot ...
    
    s3d.dat <- data.frame(cols=as.vector(col(my.mat)), 
        rows=as.vector(row(my.mat)), 
        value=as.vector(my.mat))
    scatterplot3d(s3d.dat, type="h", lwd=5, pch="", 
        x.ticklabs=colnames(my.mat), y.ticklabs=rownames(my.mat), 
        color=grey(25:1/40), main="scatterplot3d -- example 4")

    ## example 5
    data(trees)
    s3d <- scatterplot3d(trees, type="h", highlight.3d=TRUE, 
        pch=16, main="scatterplot3d -- example 5")
    # Now adding some points to the "scatterplot3d"
    s3d$points3d(seq(10,20,2), seq(85,60,-5), seq(60,10,-10), 
        col="blue", type="h", pch=16)

Documentation reproduced from package scatterplot3d, version 0.3-5, License: GPL (version 2)

Community examples

Looks like there are no examples yet.