GBOP2 (version 0.1.4)

GBOP2_maxP_singleE: PSOGO: Power maximizing design with single boundary for futility

Description

This function implements PSOGO to find a power maximizing design with single boundary for futility.

Usage

GBOP2_maxP_singleE(
  nlooks = 1,
  p0 = 0.2,
  p1 = 0.4,
  err1 = 0.05,
  minPower = 0.8,
  totalPatients = 5,
  Nmin_cohort1 = 1,
  Nmin_increase = 1,
  pso_method = "default",
  nParallel = 3,
  seed = 1024,
  nSwarm = 64,
  maxIter = 200
)

Value

A list on design parameters and operating characteristics

Arguments

nlooks

number of interim looks

p0

Null hypothesis response rate

p1

Alternative hypothesis response rate

err1

Type I error rate

minPower

power

totalPatients

total number of patients

Nmin_cohort1

minimum number of first cohort

Nmin_increase

minimum number of increase in each cohort

pso_method

"all" for using three distinct pso, otherwise indicate single pso method

nParallel

number of pso ensemble

seed

Random seed for reproducibility

nSwarm

nSwarm for pso

maxIter

maxIter for pso

Details

Parallel computing is only used when the user explicitly sets nCore > 1. No more than 2 cores should be used unless the user is aware and permits it. The function defaults to sequential execution. If multiple analyses are planned, consider using `init_cluster(nCore)` and `stop_cluster()` manually to control the backend.

Examples

# \donttest{
# init_cluster(2)
#   GBOP2_maxP_singleE(
#   nlooks = 1, 
#   p0 = 0.2, 
#   p1 = 0.4, 
#   err1 = 0.05, 
#   minPower = 0.8, 
#   totalPatients = 26, 
#   Nmin_cohort1 = 10, 
#   Nmin_increase = 5, 
#   pso_method = "default", 
#   nParallel = 3, 
#   seed = 1024, 
#   nSwarm = 64, 
#   maxIter = 200
# )
# stop_cluster()  # Only if init_cluster() was used
#  
message("Run GBOP2_minSS_singleE() manually for real optimization.")
# }