Bar plot of measures of local association of a crosstabulation
ggassoc_phiplot.RdFor a cross-tabulation, plots the measures of local association with bars of varying height, using ggplot2.
ggassoc_phiplot(data, mapping, measure = "phi",
limit = NULL, sort = "none",
na.rm = FALSE, na.value = "NA")Arguments
- data
dataset to use for plot
- mapping
aesthetics being used. x and y are required, weight can also be specified.
- measure
character. The measure of association used for filling the rectangles. Can be "phi" for phi coefficient (default), "or" for odds ratios, "std.residuals" for standardized residuals, "adj.residuals" for adjusted standardized residuals or "pem" for local percentages of maximum deviation from independence.
- limit
numeric value, specifying the upper limit of the scale for the height of the bars, i.e. for the measures of association (the lower limit is set to 0-limit). It corresponds to the maximum absolute value of association one wants to represent in the plot. If NULL (default), the limit is automatically adjusted to the data.
- sort
character. If "both", rows and columns are sorted according to the first factor of a correspondence analysis of the contingency table. If "x", only rows are sorted. If "y", only columns are sorted. If "none" (default), no sorting is done.
- na.rm
logical, indicating whether NA values should be silently removed before the computation proceeds. If FALSE (default), an additional level is added to the variables (see na.value argument).
- na.value
character. Name of the level for NA category. Default is "NA". Only used if na.rm = FALSE.
Details
The measure of association measures how much each combination of categories of x and y is over/under-represented. The bars vary in width according to the number of observations in the categories of the column variable. They vary in height according to the measure of association. Bars are black if the association is positive and white if it is negative.
The genuine version of this plot (see Cibois, 2004) uses the measure of association called "pem", i.e. the local percentages of maximum deviation from independence.
This function can be used as a high-level plot with ggduo and ggpairs functions of the GGally package.
Value
a ggplot object
References
Cibois Philippe, 2004, Les écarts à l'indépendance. Techniques simples pour analyser des données d'enquêtes, Collection "Méthodes quantitatives pour les sciences sociales"
