wmst: Comparing window mean survival time

wmstR Documentation

Comparing window mean survival time

Description

Performs two-sample comparisons using the window mean survival time (WMST) as a summary measure of the survival time distribution. Three kinds of between-group contrast metrics (i.e., the difference in WMST, the ratio of WMST and the ratio of the window mean time lost (WMTL)) are computed. The Greenwood plug-in estimator is used for the asymptotic variance.

Usage

wmst(time, status, arm, tau0 = NULL, tau1 = NULL, alternative = "two.sided", alpha = 0.05)

Arguments

time

The follow-up time for right censored data.

status

The status indicator, 1=event, and 0=right censored.

arm

The group indicator for comparison. The elements of this vector take either 1 or 0. Normally, 0=control group, 1=active treatment group.

tau0

A scaler value to specify the lower truncation time point of the window for the WMST calculation. tau0 needs to be at least 0 and smaller than tau1. When tau0 = NULL, the default value 0 is used (i.e., the lower bound for restricted mean survival analysis).

tau1

A scaler value to specify the upper truncation time point of the window for the WMST calculation. tau1 needs to be smaller than the minimum of the largest observed time in each of the two groups. When tau1 = NULL, the default value (i.e., the minimum of the largest observed time in each of the two groups) is used.

alternative

Determines the sidedness of the alternative hypothesis. The default is "two.sided" which performs a two-tailed hypothesis test. If set to "greater" an upper-tailed test is performed. If set to "less" a lower-tailed test is performed.

alpha

The default is 0.05. (1-alpha) confidence intervals are reported.

Details

For more details, please see the package vignette: browseVignettes(package = "survWMST")

Value

an object of class wmst.

tau0

the lower truncation time used in the analyses

tau1

the upper truncation time used in the analyses

note

a note regarding the truncation time

WMST.arm1

WMST results in arm 1.

WMST.arm0

WMST results in arm 0.

result

Results of the WMST analyses.

Author(s)

Mitchell Paukner

References

Note to self: figure out what to place here! (Definitely give Hajime Uno, Lu Tian, Miki Horiguchi, Angel Cronin, Chakib Battioui, James Bell credit)


pauknemj/survWM2 documentation built on March 21, 2023, 5:29 a.m.