eselectsim_ub {eselect}R Documentation

Simulation trials with endpoint selection and sample size reassessment for composite endpoints based on unblinded data

Description

This function simulates trials with endpoint selection and sample size reassessment for composite binary endpoints based on unblinded data. The composite endpoint is assumed to be a binary endpoint formed by a combination of two events (E1 and E2). We assume that the endpoint 1 is more relevant for the clinical question than endpoint 2. This function simulates a trial based on the design parameters and use the algorithm implemented in eselect() to select the primary endpoint and recalculate the sample size accordingly.

Usage

eselectsim_ub(
  ss_arm,
  p0_e1,
  OR1,
  p0_e2,
  OR2,
  p0_ce,
  p_init = 1,
  criteria = "SS",
  H0_e1 = FALSE,
  H0_e2 = FALSE,
  SS_r = TRUE,
  alpha = 0.05,
  beta = 0.2
)

Arguments

ss_arm

numeric parameter, sample size per arm

p0_e1

numeric parameter, probability of occurrence E1 in the control group

OR1

numeric parameter, Odds ratio for the endpoint 1

p0_e2

numeric parameter, probability of occurrence E2 in the control group

OR2

numeric parameter, Odds ratio for the endpoint 2

p0_ce

numeric parameter, probability of composite endpoint in the control group

p_init

numeric parameter, percentage of sample size used in the interim

criteria

decision criteria to choose between the composite endpoint or the endpoint 1 as primary endpoint ("SS": Ratio sample sizes, "ARE": Asymptotic Relative Efficiency).

H0_e1

Simulate under true null hypothesis for the endpoint E1 (TRUE/FALSE).

H0_e2

Simulate under true null hypothesis for the endpoint E2 (TRUE/FALSE).

SS_r

Sample size reassessment (TRUE/FALSE). If TRUE, in those cases where the sample size is less than the needed for achieving the pre-specified power, additional subjects are added after recalculating the sample size. If FALSE, no more subjects are added in the study.

alpha

Type I error.

beta

Type II error.

Value

This function returns the decision (Decision = 1, meaning the chosen endpoint is the composite endpoint; and Decision = 0, meaning the chosen endpoint is the relevant endpoint) and the statistic to test the primary hypothesis according to the decision.


[Package eselect version 1.1 Index]