corregp (version 2.0.2)

plot3d.corregp: 3D Plotting for Correspondence Regression

Description

Method to produce a 3D plot for a correspondence regression.

Usage

# S3 method for corregp
plot3d(x, axes = 1:3, y_btm = TRUE, y_ell = FALSE,
  x_ell = FALSE, ysub = NULL, xsub = NULL, hlim = NULL, vlim = NULL,
  dlim = NULL, asp = par3d("scale"), col_btm = "darkgrey",
  col_top = "red", cex_btm = par3d("cex"), cex_top = cex_btm,
  font_btm = par3d("font"), font_top = font_btm,
  fam_btm = par3d("family"), fam_top = fam_btm, col_ell = "black",
  lwd_ell = 1, lty_ell = "shade", opa_ell = 0.2, col_ori = "grey",
  lwd_ori = 1, main = NULL, sub = NULL, hlab = NULL, vlab = NULL,
  dlab = NULL, cl = 0.95, add_ori = TRUE, ...)

Arguments

x

The output of a call to corregp (i.e. an object of class "corregp").

axes

The axes to plot: a vector of three values. Defaults to the first three axes.

y_btm

Logical specifying whether the Y levels should be plotted first ("at the bottom") and then be overlaid by the X levels. Defaults to TRUE.

y_ell

Logical specifying whether the confidence ellipsoids of the Y levels should be plotted. Defaults to FALSE.

x_ell

Logical specifying whether the confidence ellipsoids of the X levels should be plotted. Defaults to FALSE.

ysub

Vector of indices to select a subset of the Y levels.

xsub

Vector of indices to select a subset of the X levels.

hlim

Vector of two values specifying the lower and upper limit between which to plot the horizontal axis.

vlim

Vector of two values specifying the lower and upper limit between which to plot the vertical axis.

dlim

Vector of two values specifying the lower and upper limit between which to plot the "depth" axis.

asp

The aspect ratio for the whole plot. See aspect3d.

col_btm

Color of the bottom levels: either numeric or see colors. Defaults to "darkgrey".

col_top

Color of the top levels: either numeric or see colors. Defaults to "red".

cex_btm

Character expansion factor of the bottom levels: a number to specify the size of the text labels.

cex_top

Character expansion factor of the top levels: a number to specify the size of the text labels.

font_btm

Font of the bottom levels: 1 for plain, 2 for bold, 3 for italic, and 4 for bold italic.

font_top

Font of the top levels: 1 for plain, 2 for bold, 3 for italic, and 4 for bold italic.

fam_btm

Font family of the bottom levels: can be "serif", "sans", "mono" or code"symbol".

fam_top

Font family of the top levels: can be "serif", "sans", "mono" or "symbol".

col_ell

Color of the confidence ellipsoids: either a number or see colors. Defaults to "black".

lwd_ell

Width of the confidence ellipsoids: a number to specify the line width.

lty_ell

Line type of the confidence ellipsoids: either "shade", "wire", or "dots". Defaults to "shade".

opa_ell

Opaqueness of the confidence ellipsoids: a number between 0 for fully transparent and 1 for fully opaque. Defaults to 0.2.

col_ori

Color of the lines through the origin: either a number or see colors. Defaults to "grey".

lwd_ori

Width of the lines through the origin: a number to specify the line width. Defaults to 1.

main

The main title of the plot.

sub

The subtitle of the plot.

hlab

The title of the horizontal axis.

vlab

The title of the vertical axis.

dlab

The title of the "depth" axis.

cl

The confidence level for the confidence ellipsoids. Defaults to 0.95.

add_ori

Logical specifying whether to add lines through the origin. Defaults to TRUE.

...

Further arguments passed to or from other methods.

Value

A 3D plot window containing the output of a correspondence regression.

Details

plot3d (of a corregp output) makes use of plot3d (and text3d and abclines3d) from the package rgl.

See Also

corregp, pcplot.corregp, agplot.corregp, plot3d.

Examples

# NOT RUN {
data(HairEye)
haireye.crg <- corregp(Eye ~ Hair * Sex, data = HairEye, b = 3000)
plot3d(haireye.crg, x_ell = TRUE, xsub = c("Hair", "Sex"))
# }