# scatter3d

From Rcmdr v1.0-2
by John Fox

##### Three-Dimensional Scatterplots

This function uses the `rgl`

package to draw 3D scatterplots
with various regression surfaces.

- Keywords
- hplot

##### Usage

```
scatter3d(x, y, z, xlab=deparse(substitute(x)), ylab=deparse(substitute(y)),
zlab=deparse(substitute(z)), revolutions=0,
bg.col=c("black", "white"), axis.col=NULL,
surface.col=c("blue", "green", "orange", "magenta", "cyan", "red",
"yellow", "gray"),
neg.res.col="red", pos.res.col="green", point.col="yellow",
text.col=axis.col, grid.col=if (bg.col == "white") "black" else "gray",
fogtype=c("exp2", "linear", "exp", "none"),
residuals=(length(fit) == 1), surface=TRUE, grid=TRUE, grid.lines=26,
df.smooth=NULL, df.additive=NULL,
sphere.size=1, threshold=0.01, speed=1, fov=60,
fit="linear", groups=NULL, parallel=TRUE, model.summary=FALSE)
```

##### Arguments

- x
- variable for horizontal axis.
- y
- variable for vertical axis (response).
- z
- variable for out-of-screen axis.
- xlab, ylab, zlab
- axis labels.
- revolutions
- number of full revolutions of the display.
- bg.col
- background colour; one of
`"white"`

,`"black"`

. - axis.col
- colour for axes; default is
`"white"`

for black background,`"black"`

for white background. - surface.col
- vector of colours for regression planes,
used in the order specified by
`fit`

. - neg.res.col, pos.res.col
- colours for lines representing negative and positive residuals.
- point.col
- colour of points.
- text.col
- colour of axis labels.
- grid.col
- colour of grid lines on the regression surface(s).
- fogtype
- type of fog effect; one of
`"exp2"`

,`"linear"`

,`"exp"`

,`"none".`

- residuals
- plot residuals (
`TRUE`

or`FALSE`

); available only when there is one surface plotted. - surface
- plot surface(s) (
`TRUE`

or`FALSE`

). - grid
- plot grid lines on the regression surface(s) (
`TRUE`

or`FALSE`

). - grid.lines
- number of lines (default, 26) forming the grid, in each of the x and y directions.
- df.smooth
- degrees of freedom for the two-dimensional smooth regression surface;
if
`NULL`

(the default), the`gam`

function will select the degrees of freedom for a smoothing spline by generalized - df.additive
- degrees of freedom for each explanatory variable in an additive regression;
if
`NULL`

(the default), the`gam`

function will select degrees of freedom for the smoothing splines by generalized cross-validation; if a positiv - sphere.size
- relative sizes of spheres representing points; the actual size is dependent on the number of observations.
- threshold
- if the actual size of the spheres is less than the threshold, points are plotted instead.
- speed
- relative speed of revolution of the plot.
- fov
- field of view (in degrees); controls degree of perspective.
- fit
- one or more of
`"linear"`

,`"quadratic"`

,`"smooth"`

,`"additive"`

; to display fitted surface(s); partial matching is supported -- e.g.,`c("lin", "quad")`

. - groups
- if
`NULL`

(the default), no groups are defined; if a factor, a different surface or set of surfaces is plotted for each level of the factor; in this event, the colours in`plane.col`

are used successively for the points, s - parallel
- when plotting surfaces by
`groups`

, should the surfaces be constrained to be parallel? A logical value, with default`TRUE`

. - model.summary
- print summary or summaries of the model(s) fit
(
`TRUE`

or`FALSE`

).

##### Value

- Does not return a useful value; used for its side-effect of creating a 3D scatterplot.

##### Note

You have to install the `rgl`

and `mgcv`

packages to produce 3D plots.

##### See Also

##### Examples

```
data(state)
State.x77 <- as.data.frame(state.x77)
with(State.x77, scatter3d(Income, Murder, Illiteracy))
with(State.x77, scatter3d(Income, Murder, Illiteracy, fit=c("linear", "quadratic")))
```

*Documentation reproduced from package Rcmdr, version 1.0-2, License: GPL version 2 or newer*

### Community examples

Looks like there are no examples yet.