next.comb {BOIN}  R Documentation 
Determine the dose combination for the next cohort of new patients for drugcombination trials that aim to find a MTD
next.comb(target, npts, ntox, dose.curr, n.earlystop=100,
p.saf=0.6*target, p.tox=1.4*target, cutoff.eli=0.95,
extrasafe=FALSE, offset=0.05)
target 
the target DLT rate 
npts 
a 
ntox 
a 
dose.curr 
the current dose combination 
n.earlystop 
the early stopping parameter. If the number of patients
treated at the current dose reaches 
p.saf 
the highest toxicity probability that is deemed subtherapeutic
(i.e. below the MTD) such that dose escalation should be undertaken.
The default value is 
p.tox 
the lowest toxicity probability that is deemed overly toxic such
that deescalation is required. The default value is

cutoff.eli 
the cutoff to eliminate an overly toxic dose for safety.
We recommend the default value of ( 
extrasafe 
set 
offset 
a small positive number (between 
This function is used to determine dose combination for conducting combination trials.
Given the currently observed data, next.comb()
determines dose combination for
treating the next cohort of new patients. The currently observed data include: the
number of patients treated at each dose combination (i.e., npts
),
the number of patients who experienced doselimiting toxicities at each dose
combination (i.e., ntox
), and the level of current dose (i.e., dose.curr
).
the recommended dose for treating the next cohort of patients ($next_dc
).
Suyu Liu and Ying Yuan
Liu S. and Yuan, Y. (2015). Bayesian Optimal Interval Designs for Phase I Clinical Trials, Journal of the Royal Statistical Society: Series C, 64, 507523.
Lin R. and Yin, G. (2017). Bayesian Optimal Interval Designs for Dose Finding in Drugcombination Trials, Statistical Methods in Medical Research, 26, 21552167.
Yan, F., Zhang, L., Zhou, Y., Pan, H., Liu, S. and Yuan, Y. (2020).BOIN: An R Package for Designing SingleAgent and DrugCombination DoseFinding Trials Using Bayesian Optimal Interval Designs. Journal of Statistical Software, 94(13),132.<doi:10.18637/jss.v094.i13>.
Tutorial: http://odin.mdacc.tmc.edu/~yyuan/Software/BOIN/BOIN2.6_tutorial.pdf
Paper: http://odin.mdacc.tmc.edu/~yyuan/Software/BOIN/paper.pdf
## determine the dose combination for the next cohort of new patients
n < matrix(c(3, 0, 0, 0, 0, 7, 6, 0, 0, 0, 0, 0, 0, 0, 0), ncol=5, byrow=TRUE)
y < matrix(c(0, 0, 0, 0, 0, 1, 1, 0, 0, 0, 0, 0, 0, 0, 0), ncol=5, byrow=TRUE)
nxt.comb < next.comb(target=0.3, npts=n, ntox=y, dose.curr=c(2, 2))
summary(nxt.comb)