surv2sample {surv2sampleComp}R Documentation

Inference of model-free between-group contrasts with censored survival data

Description

Performs inference of several model-free group contrast measures, which include difference/ratio of cumulative incidence rates, quantiles, restricted mean survival times (RMST), and integrated survival rates.

Usage

surv2sample(time, status, arm, npert=1000,
                    timepoints=c(12, 24, 36, 40), quanprobs=c(0.1, 0.15, 0.2),
                    tau_start=0, tau, SEED=NULL, procedure="KM", conf.int=0.95)

Arguments

time

The follow-up time.

status

The censoring indicator, 1=event, and 0=censoring.

arm

The indicator for groups to compare 1/0.

npert

The number of resampling. The default is 1000.

timepoints

specifies the time points at which difference and ratio of the survival rates are computed.

quanprobs

specifies the probabilities at which difference and ratio of the corresponding quantiles are computed.

tau_start

The value indicates time point on the follow-up time to calculate the restricted mean survival time beyond the time point. The default is 0.

tau

The value indicates the restricted time point on the follow-up time to calculate the restricted mean survival time. (i.e., the minimum of the largest observed time in each of the two groups)

SEED

A random seed used for the resampling. Default is NULL.

procedure

Specifies the inference procedure. A non-parametric procedure by the method of Kaplan-Meier ("KM") is the default. Another option is a parametric inference procedure by fitting a generalized gamma distribution to each group ("GG").

conf.int

The level for computation of the confidence intervals. The default is 0.95.

Author(s)

Hajime Uno, Miki Horiguchi

References

Tian L, Zhao L, Wei LJ. Predicting the restricted mean event time with the subject's baseline covariates in survival analysis. Biostatistics 2014, 15, 222-233.

Zhao L, Tian L, Uno H, Solomon S, Pfeffer M, Schindler J, Wei LJ. Utilizing the integrated difference of two survival functions to quantify the treatment contrast for designing, monitoring, and analyzing a comparative clinical study. Clinical Trials 2012, 9, 570-577.

Examples

D=pbc.sample()
surv2sample(D$time, D$status, D$group, npert=500, timepoints=c(2,4,6,8),
quanprobs =c(0.2, 0.3), tau=8, procedure="KM")

[Package surv2sampleComp version 1.0-5 Index]