FGS_Binomial: SSR for flexible group sequential multi-arm design with...

In cherryyan/MASSR: Sample Size Re-Estimation for Two-Stage Flexible Multi-Arm Trials with Treatment Selection

Description

Function to calculate conditional power and perform SSR for flexible group sequential multi-arm designs with binary outcomes.

Usage

FGS_Binomial(a, sel_rule, n1 = NULL, N2 = NULL, initialSS = 2, r21, rmax,
  alpha = 0.025, ushape = "obf", lfix = 0, pi0, piT, x0_1, x1, beta,
  ConditionalPower, ssr, delta = NULL, side = "upper")

Arguments

a	Number of experimental treatments (a = 2 or 3)
sel_rule	Treatment selection rule at interim analysis. There are four treatment selection rule, 1) sel_tr = 1, select the best treatment; 2) sel_tr=2, keep all promising treatments that do not cross either efficacy boundaries or futility boundaries; 3) sel_tr = 3, select the best treatment only if the event rate difference to control is above a threshold delta; 4) sel_tr = 4, keep all promising treatments where the event rate difference to control is above delta.
n1	First stage sample size per arm (default is NULL).
N2	Total sample size per arm at the end of the trial (default is NULL).
initialSS	Whether initial sample size needs to be calculated. If initial sample size does not need to be calculated, then n1 and N2 have to be provided and initialSS is set to 0. If initial sample size need to be calculated, then initialSS can take numeric value 1 (initial sample size will be calculated using the method for traditional fixed two-arm design) or 2 (initial sample size will be calculated using the method for group sequential two-arm design).
r21	Allocation ratio of N2 to n1 (r21 = N2/n1). If initialSS = NULL, then it should also be NULL. If initialSS = 1 or 2, then it should be a numeric value that is larger than 1.
rmax	The ratio of the maximum sample size allowed per arm (N2_max) to N2 (rmax = N2_max/N2). It should be a numeric value that is larger than 1.
alpha	One sided familywise error rate (default is 0.025).
ushape	The shape of the efficacy boundaries (default is "obf"). Either a function specifying the shape or one of "pocock", "obf" (the default), "triangular" and "fixed".
lfix	Fixed lower boundary on z-scale (default is 0). lfix must be smaller than Phi(1-alpha)/2 to ensure that it is smaller than the upper boundary.
pi0	Planned event rate of control arm.
piT	Planned event rate of experimental treatment arms. Both pi0 and piT are used for initial sample size caculation and SSR based on the planned treatment effect.
x0_1	First stage event rate of control arm. It has to be a one column matrix with the same number of rows as x1.
x1	First stage event rate of experimental treatment arms. It has to be a matrix with each row represents one trial, and the number of colum should be equal to a.
beta	Type II error. 1-beta is used as the desired power and conditional power.
ConditionalPower	Methods for conditional power. If ConditionalPower = "planned", then conditional power will be calculated using the planned event rate. If ConditionalPower = "observed", then conditional power is calcuated using the maximum observed treatment effect and variance at interim analysis.
ssr	Whether sample size re-estimation should be performed. If ssr = 0, sample size re-estimation will not be performed. If ssr = 1, sample size will be performed if conditional power is lower than 1-beta.
delta	The minimum treatment effect (event rate of treatment arm - event rate of control arm) that is of interest. The default is NULL, but when sel_rule = 3 or 4, a numeric value has to be specified.
side	Side for conditional power (default is "upper"). Either "upper" or "lower".

Details

This function calculates conditional power and perform sample size re-estimation (SSR) based on the conditional power approach for two-stage flexible group sequential multi-arm design (as described in Magirr et al (2014)) with binary outcomes. It is assumed that sample size is equally allocated among arms. At interim analysis, a trial will be stopped if any treatments cross the efficacy boundaries and any treatments cross the futility boundary will be dropped. Conditional power is calculated under the global alternative hypothesis where it is assumed all the treatmenteffects are equal to planned treatment effect(theta) or maximum observed treatment effect. If a trial stops at interim analysis, conditional power(CP), new second stage sample size per arm (n2new) and new conditional power(cp_new) will not be calculated and will all be returned as NA. If a trial can continue to the second stage and conditional power is larger than 1-beta, then n2new and cp_new will not be calculated and will be returned as NA. Multiple trials can be assessed at the same time.

Value

A list containing the following components:

EfficacyBound	The efficacy boundaries for both interim analysis and final analysis.
FutilityBound	The futility boundaries for both interim analysis and final analysis.
stop_efficacy	A matrix indicating which arms are stopped for efficacy. 1 indicates stopping for efficacy and 0 otherwise.
stop_futility	A matrix indicating which arms are stopped for futility. 1 indicates stopping for efficacy and 0 otherwise.
sel_tr	A matrix indicating which experimental treatments can continue to the second stage.
cp	Conditional power at interim analysis. If a trial stops at interim analysis, conditional power will not be calculated and returned as NA.
n1	First stage sample size per arm.
n2new	New second stage sample size per arm.
cp_new	Conditional power based on the new second stage sample size.
NoRoot	If new sample size is successful found, then NoRoot = NULL. If new sample size cann't be found, then NoRoot will return the index of the trial for which the new sample size is not found.

References

Magirr D, Jaki T, Whitehead J: A generalized Dunnett test for multi-arm multi-stage clinical studies with treatment selection. Biometrika 2012, 99(2):494-501.

Magirr D, Stallard N, Jaki T: Flexible sequential designs for multi-arm clinical trials. Statistics in Medicine 2014, 33(19):3269-3279.

Examples

FGS_Binomial(a = 3, sel_rule = 2, n1=NULL, N2=NULL, initialSS = 2, r21 = 2, rmax= 1.5, alpha = 0.025, ushape = "obf" ,lfix=0, pi0=0.2, piT=0.4, x0_1=matrix(0.21,nrow=2,ncol=1), x1=matrix(c(0.19,0.20,0.35,0.49,0.37,0.30),nrow=2,ncol=3), beta=0.2,ConditionalPower = "planned",ssr = 1,delta = NULL)

cherryyan/MASSR documentation built on May 13, 2019, 3:54 p.m.