opchar_curtailed: Determine the operating characteristics of group sequential...

Description Usage Arguments Details Value References See Also Examples

View source: R/opchar_curtailed.R

Description

opchar_gs() supports the simultaneous evaluation of the operating characteristics of multiple group sequential single-arm clinical trial designs for a single binary primary endpoint, determined using des_gs().

Usage

1
opchar_curtailed(des, ..., k, pi, summary = F)

Arguments

des

An object of class "sa_des_gs", as returned by des_gs().

...

Additional objects of class "sa_gs_gs". These will be grouped in to a list named "add_des".

k

Calculations are performed conditional on the trial stopping in one of the stages listed in vector k. Thus, k should be a vector of integers, with elements between one and the maximum number of possible stages across the supplied designs. If left unspecified, it will internally default to all possible stages.

pi

A vector of response probabilities to evaluate operating characteristics at. This will internally default to be the π0 and π1 from the supplied designs if it is left unspecified.

summary

A logical variable indicating whether a summary of the function's progress should be printed to the console.

Details

Note that each of the supplied designs must have been designed for the same value of π0.

For each value of π in the supplied vector π, opchar_gs() evaluates the power, ESS, and other key characteristics, of each of the supplied designs.

Calculations are performed conditional on the trial stopping in one of the stages specified using the input (vector) k.

Value

A list of class "sa_opchar_gs" containing the following elements

References

Simon R (1989) Optimal two-stage designs for phase II clinical trials. Controlled Clinical Trials 10:1-10.

See Also

des_gs, est_gs, pval_gs, ci_gs, and their associated plot family of functions.

Examples

1
2
3
4
5
6
7
8
# Find the optimal two-stage design for the default parameters
des         <- des_gs()
# Determine operating characteristics for a range of response probabilities
opchar      <- opchar_gs(des, pi = seq(0, 1, 0.01))
# Find the optimal two-stage design for a 10% type-I error rate
des_10      <- des_gs(alpha = 0.1)
# Determine operating characteristics for both designs at the same time
opchar_both <- opchar_gs(des, des_10, pi = seq(0, 1, 0.01))

mjg211/singlearm documentation built on May 8, 2021, 3:17 a.m.