View source: R/monitoring_utils.R
estHRbound | R Documentation |
Assuming an exponential survival model, hazard ratios are estimated at an efficacy or non-efficacy stopping boundary, defined using the Wald CI approach, at each group-sequential analysis in an event-driven 2-arm trial design.
estHRbound(boundType = c("eff", "nonEff"), nullHR, alpha, nEvents, randFrac)
boundType |
a character string specifying if the one-sided null hypothesis is of the form H_0: θ ≥q θ_0 ( |
nullHR |
a nonnegative numeric value specifying the hazard ratio, θ_0, under the null hypothesis. If the null hypothesis differs across multiple analyses, |
alpha |
a numeric vector of two-sided nominal significance levels (e.g., those defined by the O'Brien-Fleming group-sequential test) |
nEvents |
a numeric vector of numbers of events at which analyses are performed. The lengths of |
randFrac |
a fraction of subjects randomized to the group considered in the hazard ratio's numerator |
Using an exponential survival model and sample estimates \widehat{λ}_1 and \widehat{λ}_2 of the group-specific hazard rates, the asymptotic variance of the log hazard ratio estimator
\log \widehat{θ} = \log (\widehat{λ}_1 / \widehat{λ}_2) is employed together with the approximation E\{δ | λ_1\} = (\widehat{λ}_1 / \widehat{λ}_2)\, E\{δ | λ_2\}.
The resultant variance approximation is \mathrm{var} \{\log \widehat{θ}\} = (1/D) \{ 2 + p \, \widehat{θ} / (1 - p) + (1 - p) / (p \, \widehat{θ}) \},
where D is the arm-pooled number of events nEvents
and p is the randomization fraction randFrac
.
A data frame (with rows corresponding to the components of alpha
and nEvents
) of point estimates of the hazard ratio at the stopping boundary and the pertaining monitoring-adjusted (1 - α^{\ast}) \times 100\% confidence intervals, where α^{\ast} is the overall two-sided type 1 error rate.
## O'Brien-Fleming test of H0: HR >= 0.7 (for efficacy) at ## 35%, 70%, and 100% of the total information under 1:1 randomization estHRbound("eff", nullHR=0.7, alpha=c(0.00030, 0.01466, 0.04548), nEvents=c(53, 106, 151), randFrac=0.5) ## O'Brien-Fleming test of H0: HR <= 0.5 (for non-efficacy) at ## 35%, 70%, and 100% of the total information under 1:1 randomization estHRbound("nonEff", nullHR=0.5, alpha=c(0.00030, 0.01466, 0.04548), nEvents=c(53, 106, 151), randFrac=0.5)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.