oc_efftox: Compute operating characteristics using EffTox

In phase12designs: Comprehensive Tools for Running Model-Assisted Phase I/II Trial Simulations

Compute operating characteristics using EffTox

Description

oc_efftox() uses the EffTox design to compute operating charateristics of a user-specificed trial scenario. This design uses toxicity–efficacy trade-off contours.

Usage

oc_efftox(
  ndose,
  target_t,
  lower_e,
  ncohort = 10,
  startdose = 1,
  OBD = 0,
  ntrial = 10000,
  utilitytype = 1,
  prob = NULL
)

Arguments

ndose	Integer. Number of dose levels. (Required)
target_t	Numeric. Target toxicity probability. (Required)
lower_e	Numeric. Minimum acceptable efficacy probability. (Required)
ncohort	Integer. Number of cohorts. (Default is 10)
startdose	Integer. Starting dose level. (Default is 1)
OBD	Integer. True index of the Optimal Biological Dose (OBD) for the trial scenario. (Default is 0) If set to 0: Random OBD will be selected. Other: Treat this argument as the true OBD.
ntrial	Integer. Number of random trial replications. (Default is 10000)
utilitytype	Integer. Type of utility structure. (Default is 1) If set to 1: Use preset weights (w11 = 0.6, w00 = 0.4) If set to 2: Use (w11 = 1, w00 = 0)
prob	Fixed probability vectors. If not specified, a random scenario is used by default. Use this parameter to provide fixed probability vectors as a list of the following named elements: pE: Numeric vector of efficacy probabilities for each dose level. pT: Numeric vector of toxicity probabilities for each dose level. obd: Integer indicating the index of the true Optimal Biological Dose (OBD). mtd: Integer indicating the index of the true Maximum Tolerated Dose (MTD). For example: prob <- list( pE = c(0.4, 0.5, 0.6, 0.6, 0.6), pT = c(0.1, 0.2, 0.3, 0.4, 0.4), obd = 3, mtd = 2 )

Value

A list containing operating characteristics such as:

bd.sel

OBD selection percentage

od.sel

Favorable dose selection percentage

bd.pts

Average percentage of patients at the OBD

od.pts

Average percentage of patients at the favorable doses

earlystop

Percentage of early stopped trials

overdose

Overdose patients percentage

poorall

Poor allocation percentage

ov.sel

Overdose selection percentage

Examples

oc_efftox(
  ndose = 2,
  target_t = 0.3,
  lower_e = 0.4,
  ntrial = 1,
)

phase12designs documentation built on Sept. 2, 2025, 9:09 a.m.