GBOP2 (version 0.1.4)

GBOP2_minSS_singleE: PSOGO: Optimal/Minimax design with single boundary for futility

Description

This function implements PSOGO to find an optimal or minimax design with single boundary for futility.

Usage

GBOP2_minSS_singleE(
  design = "optimal",
  unified.u = 1,
  weight = 1,
  nlooks = 2,
  p0 = 0.2,
  p1 = 0.4,
  err1 = 0.05,
  minPower = 0.8,
  maxPatients = 5,
  Nmin_cohort1 = 1,
  Nmin_increase = 1,
  pso_method = "default",
  nParallel = 3,
  seed = 456,
  nSwarm = 64,
  maxIter = 200
)

Value

A list on design parameters and operating characteristics

Arguments

design

choose from "optimal", "minimax", or "unified"

unified.u

specify when design = "unified", u in zero to one

weight

weight of sample size under null

nlooks

number of interim looks

p0

Null hypothesis response rate

p1

Alternative hypothesis response rate

err1

Type I error rate

minPower

power

maxPatients

maximum 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_minSS_singleE(
#   design = "optimal",
#    unified.u = 1,
#    nlooks = 1,
#    p0 = 0.2,
#    p1 = 0.4,
#    err1 = 0.05,
#    minPower = 0.8,
#    weight = 1,
#    maxPatients = 25,
#    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.")
# }