oc_rct {earlygating}R Documentation

RCT Operating Characteristics

Description

Function for calculating the operating characteristics of the RCT Bayesian designs in setting 3 and 4 for early gating.

Usage

oc_rct(
  N_c,
  N_e,
  delta,
  delta_power,
  confidence,
  e_a = 0.5,
  e_b = 0.5,
  c_a = 0.5,
  c_b = 0.5,
  h_a = 0.5,
  h_b = 0.5,
  RR_h = NULL,
  N_h = NULL,
  w = NULL,
  trues = seq(0, 1, 0.01),
  plot = T,
  legend = T,
  legend.pos = "topleft"
)

Arguments

N_c

Sample Size in the control group. Can be either a single value or a vector, but needs to be the same length as N_e.

N_e

Sample Size in the experimental group. Can be either a single value or a vector, but needs to be the same length as N_c.

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 αe\alpha_e. Default is 12\frac{1}{2}.

e_b

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

c_a

Alpha parameter of Beta Prior Distribution for the control response rate. Corresponds to αc\alpha_c. Default is 12\frac{1}{2}.

c_b

Beta parameter of Beta Prior Distribution for the control response rate. Corresponds to βc\beta_c. Default is 12\frac{1}{2}.

h_a

Alpha parameter of Beta Prior Distribution for the historical control response rate. Corresponds to αh\alpha_h. Only needs to be specified, if RR_h, N_h and w are also specified. Default is 12\frac{1}{2}.

h_b

Beta parameter of Beta Prior Distribution for the historical control response rate. Corresponds to βh\beta_h. Only needs to be specified, if RR_h, N_h and w are also specified. Default is 12\frac{1}{2}.

RR_h

Historical control response rate. Corresponds to php_h. If specified together with N_h and w, function will use setting 4 from pdf.

N_h

Historical control sample size. Corresponds to nhn_h. If specified together with RR_h and w, function will use setting 4 from pdf.

w

Level of dynmaic borrowing. Corresponds to ww.

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.

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 the decision power and decision alpha with respect to the true control response rate.

Examples


# Setting 3
oc_rct(
  N_c = 25, N_e = 25, delta = 0.08,
  delta_power = 0.13, confidence = 0.6
)

# Setting 4
oc_rct(
  N_c = 25, N_e = 25, delta = 0.08,
  delta_power = 0.13, confidence = 0.6,
  RR_h = 0.5, N_h = 50, w = 0.3
)


[Package earlygating version 1.1 Index]