soc.ca (version 0.8.0)

map.active: Map the active modalities

Description

Creates a map of the active modalities on two selected dimensions.

Usage

map.active(
  object,
  dim = c(1, 2),
  point.shape = "variable",
  point.alpha = 0.8,
  point.fill = "whitesmoke",
  point.color = "black",
  point.size = "freq",
  label = TRUE,
  label.repel = FALSE,
  label.alpha = 0.8,
  label.color = "black",
  label.size = 4,
  label.fill = NULL,
  map.title = "active",
  labelx = "default",
  labely = "default",
  legend = NULL
)

Arguments

object

a soc.ca class object as created by soc.mca and soc.csa

dim

the dimensions in the order they are to be plotted. The first number defines the horizontal axis and the second number defines the vertical axis.

point.shape

a numerical value defining the shape of the points. If set to its default, the default scale is used. It may be mapped to a variable with a suitable length and order.

point.alpha

defines the alpha of the points. Values range from 0 to 1. It may be mapped to a variable with a suitable length and order.

point.fill

defines the fill color of the points. It may be mapped to a variable with a suitable length and order.

point.color

defines the color of the points. It may be mapped to a variable with a suitable length and order. See colors for some of the valid values.

point.size

a numerical value defining the size of the points. If set to its default, the size is determined by the frequency of each modality. It may be defined by a variable with a suitable length.

label

if TRUE each point is assigned its label, defined in the soc.ca object. See assign.label and add.to.label for ways to alter the labels.

label.repel

if TRUE overlapping labels are rearranged, see geom_text_repel or geom_label_repel.

label.alpha

defines the alpha of the labels. Values range from 0 to 1. It may be mapped to a variable with a suitable length and order.

label.color

defines the color of the labels. It may be mapped to a variable with a suitable length and order. See colors for some of the valid values.

label.size

defines the size of the labels. It may be mapped to a variable with a suitable length and order.

label.fill

defines the color of the box behind the labels. It may be mapped to a variable with a suitable length and order. This only works if label.repel is TRUE. See geom_label_repel.

map.title

the title of the map. If set to its default the standard title is used.

labelx

the label of the horizontal axis. If set to NULL a standard label is used.

labely

the label of the vertical axis. If set to NULL a standard label is used.

legend

if set to TRUE a legend is provided. Change the legend with the guides, theme and linkguide_legend functions from the ggplot2 package.

Examples

# NOT RUN {
example(soc.ca)
map.active(result)
map.active(result, dim = c(2, 1))
map.active(result, point.size = result$ctr.mod[, 1],
 map.title = "All active modalities with size according to contribution")
# }