plot.CAvariants: Main plot function

Description Usage Arguments Details Note Author(s) References Examples

View source: R/plot.CAvariants.R

Description

This function produces the graphical display for the selected variant of correspondence analysis. When catype = "CA" catype = "NSCA" and plottype = "classic", the function produces a plot of the principal coordinates for the row and column categories.
When plottype = "biplot", it produces a biplot graphical display, or a polynomial biplot in case of ordered variables. For an ordered analysis only the polynomial biplots are constructed. In particular, for the singly ordered variants only the row isometric polynomial biplot is appropriate. When the parameter catype defines an ordered variant of CA, the input parameter plottype should be equal to plottype = "biplot". If biptype = "row", it will produce a row isometric polynomial biplot.

Usage

1
2
3
4
5
## S3 method for class 'CAvariants'
plot(x, firstaxis = 1, lastaxis = 2, cex = 0.8, 
cex.lab = 0.8, prop = 1,  plottype = "biplot", biptype = "row",  
scaleplot = 1, posleg = "topleft", pos = 2, ell = FALSE, M = x$M, 
alpha = 0.05, plot3d = FALSE, size = 5, adj = c(0,0.5),...)

Arguments

x

The name of the output object used with the main function CAvariants.

firstaxis

The horizontal polynomial, or principal, axis. By default, firstaxis = 1.

lastaxis

The vertical polynomial, or principal, axis. By default, lastaxis = 2.

cex

The parameter for setting the size of the character labels for the points in a graphical display. By default, cex = 0.8.

cex.lab

The parameter for setting the size of the character labels of axes in graphical displays. By default, cex.lab = 0.8.

prop

The scaling parameter for specifying the limits of the plotting area. By default, prop = 1.

plottype

The type of graphical display required (either a correspondence plot or a biplot). The type of graphical display to be constructed. By default, plottype = "biplot"; the alternative is plottype = "classic".

biptype

The parameter for specifying the type of biplot. By default, biptype = "row". One may specify a row-isometric biplot (biptype = "row") or a column-isometric biplot (biptype = "column"). This feature is available for the nominal symmetrical and non-symmetrical correspondence analyses. By default, a row-isometric biplot, biptype = "row", is produced.

scaleplot

The parameter for scaling the biplot coordinates. See Gower et al. (2011), section 2.3.1, or page 135 of Beh and Lombardo (2014). By default, scaleplot = 1.

posleg

The position of the legend when portraying trends of the categories for ordered variants of correspondence analysis. By default, posleg = "topleft".

pos

The parameter that specifies the position of label of each point in the graphical display. By default, pos = 2.

ell

The logical parameter which specifies whether algebraic confidence ellipses are to be included in the plot or not. Setting the input parameter to ell = TRUE will assess the statistical significance of each category to the association between the variables. By default, ell = FALSE.

M

The number of axes considered in determining the structure of the elliptical confidence regions. By default, M = min(nrow(Xtable), ncol(Xtable)) - 1, i.e. the rank of the data matrix.

alpha

The confidence level of the elliptical regions. By default, alpha = 0.05.

plot3d

The logical parameter specifies whether a 3D plot is to be included in the output or not. By default, plot3d = FALSE.

size

The size of the plotting area. By default, size = 5.

adj

One or two values in the interval [0, 1] that specifies the x (and optionally y) position of the label categories. By default, adj = c(0, 0.5).

...

Further arguments passed to, or from, other functions.

Details

It produces either a classical or biplot graphical display. Further, when catype = "DOCA", catype = "SOCA", catype = "DONSCA" or catype = "SONSCA", the trends of the row and column variables (after the reconstruction of column profiles by the polynomials) is portrayed.
For classical biplot displays, it superimposes the algebraic confidence ellipses. It uses the secondary plot function caellipse (or nscaellipse) for the symmetrical (or non symmetrical) CA variants.

Note

For the classical plots, row and column principal coordinates are plotted. For biplots, one set of coordinates is the standard coordinates and the other is the principal coordinates. When an ordered variant of correspondence analysis is performed, the biplot is constructed where one set of coordinates consists of the standard polynomial coordinates and the other one is the principal polynomial coordinates.

Author(s)

Rosaria Lombardo and Eric J Beh

References

Beh EJ and Lombardo R 2014 Correspondence Analysis: Theory, Practice and New Strategies. Wiley.
Gower J, Lubbe S, and le Roux, N 2011 Understanding Biplots. Wiley.
Lombardo R Beh EJ 2016 Variants of Simple Correspondence Analysis. The R Journal, 8 (2), 167–184.
Lombardo R Beh EJ and Kroonenberg PM 2016 Modelling Trends in Ordered Correspondence Analysis Using Orthogonal Polynomials. Psychometrika, 81(2), 325–349.

Examples

1
2
3
4
5
data(asbestos)
resasbestos<-CAvariants(asbestos, catype = "CA", firstaxis = 1, lastaxis = 2) 
plot(resasbestos, plottype = "classic", plot3d = TRUE)
plot(resasbestos, plottype = "biplot", biptype = "column", ell = TRUE)
plot(resasbestos, plottype = "classic", ell = TRUE)

CAvariants documentation built on Jan. 14, 2019, 5:04 p.m.