plot.stslist.freq: Plot method for sequence frequency tables

View source: R/plot.stslist.freq.R

plot.stslist.freqR Documentation

Plot method for sequence frequency tables

Description

Plot method for output produced by the seqtab function, i.e objects of class stslist.freq.

Usage

## S3 method for class 'stslist.freq'
plot(x, cpal = NULL, missing.color = NULL, pbarw = TRUE,
  ylab = NULL, yaxis = TRUE, xaxis = TRUE,
  xtlab = NULL, xtstep = NULL, tick.last = NULL, cex.axis = 1,
  cex.plot, ...)

Arguments

x

an object of class stslist.freq as produced by the seqtab function.

cpal

alternative color palette to be used for the states. If user specified, a vector of colors with number of elements equal to the number of states in the alphabet. By default, the 'cpal' attribute of the x object is used.

missing.color

alternative color for representing missing values inside the sequences. By default, this color is taken from the missing.color attribute of the x object.

pbarw

if pbarw=TRUE (default), the width of the bars are proportional to the sequence frequency in the dataset.

ylab

an optional label for the y axis. If set to NA, no label is drawn.

yaxis

if TRUE or "cum", the y axis is plotted with a label showing the cumulated percentage frequency of the displayed sequences. If "pct", the percentage value for each sequence is displayed.

xaxis

if TRUE (default) the x-axis is plotted.

xtlab

optional labels for the ticks of the x-axis. If unspecified, the names attribute of the x object is used.

xtstep

optional interval at which the tick-marks and labels of the x-axis are displayed. For example, with xtstep=3 a tick-mark is drawn at position 1, 4, 7, etc... The display of the corresponding labels depends on the available space and is dealt with automatically. If unspecified, the xtstep attribute of the x object is used.

tick.last

Logical. Should a tick mark be enforced at the last position on the x-axis? If unspecified, the tick.last attribute of the x object is used.

cex.axis

Axis annotation magnification. See par.

...

further graphical parameters. For example border=NA to remove the bars borders, space=0 to remove space between sequences. For more details about the graphical parameter arguments, see barplot and par.

cex.plot

Deprecated. Use cex.axis instead.

Details

This is the plot method for the output produced by the seqtab function, i.e. objects of class stslist.freq. It produces a plot showing the sequences sorted bottom up according to their frequency in the data set.

This method is called by the generic seqplot function (if type="f") that produces more sophisticated plots, allowing grouping and automatic display of the state color legend. The seqfplot function is a shortcut for calling seqplot with type="f".

Author(s)

Alexis Gabadinho

Examples

## Loading the 'actcal' example data set
data(actcal)

## Defining a sequence object with data in columns 13 to 24
## (activity status from january to december 2000)
actcal.lab <- c("> 37 hours", "19-36 hours", "1-18 hours", "no work")
actcal.seq <- seqdef(actcal, 13:24, labels=actcal.lab)

## 10 most frequent sequences in the data
actcal.freq <- seqtab(actcal.seq)

## Plotting the object
plot(actcal.freq, main="Sequence frequencies - actcal data set")

## Plotting all the distinct sequences without borders
## and space between sequences
actcal.freq2 <- seqtab(actcal.seq, idxs=0)
plot(actcal.freq2, main="Sequence frequencies - actcal data set",
  border=NA, space=0)

TraMineR documentation built on Sept. 19, 2023, 1:07 a.m.