get.oc.comb.kb {Keyboard} | R Documentation |
Operating Characteristics for Drug-combination Trials
Description
This function generates the operating characteristics of the Keyboard design for drug-combination trials.
Usage
get.oc.comb.kb(
target,
p.true,
ncohort,
cohortsize,
n.earlystop = 100,
marginL = 0.05,
marginR = 0.05,
startdose = c(1, 1),
cutoff.eli = 0.95,
extrasafe = FALSE,
offset = 0.05,
ntrial = 1000
)
Arguments
target |
The target dose-limiting toxicity (DLT) rate. |
p.true |
A |
ncohort |
A scalar specifying the total number of cohorts in the trial. |
cohortsize |
The number of patients in the cohort. |
n.earlystop |
The early stopping parameter. If the number of patients
treated at the current dose reaches |
marginL |
The difference between the target and the lower bound of the
"target key" (proper dosing interval) to be defined. |
marginR |
The difference between the target and the upper bound of the
"target key" (proper dosing interval) to be defined. |
startdose |
The starting dose combination level for the
drug-combination trial. |
cutoff.eli |
The cutoff value to eliminate an overly toxic dose and all
higher doses for safety. |
extrasafe |
Set |
offset |
A small positive number (between 0 and 0.5) to control how
strict the stopping rule is when |
ntrial |
The total number of trials to be simulated. |
Value
The function returns the operating characteristics of the Keyboard
combination design as a list:
the true toxicity probability at each dose level (
$p.true
),
the selection percentage at each dose level (
$selpercent
),
the percentage of correct selection (
$pcs
),
the number of patients treated at each dose level (
$nptsdose
),
the number of toxicities observed at each dose level (
$ntoxdose
),
the total number of toxicities observed in the trial (
$totaltox
),
the total number of patients in the trial (
$totaln
),
the total percentage of patients treated at the MTD (
$npercent
).
Uses
This function uses get.boundary.comb.kb
Author(s)
Xiaomeng Yuan, Chen Li, Hongying Sun, Li Tang and Haitao Pan
References
Yan F, Mandrekar SJ, Yuan Y. Keyboard: A Novel Bayesian Toxicity Probability Interval Design for Phase I Clinical Trials. Clinical Cancer Research. 2017; 23:3994-4003. http://clincancerres.aacrjournals.org/content/23/15/3994.full-text.pdf
Pan H, Lin R, Yuan Y. Keyboard design for phase I drug-combination trials. Contemporary Clinical Trials. 2020. https://doi.org/10.1016/j.cct.2020.105972
See Also
Other drug-combination functions:
get.boundary.comb.kb()
,
next.comb.kb()
,
select.mtd.comb.kb()
Examples
### Drug-combination trial ###
p.true <- matrix(c(0.01, 0.03, 0.10, 0.20, 0.30,
0.03, 0.05, 0.15, 0.30, 0.60,
0.08, 0.10, 0.30, 0.60, 0.75), byrow=TRUE, ncol=5)
oc.comb <- get.oc.comb.kb(target=0.3, p.true=p.true, ncohort=20, cohortsize=3,
n.earlystop=12, startdose=c(1, 1), ntrial=100)