designCTPB: Optimal design for 3-dimensional with visulization
In DesignCTPB: Design Clinical Trials with Potential Biomarker Effect

Description Usage Arguments Details Value See Also Examples

View source: R/designCTPB.R

This function uses GPU parallel computing to calculate the high dimensional integral and apply the smoothing method(thin plate splines) to get the optimum of power values given the prior information: the harzard reduction distribution. This function guides to choose the size of nested populations, i.e. find optimal r-values. The function visualizes and optimizes r-values, but only supports 3-dimension. The optimization of r-values in more than 3-dimension is trivial, but visualization can be too hard.

designCTPB(
  m = 24,
  r_set = NULL,
  n_dim = 3,
  N1 = 20480,
  N2 = 10240,
  N3 = 2000,
  E = NULL,
  SIGMA = NULL,
  sd_full = 1/base::sqrt(20),
  DELTA = NULL,
  delta_linear_bd = c(0.2, 0.8),
  seed = NULL
)

`m`	integer, the number of grid points in each dimension for r, and we suggest m around 20 is enough for 3 dimension
`r_set`	the matrix of proportion for each sub-population, r_1 is 1, r_i>r_i+1
`n_dim`	integer, the number of dimension
`N1`	integer, which is fixed as 10240 in our package
`N2`	integer, which is fixed as 20480 in our package
`N3`	integer, the number of grid point for the sig.lv, which should be the multiples of 5, because we apply 5 stream parallel
`E`	integer, the total number of events for the Phase 3 clinical trail, if not specified by user, then an estimation will apply
`SIGMA`	the matrix of standard deviation of each sub-population, which should coincide with r_set or the default setting of each sub-population(i.e each entry of each row coincides to the corresponding entry in r_set)
`sd_full`	a numeric number, which denotes the prior information of standard deviation for the harzard reduction if sig is not specified by user, then sd_full must has an input value to define the standard deviation of the full population
`DELTA`	matrix, each row is an vector stands for the point estimation of harzard reduction in prior information corresponds to the r setting, if not specified we apply a linear scheme by giving bound to the linear harzard reduction
`delta_linear_bd`	vector of length 2, specifying the upper bound and lower bound for the harzard reduction; if user don't specify the delta for each sub-population, then the linear scheme will apply and the input is a must.
`seed`	integer, seed for random number generation

the standard deviation of each population can be specified by giving SIGMA as input, and specify the harzard reduction rate DELTA for each population. Just enter values to SIGMA and DELTA, but note that the entered matrix should coincides with the matrix of r-split setting.

list of 5 parts: plot_power: 3-d plot of the optimal power values versus r2 and r3; plot_alpha: 3-d plot of the optimal alpha-split values versus r2 and r3; opt_r_split: the optimal choice of proportion for each sub-population; opt_power: the optimal power values with the optimal r choice; opt_alpha_split: the optimal alpha split with the optimal r choice

Grid setting of proportions for each sub-population proportion() and alpha.split()

## Not run: 
# the default setting of our paper's strong biomarker effect 
res <- designCTPB()
res$plot_power # to see 3-d plot for the optimal power versus r2 and r3
res$plot_alpha # to see 3-d plot for the optimal alpha versus r2 and r3
res$opt_r_split #  to see the optimal cutoff of the sub-population, 
#and here suggesting not cutoff at the 2-nd sub-population
res$opt_power 
res$opt_alpha_split

## End(Not run)