plot3d.formula: Methods for formulas

Description Usage Arguments Details Value Note Author(s) Examples

View source: R/plot3d.R

Description

These functions provide a simple formula-based interface to plot3d and persp3d.

Usage

1
2
3
4
## S3 method for class 'formula'
plot3d(x, data = NULL, xlab, ylab, zlab, ...)
## S3 method for class 'formula'
persp3d(x, data = NULL, xlab, ylab, zlab, ...)

Arguments

x

A formula like z ~ x + y.

data

An optional dataframe or list in which to find the components of the formula.

xlab, ylab, zlab

Optional axis labels to override the ones automatically obtained from the formula.

...

Additional arguments to pass to the default plot3d method, or the persp3d method for "deldir" objects.

Details

Only simple formulas (the ones handled by the xyz.coords function) are supported: a single variable on the left hand side (which will be plotted on the Z axis), and a sum of two variables on the right hand side (which will be the X and Y axis variables in the plot.)

Value

These functions are called for the side effect of drawing the plots. The plot3d method draws a scatterplot. The persp3d method draws a surface plot.

Return values are as given by the plot3d.default method or the persp3d.deldir methods.

Note

The persp3d method requires that the suggested package deldir is installed.

Author(s)

Duncan Murdoch

Examples

1
2
3
4
5
open3d()
mfrow3d(1, 2, sharedMouse = TRUE)
plot3d(mpg ~ wt + qsec, data = mtcars)
if (requireNamespace("deldir"))
  persp3d(mpg ~ wt + qsec, data = mtcars)

Example output

Warning messages:
1: In rgl.init(initValue, onlyNULL) : RGL: unable to open X11 display
2: 'rgl.init' failed, running with 'rgl.useNULL = TRUE'. 
null 
   1 
Loading required namespace: deldir

rgl documentation built on Feb. 1, 2021, 3:01 a.m.