Skip to contents

Build a Factor Map

Usage

viz_points(
  x,
  margin,
  axes,
  ...,
  active = TRUE,
  sup = TRUE,
  labels = list(how = "contribution", n = 10),
  highlight = NULL,
  color = NULL,
  symbol = 16,
  size = c(1, 3),
  xlim = NULL,
  ylim = NULL,
  main = NULL,
  sub = NULL,
  xlab = NULL,
  ylab = NULL,
  ann = graphics::par("ann"),
  frame.plot = TRUE,
  panel.first = NULL,
  panel.last = NULL,
  legend = list(x = "topleft")
)

Arguments

x

A CA, MCA or PCA object.

margin

A length-one numeric vector giving the subscript which the data will be returned: 1 indicates individuals/rows (the default), 2 indicates variables/columns.

axes

A length-two numeric vector giving the dimensions to be plotted.

...

Currently not used.

active

A logical scalar: should the active observations be plotted?

sup

A logical scalar: should the supplementary observations be plotted?

labels

A logical scalar: should labels be drawn? Labeling a large number of points can be computationally expensive and make the graph difficult to read. A selection of points to label can be provided using a list of two named elements, how (a string specifying how to select the labels to be drawn) and n (an integer specifying the number of labels to be drawx). See examples below.

highlight

A vector specifying the information to be highlighted. If NULL (the default), no highlighting is applied. If a single character string is passed, it must be the name of a categorical variable, or one of "observation", "mass", "sum", "contribution" or "cos2" (see augment()).

color

The colors for lines and points (will be mapped to highlight).

symbol

A vector of plotting characters or symbols.

size

A length-two numeric vector giving range of possible sizes (greater than 0; (will be mapped to highlight).

xlim

A length-two numeric vector giving the x limits of the plot. The default value, NULL, indicates that the range of the finite values to be plotted should be used.

ylim

A length-two numeric vector giving the y limits of the plot. The default value, NULL, indicates that the range of the finite values to be plotted should be used.

main

A character string giving a main title for the plot.

sub

A character string giving a subtitle for the plot.

xlab, ylab

A character vector giving the x and y axis labels.

ann

A logical scalar: should the default annotation (title and x and y axis labels) appear on the plot?

frame.plot

A logical scalar: should a box be drawn around the plot?

panel.first

An expression to be evaluated after the plot axes are set up but before any plotting takes place. This can be useful for drawing background grids.

panel.last

An expression to be evaluated after plotting has taken place but before the axes, title and box are added.

legend

A list of additional arguments to be passed to graphics::legend(); names of the list are used as argument names. If NULL, no legend is displayed.

Author

N. Frerebeau