xyz.coords

Extracting Plotting Structures

Utility for obtaining consistent x, y and z coordinates and labels for three dimensional (3D) plots.

Keywords
dplot
Usage
xyz.coords(x, y = NULL, z = NULL,
           xlab = NULL, ylab = NULL, zlab = NULL,
           log = NULL, recycle = FALSE)
Arguments
x, y, z
the x, y and z coordinates of a set of points. Both y and z can be left at NULL. In this case, an attempt is made to interpret x in a way suitable for plotting.

If the argument is a formula zvar ~ xvar + yvar, xvar, yvar and zvar are used as x, y and z variables; if the argument is a list containing components x, y and z, these are assumed to define plotting coordinates; if the argument is a matrix or data.frame with three or more columns, the first is assumed to contain the x values, the 2nd the y ones, and the 3rd the z ones -- independently of any column names that x may have.

Alternatively two arguments x and y can be provided (leaving z = NULL). One may be real, the other complex; in any other case, the arguments are coerced to vectors and the values plotted against their indices.

xlab, ylab, zlab
names for the x, y and z variables to be extracted.
log
character, "x", "y", "z" or combinations. Sets negative values to NA and gives a warning.
recycle
logical; if TRUE, recycle (rep) the shorter ones of x, y or z if their lengths differ.
Value

  • A list with the components
  • xnumeric (i.e., double) vector of abscissa values.
  • ynumeric vector of the same length as x.
  • znumeric vector of the same length as x.
  • xlabcharacter(1) or NULL, the axis label of x.
  • ylabcharacter(1) or NULL, the axis label of y.
  • zlabcharacter(1) or NULL, the axis label of z.

See Also

xy.coords for 2D.

Aliases
  • xyz.coords
Examples
library(grDevices) xyz.coords(data.frame(10*1:9, -4), y = NULL, z = NULL) xyz.coords(1:5, stats::fft(1:5), z = NULL, xlab = "X", ylab = "Y") y <- 2 * (x2 <- 10 + (x1 <- 1:10)) xyz.coords(y ~ x1 + x2, y = NULL, z = NULL) xyz.coords(data.frame(x = -1:9, y = 2:12, z = 3:13), y = NULL, z = NULL, log = "xy") ##> Warning message: 2 x values <= 0 omitted ...
Documentation reproduced from package grDevices, version 3.3, License: Part of R 3.3

Community examples

Looks like there are no examples yet.