R: Cut a multi-state data set at a landmark time point

cutLMms {mstate} | R Documentation

## Cut a multi-state data set at a landmark time point

### Description

Given a dataset in long format, for instance generated by `msprep`, this function cuts a multi-state data frame (object of type "msdata") at a landmark time point LM. Administrative censoring can be applied at time `cens`, equal for all individuals.

### Usage

    cutLMms(msdata, LM, cens)

### Arguments

`msdata` | An object of class `"msdata"`, such as output by `msprep`
`LM` | The landmark time point at which the cut is to be made
`cens` | The time point at which administrative censoring is to be applied; if missing, no administrative censoring will be applied

### Details

The function has a similar purpose as the `cutLM` function in the `dynpred` package. Only follow-up after a landmark time point LM is considered, so all subjects who are no longer at risk are removed. Column `time` is updated based on the new Tstart and Tstop.

### Value

An object of class `"msdata"` again, containing only follow-up data after LM. The data frame contains an extra column `Tentry` with the time of entry into the present state.

### Author(s)

Hein Putter H.Putter@lumc.nl

### References

L. C. de Wreede, M. Fiocco, and H. Putter (2011). mstate: An R Package for the Analysis of Competing Risks and Multi-State Models. Journal of Statistical Software 38: 7.

### Examples

    tmat <- trans.illdeath(names=c("Tx","PR","RelDeath"))
    data(ebmt3) # data from Section 4 of Putter, Fiocco & Geskus (2007)
    msebmt <- msprep(time=c(NA,"prtime","rfstime"),status=c(NA,"prstat","rfsstat"),
    		data=ebmt3,trans=tmat)
    # Cut at 5 years
    cutLMms(msebmt, LM=1826)
    events(cutLMms(msebmt, LM=1826))

[Package mstate version 0.3.1 Index]