R: Define transition matrix for multi-state model

transMat {mstate} | R Documentation

## Define transition matrix for multi-state model

### Description

Define transition matrices for multi-state model. Specific functions for defining such transition matrices are pre-defined for common multi-state models like the competing risks model and the illness-death model.

### Usage

    transMat(x, names)
    trans.comprisk(K, names)
    trans.illdeath(names)

### Arguments

`x` | List of possible transitions; x[[i]] consists of a vector of state numbers reachable from state i
`K` | The number of competing risks
`names` | A character vector containing the names of either the competing risks or the states in the multi-state model specified by the competing risks or illness-death model. `names` should have the same length as the list `x` (for `transMat`), or either `K` or `K`+1 (for `trans.comprisk`), or 3 (for `trans.illdeath`)

### Details

If `names` is missing, the names `"eventfree"`, `"cause1"`, etcetera are assigned in `trans.comprisk`, or `"healthy"`, `"illness"`, `"death"` in `trans.illdeath`.

### Value

A transition matrix describing the states and transitions in the multi-state model.

### Author(s)

Steven McKinney <smckinney@bccrc.ca>; Hein Putter <H.Putter@lumc.nl>

### Examples

    transMat(list(c(2, 3), c(), c(1, 2)),
    	names = c("Disease-free", "Death", "Relapsed"))
    tmat <- transMat(x = list( c(2, 3), c(1, 3), c() ),
                     names = c("Normal", "Low", "Death"))
    tmat
    transListn <- list("Normal" = c(2, 3), "Low" = c(1, 3), "Death" = c())
    transMat(transListn)
    trans.comprisk(3)
    trans.comprisk(3,c("c1","c2","c3"))
    trans.comprisk(3,c("nothing","c1","c2","c3"))
    trans.illdeath()
    trans.illdeath(c("nothing","ill","death"))

[Package mstate version 0.2.12 Index]