delta.t.surv.estimate: Calculates robust residual treatment effect accounting only...

In laylaparast/Rsurrogate: Robust Estimation of the Proportion of Treatment Effect Explained by Surrogate Marker Information

Calculates robust residual treatment effect accounting only for primary outcome information up to a specified time

Description

This function calculates the robust estimate of the residual treatment effect accounting only for primary outcome information up to t_0 i.e. the hypothetical treatment effect if survival up to t_0 in the treatment group looks like survival up to t_0 in the control group. Ideally this function is only used as a helper function and is not directly called.

Usage

delta.t.surv.estimate(xone, xzero, deltaone, deltazero, t, weight.perturb = NULL,
landmark, approx = T)

Arguments

xone	numeric vector, the observed event times in the treatment group, X = min(T,C) where T is the time of the primary outcome and C is the censoring time.
xzero	numeric vector, the observed event times in the control group, X = min(T,C) where T is the time of the primary outcome and C is the censoring time.
deltaone	numeric vector, the event indicators for the treatment group, D = I(T<C) where T is the time of the primary outcome and C is the censoring time.
deltazero	numeric vector, the event indicators for the control group, D = I(T<C) where T is the time of the primary outcome and C is the censoring time.
t	the time of interest.
weight.perturb	weights used for perturbation resampling.
landmark	the landmark time t_0 or time of surrogate marker measurement.
approx	TRUE or FALSE indicating whether an approximation should be used when calculating the probability of censoring; most relevant in settings where the survival time of interest for the primary outcome is greater than the last observed event but before the last censored case, default is TRUE.

Details

Details are included in the documentation for R.t.surv.estimate.

Value

\hat{Δ}_T(t,t_0), the robust residual treatment effect estimate accounting only for survival up to t_0.

Note

If the treatment effect is not significant, the user will receive the following message: "Warning: it looks like the treatment effect is not significant; may be difficult to interpret the residual treatment effect in this setting". If the treatment effect is negative, the user will receive the following message: "Warning: it looks like you need to switch the treatment groups" as this package assumes throughout that larger values of the event time are better.

Author(s)

Layla Parast

References

Parast, L., Cai, T., & Tian, L. (2017). Evaluating surrogate marker information using censored data. Statistics in Medicine, 36(11), 1767-1782.

Examples

data(d_example_surv)
names(d_example_surv)

laylaparast/Rsurrogate documentation built on Sept. 28, 2022, 12:25 p.m.