rp.plot3d: Interactive display of a plot of three variables

In rpanel: Simple Interactive Controls for R using the 'tcltk' Package

Interactive display of a plot of three variables

Description

This function produces a scatterplot of three variables, using the rgl package for three-dimensional display.

Usage

  rp.plot3d(x, y, z, xlab  = NA, ylab = NA, zlab = NA, 
                   axes = TRUE, new.window = TRUE, type = "p", size = 3, col = "red",
                   xlim = NA, ylim = NA, zlim = NA, plot = TRUE, ...)

Arguments

x,y,z	vectors of observed values.
xlab	a character variable used for the first axis label.
ylab	a character variable used for the second axis label.
zlab	a character variable used for the third axis label.
axes	a logical variable determining whether the axes are shown.
new.window	a logical variable which determines whether a new window is opened (TRUE) or the current plot is clear and the new plot is drawn in the existing window (FALSE).
type	a character variable controlling the type of plotting. If the value is set to "n", the points are not plotted.
size	the size of the plotted points.
col	the colour of the plotted points.
xlim	the plotting range for the first variable.
ylim	the plotting range for the second variable.
zlim	the plotting range for the third variable.
plot	a logical variable which determines whether a plot is drawn. It can be useful to set this to FALSE when only the scaling function is required.
...	other rgl parameters which control the appearance of the plotted points.

Details

The plot is produced by appropriate calls to the rgl package. This allows interactive control of the viewing position. Other objects may subsequently be added to the plot by using rgl functions and data which are centred and scaled by the returned values indicated below.

Value

A scaling function is returned to allow further objects to be added to the plot. The function accepts x, y, z vector arguments and returns a list with x, y, z components defining the co-ordinates for plotting. An illustration is given in the example below.

References

rpanel: Simple interactive controls for R functions using the tcltk package. Journal of Statistical Software, 17, issue 9.

See Also

rp.regression

Examples

## Not run: 
  x <- rnorm(50)
  y <- rnorm(50)
  z <- rnorm(50)
  scaling <- rp.plot3d(x, y, z, xlim = c(-3, 3))
  # In addition you may add a line to the plot with these two lines;
  #  a <- scaling(c(-3,3), c(0,0), c(0,0))
  #  lines3d(a$x, a$y, a$z, col = "green", size = 2) 

## End(Not run)

rpanel documentation built on Feb. 16, 2023, 10:37 p.m.