View source: R/Single.Trial.RE.AA.R
Single.Trial.RE.AA | R Documentation |
The function Single.Trial.RE.AA
conducts a surrogacy analysis based on the single-trial meta-analytic framework of Buyse & Molenberghs (1998). See Details below.
Single.Trial.RE.AA(Dataset, Surr, True, Treat, Pat.ID, Alpha=.05,
Number.Bootstraps=500, Seed=sample(1:1000, size=1))
Dataset |
A |
Surr |
The name of the variable in |
True |
The name of the variable in |
Treat |
The name of the variable in |
Pat.ID |
The name of the variable in |
Alpha |
The |
Number.Bootstraps |
The number of bootstrap samples that are used to obtain the bootstrapp-based confidence intervals for RE and the adjusted association ( |
Seed |
The seed that is used to generate the bootstrap samples. Default |
The Relative Effect (RE) and the adjusted association (\gamma
) are based on the following bivariate regression model (when the surrogate and the true endpoints are continuous variables):
S_{j}=\mu_{S}+\alpha Z_{j}+\varepsilon_{Sj},
T_{j}=\mu_{T}+\beta Z_{j}+\varepsilon_{Tj},
where the error terms have a joint zero-mean normal distribution with variance-covariance matrix:
\boldsymbol{\Sigma}=\left(\begin{array}{cc}
\sigma_{SS}\\
\sigma_{ST} & \sigma_{TT}
\end{array}\right),
and where j
is the subject indicator, S_{j}
and T_{j}
are the surrogate and true endpoint values of patient j
, and Z_{j}
is the treatment indicator for patient j
.
The parameter estimates of the fitted regression model and the variance-covariance matrix of the residuals are used to compute RE and the adjusted association (\gamma
), respectively:
RE=\frac{\beta}{\alpha},
\gamma=\frac{\sigma_{ST}}{\sqrt{\sigma_{SS}\sigma_{TT}}}.
Note
The single-trial meta-analytic framework is hampered by a number of issues (Burzykowski et al., 2005). For example, a key motivation to validate a surrogate endpoint is to be able to predict the effect of Z on T as based on the effect of Z on S in a new clinical trial where T is not (yet) observed. The RE allows for such a prediction, but this requires the assumption that the relation between \alpha
and \beta
can be described by a linear regression model that goes through the origin. In other words, it has to be assumed that the RE remains constant across clinical trials. The constant RE assumption is unverifiable in a single-trial setting, but a way out of this problem is to combine the information of multiple clinical trials and generalize the RE concept to a multiple-trial setting (as is done in the multiple-trial meta-analytic approach, see UnifixedContCont
, BifixedContCont
, UnimixedContCont
, and BimixedContCont
).
An object of class Single.Trial.RE.AA
with components,
Data.Analyze |
Prior to conducting the surrogacy analysis, data of patients who have a missing value for the surrogate and/or the true endpoint are excluded. |
Alpha |
An object of class |
Beta |
An object of class |
RE.Delta |
An object of class |
RE.Fieller |
An object of class |
RE.Boot |
An object of class |
AA |
An object of class |
AA.Boot |
An object of class |
RE.Boot.Samples |
A vector that contains the RE values that were generated during the bootstrap procedure. |
AA.Boot.Samples |
A vector that contains the adjusted association (i.e., |
Cor.Endpoints |
A |
Residuals |
A |
Wim Van der Elst, Ariel Alonso, & Geert Molenberghs
Burzykowski, T., Molenberghs, G., & Buyse, M. (2005). The evaluation of surrogate endpoints. New York: Springer-Verlag.
Buyse, M., & Molenberghs, G. (1998). The validation of surrogate endpoints in randomized experiments. Biometrics, 54, 1014-1029.
Buyse, M., Molenberghs, G., Burzykowski, T., Renard, D., & Geys, H. (2000). The validation of surrogate endpoints in meta-analysis of randomized experiments. Biostatistics, 1, 49-67.
Kutner, M. H., Nachtsheim, C. J., Neter, J., & Li, W. (2005). Applied linear statistical models (5th ed.). New York: McGraw Hill.
UnifixedContCont
, BifixedContCont
, UnimixedContCont
, BimixedContCont
, ICA.ContCont
## Not run: # time consuming code part
# Example 1, based on the ARMD data:
data(ARMD)
# Assess surrogacy based on the single-trial meta-analytic approach:
Sur <- Single.Trial.RE.AA(Dataset=ARMD, Surr=Diff24, True=Diff52, Treat=Treat, Pat.ID=Id)
# Obtain a summary and plot of the results
summary(Sur)
plot(Sur)
# Example 2
# Conduct an analysis based on a simulated dataset with 2000 patients
# and Rindiv=.8
# Simulate the data:
Sim.Data.STS(N.Total=2000, R.Indiv.Target=.8, Seed=123)
# Assess surrogacy:
Sur2 <- Single.Trial.RE.AA(Dataset=Data.Observed.STS, Surr=Surr, True=True, Treat=Treat,
Pat.ID=Pat.ID)
# Show a summary and plots of results
summary(Sur2)
plot(Sur2)
## End(Not run)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.