des_fixed: Design a fixed-sample (single-stage) clinical trial for a...

In mjg211/OptGS: Optimal and Near-optimal Group-sequential Designs for Clinical Trials with Continuous Outcomes

Description

des_fixed() determines fixed-sample (i.e., single-stage) clinical trial designs assuming the primary outcome variable is normally distributed.

Usage

des_fixed(
  alpha = 0.05,
  beta = 0.2,
  delta = 0.2,
  sigma0 = 1,
  sigma1 = sigma0,
  ratio = 1,
  quantile_sub = FALSE,
  integer_n = TRUE,
  summary = FALSE
)

Arguments

alpha	A numeric indicating the chosen value for α, the desired type-I error-rate. Must be strictly between 0 and 1. Defaults to 0.05.
beta	A numeric indicating the chosen value for β, the desired type-II error-rate. Must be strictly between 0 and 1. Defaults to 0.2.
delta	A numeric indicating the chosen value for δ, the treatment effect to power the trial for. Must be strictly positive. Defaults to 0.2.
sigma0	A numeric indicating the chosen value for σ0, the standard deviation of the responses in the control arm. Must be strictly positive. Defaults to 1.
sigma1	A numeric indicating the chosen value for σ1, the standard deviation of the responses in the experimental arm. Must be strictly positive. Defaults to sigma0.
ratio	A numeric indicating the chosen value for r, the allocation ratio to the experimental arm relative to the control arm. Must be strictly positive. Defaults to 1.
quantile_sub	A logical variable indicating whether quantile substitution should be applied to the identified rejection boundary. Defaults to FALSE.
integer_n	A logical variable indicating whether the computed values for n0 and n1, the group sizes in the control and experimental arms, should be forced to be whole numbers. Defaults to TRUE.
summary	A logical variable indicating whether a summary of the function's progress should be printed to the console. Defaults to FALSE.

Value

A list with additional class "OptGS_des". It will contain each of the input variables (subject to internal modification), relating them to the outputs of the various group-sequential design functions in OptGS, along with additional elements including:

• n: A numeric giving n, the sample size for the identified design.

• n0: A numeric giving n₀, the sample size in the control arm for the identified design.

• n1: A numeric giving n₁, the sample size in the experimental arm for the identified design.

• name: A character string giving a name for the identified design.

• opchar: A tibble giving the operating characteristics of the identified design when τ = 0 and τ = δ.

See Also

des_gs, des_nearopt, des_opt, opchar, sim, plot.OptGS_des, plot.OptGS_opchar, print.OptGS_des, summary.OptGS_des

Examples

# The fixed-sample design for the default parameters
des <- des_fixed()

mjg211/OptGS documentation built on May 28, 2021, 3:44 p.m.