# transMat: Define transition matrix for multi-state model In hputter/mstate: Data Preparation, Estimation and Prediction in Multi-State Models

 transMat 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)
``````

### Arguments

 `x` List of possible transitions; x[[i]] consists of a vector of state numbers reachable from state i `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"))

``````

hputter/mstate documentation built on July 15, 2024, 11:18 p.m.