R: Plot method for sequence frequency tables

plot.stslist.freq {TraMineR} | R 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)

[Package TraMineR version 2.2-2 Index]