earlygating (version 1.1)

avg_oc_wr_ph: Average operating characteristics with respect to historic target

Description

Function for calculating the average operating characteristics of a single arm Bayesian designs for early gating with respect to the historic target.

Usage

avg_oc_wr_ph(
  N_e,
  delta,
  delta_power,
  confidence,
  e_a = 0.5,
  e_b = 0.5,
  alpha_c,
  beta_c,
  trues = seq(0, 1, 0.01),
  adapt = 1,
  plot = T,
  legend = T,
  legend.pos = "topleft"
)

Arguments

N_e

Sample Size in the experimental group. Can be either a single value or a vector.

delta

Required superiority to make a "GO" decision. Corresponds to \(\delta\).

delta_power

Superiority, at which decision power will be evaluated. Corresponds to \(\bar{\delta}\).

confidence

Required confidence to make "GO" decision. Corresponds to \(\gamma\).

e_a

Alpha parameter of Beta Prior Distribution for the experimental response rate. Corresponds to \(\alpha_e\). Default is \(\frac{1}{2}\).

e_b

Beta parameter of Beta Prior Distribution for the experimental response rate. Corresponds to \(\beta_e\). Default is \(\frac{1}{2}\).

alpha_c

Alpha parameter of Beta Distribution for the control response rate used to calculate average operating characteristics. Corresponds to \(\alpha_c\).

beta_c

Beta parameter of Beta Distribution for the control response rate used to calculate average operating characteristics. Corresponds to \(\beta_c\).

trues

Sequence of true control response rates and experimental response rates, at which the Probability to Go will be computed. Default is seq(0,1,0.01) to ensure continuous plots and accurate results.

adapt

Level of adapting of experimental control rate to account for patient selection bias from phase II to phase III. Corresponds to \(\xi\). Default is 1, so no adapting.

plot

Plots yes or no. Default is TRUE.

legend

Logical; whether or not to include legend in plot. Default is TRUE.

legend.pos

Position of legend. Default is "topleft".

Value

A matrix containing information about the decision power and the decision alpha with respect to p_h.

Examples

# NOT RUN {
avg_oc_wr_ph(
  N_e = 50, delta = 0.08, delta_power = 0.13,
  confidence = 0.6, alpha_c = 15, beta_c = 13
)

# }