alphabet: Get or set the alphabet of a sequence object

Description

This function gets or sets the (short) labels associated to the states in the alphabet of a sequence object (the list of all possible states, some of which states may not appear in the data).

Usage

alphabet(seqdata)
alphabet(seqdata) <- value

Arguments

seqdata

a sequence object as defined with the seqdef function.

value

a character vector of the same length as returned by the alphabet function (one label for each state in the alphabet).

Value

For 'alphabet' a character vector containing the alphabet.
For 'alphabet<-' the updated sequence object.

Details

A sequence object as defined with the seqdef function stores sequences as a matrix where columns are factors. The levels of the factors are made of the alphabet as well as the codes for missing value and void elements. The alphabet function retrieves or sets the attribute of the sequence object named "alphabet". The states composing the alphabet are preferably short labels, since they are used when printing the sequences. Longer labels used to describe more precisely each state are stored in the "labels" attribute of the sequence object.

Examples

Run this code

## Creating a sequence object with the columns 13 to 24 
## in the 'actcal' example data set
data(actcal)
actcal.seq <- seqdef(actcal,13:24)

## Retrieving the alphabet
alphabet(actcal.seq)

## Setting the alphabet
alphabet(actcal.seq) <- c("FT", "PT", "LT", "NO")