- n.dose
Integer specifying the number of dose levels to investigate.
- start.dose
Integer specifying the starting dose level (1 = lowest dose).
Generally recommended to start at the lowest dose for safety.
- size.cohort
Integer specifying the number of patients per cohort.
Commonly 3 or 6 patients, with 3 being standard for early-phase trials.
- n.cohort
Integer specifying the maximum number of cohorts.
Total sample size = size.cohort*n.cohort.
- toxprob
Matrix (nrow = toxicity categories, ncol = n.dose) specifying
true toxicity probabilities. Each column must sum to 1.0. Rows represent
ordered toxicity levels from none to most severe.
- effprob
Matrix (nrow = efficacy categories, ncol = n.dose) specifying
true efficacy probabilities. Each column must sum to 1.0. Rows represent
ordered response levels from none to best response.
- sev.weight
Numeric vector of toxicity severity weights. Length must
equal nrow(toxprob). Should be non-decreasing and reflect clinical impact.
First element typically 0 (no toxicity). Example: c(0, 0.5, 1.0, 1.5) for
Grade 0 and 1, Grade 2, Grade 3, Grade 4.
- res.weight
Numeric vector of efficacy response weights. Length must
equal nrow(effprob). Should be non-decreasing and reflect clinical benefit.
First element typically 0 (no response). Example: c(0, 0.25, 1.0, 3.0) for
PD, SD, PR, CR.
- phi
Numeric target for normalized equivalent toxicity score (nETS).
Should be calibrated for weighted scores, not binary probabilities.
- phi1
Numeric lower boundary for nETS. Doses with nETS <= phi1 considered
under-dosed for toxicity. Default phi*0.1.
- phi2
Numeric upper boundary for nETS. Doses with nETS >= phi2 trigger
de-escalation. Default phi*1.4.
- delta
Numeric target for normalized equivalent efficacy score (nEES).
Should reflect desired level of clinical benefit.
- delta1
Numeric minimum threshold for nEES. Doses below this considered
sub-therapeutic. Default delta*0.6.
- alpha.T1
Numeric value specifying the probability that a toxicity outcome occurs
in the late half of the toxicity assessment window. Used for event time generation.
Default is 0.5.
- alpha.E1
Numeric value specifying the probability that an efficacy outcome
occurs in the late half of the efficacy assessment window. Used for event
time generation. Default is 0.5.
- tau.T
Numeric value specifying the toxicity assessment window in days.
- tau.E
Numeric value specifying the efficacy assessment window in days.
- te.corr
Numeric value between -1 and 1 specifying the correlation between
toxicity and efficacy, specified as Gaussian copula parameter. Default is 0.2
(weak positive correlation).
- gen.event.time
Character string specifying the distribution for generating
event times. Options are "weibull" (default) or "uniform". A bivariate
Gaussian copula model is used to jointly generate the time to first ordinal toxicity
and efficacy outcome, where the marginal distributions are set to Weibull
distribution when gen.event.time="weibull"
, and uniform distribution when
gen.event.time="uniform"
.
- accrual
Numeric value specifying the accrual rate (days), which is the
average number of days between patient enrollments. Lower values indicate
faster accrual.
- gen.enroll.time
Character string specifying the distribution for enrollment
times. Options are "uniform" (default) or "exponential". Uniform distribution
is used when gen.enroll.time="uniform"
, and exponential distribution
is used when gen.enroll.time="exponential"
.
- stopping.npts
Integer specifying the maximum number of patients per dose
for early study termination. If the number of patients at the current dose
reaches this criteria, the study stops the enrollment and is terminated.
Default is size.cohort*n.cohort.
- stopping.prob.T
Numeric value between 0 and 1 specifying the early study
termination threshold for toxicity. If P(nETS > phi) > stopping.prob.T,
the dose levels are eliminated from the investigation. Default is 0.95.
- stopping.prob.E
Numeric value between 0 and 1 specifying the early study
termination threshold for efficacy. If P(nEES < delta1) > stopping.prob.E,
the dose levels are eliminated from the investigation. Default is 0.99.
- estpt.method
Character string specifying the method for estimating efficacy
probabilities. Options: "obs.prob" (observed efficacy probabilitiesrates),
"fp.logistic" (fractional polynomial), or "multi.iso" (model averaging of
multiple unimodal isotopic regression). Default is "obs.prob".
- obd.method
Character string specifying the method for OBD selection.
Options: "utility.weighted", "utility.truncated.linear", "utility.scoring",
or "max.effprob" (default).
- w1
Numeric value specifying the weight for toxicity-efficacy trade-off
in "utility.weighted" method. Default is 0.33.
- w2
Numeric value specifying the penalty weight for toxic doses in
"utility.weighted" method. Default is 1.09.
- plow.ast
Numeric value specifying the lower toxicity threshold for
"utility.truncated.linear" method. Default is phi1.
- pupp.ast
Numeric value specifying the upper toxicity threshold for
"utility.truncated.linear" method. Default is phi2.
- qlow.ast
Numeric value specifying the lower efficacy threshold for
"utility.truncated.linear" method. Default is delta1/2.
- qupp.ast
Numeric value specifying the upper efficacy threshold for
"utility.truncated.linear" method. Default is delta.
- psi00
Numeric value specifying the utility score for (toxicity=no, efficacy=no)
in "utility.scoring" method. Default is 40.
- psi11
Numeric value specifying the utility score for (toxicity=yes, efficacy=yes)
in "utility.scoring" method. Default is 60.
- n.sim
Integer specifying the number of simulated trials. Default is 1000.
Higher values provide more stable operating characteristics.
- seed.sim
Integer specifying the random seed for reproducible results.
Default is 100.