Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!
Get Started for Free

seqivolatility

Volatility of individual state sequences


Description

Returns Brzinsky-Fay's objective volatility of each sequence.

Usage

seqivolatility(seqdata, w=.5, with.missing=FALSE, adjust=TRUE)

Arguments

seqdata

a state sequence object (stslist) as returned by seqdef.

adjust

Logical. Should the indicator be adjusted such that it can reach its bounds 0 and 1. Deafult is TRUE (see Details).

w

real in the range [0, 1]. Weight given to the proportion of states visited (see Details).

with.missing

logical: should non-void missing values be treated as a regular state? If FALSE (default) missing values are ignored.

Details

The (objective) volatility is the weighted average between the proportion pvisited of states visited and the frequency ftrans of transitions (state changes). Formally,

volatility = w * pvisited + (1-w) * ftrans

The proportion of states visited is computed as (visited - 1)/(|a| - 1) when adjsut=TRUE and as visited / |a| when adjsut=FALSE. Here, visited is the number of states visited and |a| the size of the alphabet.

The frequency of transition is ftrans = \frac{transn}{max.transn} where transn is the number of transitions (state changes) within the sequence, and max.transn the maximum possible transitions in the sequence.

For the normative volatility computed for a set of positive states, see seqipos.

Value

A numeric vector with the volatility of each sequence.

Author(s)

Gilbert Ritschard

References

Brzinsky-Fay, C. Unused Resources: Sequence and Trajectory Indicators. International Symposium on Sequence Analysis and Related Methods, Monte Verita, TI, Switzerland, Oct 10-11, 2018

See Also

Examples

data(ex1)
sx <- seqdef(ex1[,1:13], right="DEL")

seqivolatility(sx)
seqivolatility(sx, adjust=FALSE)
seqivolatility(sx, with.missing=TRUE)
seqivolatility(sx, w=.7, with.missing=TRUE)

TraMineR

Trajectory Miner: a Toolbox for Exploring and Rendering Sequences

v2.2-1
GPL (>= 2)
Authors
Alexis Gabadinho [aut, cph], Matthias Studer [aut, cph] (<https://orcid.org/0000-0002-6269-1412>), Nicolas M"{u}ller [aut], Reto B"{u}rgin [aut], Pierre-Alexandre Fonta [aut], Gilbert Ritschard [aut, cre, cph] (<https://orcid.org/0000-0001-7776-0903>)
Initial release
2020-10-24

We don't support your browser anymore

Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.