R: Plot method for objects produced by the seqstatd function

plot.stslist.statd {TraMineR} | R Documentation

## Plot method for objects produced by the seqstatd function

### Description

This is the plot method for output produced by the `seqstatd` function, i.e for objects of class stslist.statd.

### Usage

    ## S3 method for class 'stslist.statd'
    plot(x, type = "d", cpal = NULL, ylab = NULL,
      yaxis = TRUE, xaxis = TRUE, xtlab = NULL, xtstep = NULL, tick.last = NULL,
      cex.axis = 1, space = 0, xlab = NULL, cex.plot, ...)

### Arguments

`x` | an object of class `stslist.statd` as produced by the `seqstatd` function.
`type` | if `"d"` (default), a state distribution plot is produced. If `"Ht"` an entropy index plot is produced.
`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.
`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 input `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`.
`space` | the space between the stacked bars. Default is 0, i.e. no space.
`xlab` | Optional title for the x axis. See `title`.
`cex.plot` | Deprecated. Use `cex.axis` instead.
`...` | further graphical parameters such as `border=NA` to remove the borders of the bars. For more details about the graphical parameter arguments, see `barplot` and `par`.

### Details

This is the plot method for the output produced by the `seqstatd` function, i.e. for objects of class stslist.statd. If `type="d"` it produces a state distribution plot presenting the sequence of the transversal state frequencies at each successive (time) position, as computed by the `seqstatd` function. With `type="Ht"`, the series of entropies of the transversal state distributions is plotted.

This method is called by the generic `seqplot` function (if `type="d"` or `type="Ht"`) that produces more sophisticated plots, allowing grouping and automatic display of the state color legend. The `seqdplot` and `seqHtplot` functions are shortcuts for calling `seqplot` with `type="d"` or `type="Ht"` respectively.

### Value

The plotted values, i.e. for `type="d"` the cross-sectional distributions, and for `type="Ht"` the cross-sectional entropies.

### Examples

    ## Defining a sequence object with the data in columns 10 to 25
    ## (family status from age 15 to 30) in the biofam data set
    data(biofam)
    biofam.lab <- c("Parent", "Left", "Married", "Left+Marr",
    "Child", "Left+Child", "Left+Marr+Child", "Divorced")
    biofam.seq <- seqdef(biofam, 10:25, labels=biofam.lab)

    ## State distribution
    biofam.statd <- seqstatd(biofam.seq)

    ## State distribution plot (default type="d" option)
    plot(biofam.statd)

    ## Entropy index plot
    plot(biofam.statd, type="Ht")

[Package TraMineR version 2.2-3 Index]