- 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
Numeric vector of length n.dose specifying the true toxicity
probabilities for each dose level. Used for simulation scenarios.
- effprob
Numeric vector of length n.dose specifying the true efficacy
probabilities for each dose level. Used for simulation scenarios.
- phi
Numeric value between 0 and 1 specifying the target
toxicity probability. Represents the maximum acceptable toxicity rate.
Default is 0.3 (30%).
- phi1
Numeric value specifying the highest toxicity
probability that is deemed sub-therapeutic such that dose-escalation should
be pursued. Doses with toxicity <= phi1 are considered under-dosed.
Default is phi*0.1.
- phi2
Numeric value specifying the lowest toxicity
probability that is deemed overly toxic such that dose de-escalation is
needed. Doses with toxicity >= phi2 are considered over-dosed. Default is phi*1.4.
- delta
Numeric value between 0 and 1 specifying the target
efficacy probability. Represents the desired minimum efficacy rate. Default
is 0.6 (60%).
- delta1
Numeric value specifying the minimum probability
deemed efficacious such that the dose levels with efficacy < delta1 are considered
sub-therapeutic. Default is 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.
All toxicity evaluations must be completed within this period.
- tau.E
Numeric value specifying the efficacy assessment window in days.
All efficacy evaluations must be completed within this period.
- 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 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(toxicity > 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(efficacy < 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.