GDAtools (version 1.5)

ggadd_supvar: Adds a categorical supplementary variable to a MCA cloud of variables

Description

Adds a categorical supplementary variable to a MCA cloud of variables, using the ggplot2 framework.

Usage

ggadd_supvar(p, resmca, var, sel=1:nlevels(var), axes=c(1,2), col='black',
shape=1, prop=NULL, textsize=3, segment=TRUE, vname=NULL)

Arguments

p

ggplot object with the cloud of variables

resmca

object of class 'MCA', 'speMCA' or 'csMCA'.

var

Factor. The categorical supplementary variable. It does not need to have been used at the MCA step.

sel

Numeric vector of indexes of the categories of the supplementary variable to be added to the plot. By default, labels are plotted for every categories.

axes

numeric vector of length 2, specifying the components (axes) to plot. Default is c(1,2).

col

Character. Color of the shapes and labels of the categories. Default is black.

shape

Symbol to be used in addition the the labels of categories (default is 1). If NULL, only labels are plotted.

prop

If NULL, the size of the labels (if shape=NULL) or the shapes (otherwise) is constant. If 'n', the size is proportional the the weights of categories; if 'vtest1', the size is proportional to the test values of the categories on the first dimension of the plot; if 'vtest2', the size is proportional to the test values of the categories on the second dimension of the plot; if 'cos1', the size is proportional to the cosines of the categories on the first dimension of the plot; if 'cos2', the size is proportional to the cosines of the categories on the second dimension of the plot; if 'cos12', the size is proportional to the total cosines of the categories on the two dimensions of the plot.

textsize

Size of the labels of categories if shape is not NULL, or if shape=NULL and prop=NULL. Default is 3.

segment

Logical. Should one add lines between categories ? Default is TRUE.

vname

A character string to be used as a prefix for the labels of the categories. If NULL (default), no prefix is added.

Value

a ggplot object

References

Le Roux B. and Rouanet H., Multiple Correspondence Analysis, SAGE, Series: Quantitative Applications in the Social Sciences, Volume 163, CA:Thousand Oaks (2010).

Le Roux B. and Rouanet H., Geometric Data Analysis: From Correspondence Analysis to Stuctured Data Analysis, Kluwer Academic Publishers, Dordrecht (June 2004).

See Also

ggcloud_variables, ggcloud_indiv, ggadd_ellipses, ggadd_interaction

Examples

# NOT RUN {
## Performs a specific MCA on 'Music' example data set
## ignoring every 'NA' (i.e. 'not available') categories,
## draws the cloud of categories
## and adds Age as a supplementary variable.
data(Music)
getindexcat(Music[,1:5])
mca <- speMCA(Music[,1:5],excl=c(3,6,9,12,15))
p <- ggcloud_variables(mca, palette='lightgrey', shapes=FALSE)
ggadd_supvar(p, mca, Music$Age)
# }