SEARS {SEARS} | R Documentation |
A randomized distributed phase I-II seamless dose escalation/expansion schema for dose optimization and selection in early oncology clinical development
Description
Implements seamless randomized phase I-II SEARS design for finding the optimal design. Practitioners can use a rich set of parameters to explore various real scenarios for their studies. The function can generate operating characteristics via simulation for practitioners to examine the design’s properties
Usage
SEARS(p.p, p.d, p.tox, k1, k2, pi_t, pi_e, pT, eff_a = 0.5, eff_b = 0.5,
plac_a = 0.5, plac_b = 0.5, tox_a = 1, tox_b = 1, csize, csize2,
p.star = 0.2, q.star = 0.6, f.star = 0.06, p.star2 = 0.2,
q.star2 = 0.98, d.cs, p.cs, phase1_size, n_earlystop,
extrasafe_BOIN = FALSE, offset_BOIN = 0.05, Nsim, n_catchup,
control_arm = "", power_c = 0.5, lower_bound = 0.05, weight1,
weight2, seed = 100)
Arguments
p.p |
the true placebo response rate |
p.d |
the true dose response rate vector |
p.tox |
the true dose toxicity rate vector |
k1 |
the safety rule cutoff value in phase I |
k2 |
the safety rule cutoff value in phase II |
pi_t |
the physician-specified upper toxicity rate threshold |
pi_e |
the physician-specified lower response rate threshold |
pT |
the target toxicity rate |
eff_a |
the hyperparameter "a" for priors of the response rate for experimental doses. The default value is |
eff_b |
the hyperparameter "b" for priors of the response rate for experimental doses. The default value is |
plac_a |
the hyperparameter "a" for prior of the response rate for the control arm. The default value is |
plac_b |
the hyperparameter "b" for prior of the response rate for the control arm. The default value is |
tox_a |
the hyperparameter "a" for priors of the toxicity rates. The default value is |
tox_b |
the hyperparameter "b" for priors of the toxicity rates. The default value is |
csize |
the cohort size in phase I |
csize2 |
the cohort size in phase II |
p.star |
the fixed cutoff probability for toxicity in phase I. The default value is |
q.star |
the fixed cutoff probability for efficacy in phase I. The default value is |
f.star |
the small probability cutoff. It will be used for futility dose exclusion. The default value is |
p.star2 |
the fixed cutoff probability for toxicity in phase II. The default value is |
q.star2 |
the fixed cutoff probability for efficacy in phase II. The default value is |
d.cs |
the prespecified maximum allowable number of patients enrolled for each dose |
p.cs |
the prespecified maximum allowable number of patients enrolled for the placebo |
phase1_size |
the prespecified maximum sample size of phase I trial |
n_earlystop |
the cutoff number in phase I. When the number of patients enrolled at a certain dose reaches this value in phase I, this dose will be graduated to phase II |
extrasafe_BOIN |
the logical value which indicates whether a more stringent stopping rule will be applied to
phase I BOIN design. The default value is |
offset_BOIN |
the small positive number (between 0 and 0.5) to control how strict the stopping rule is when |
Nsim |
the number of simulated trials |
n_catchup |
the catch-up cutoff when employing the adaptive randomization in phase II |
control_arm |
the argument is for phase II design only. If this argument is "fixed", then allocation probability of control arm (the first component of the allocation probability vector)
will be fixed to |
power_c |
the power correction parameter of the allocation probability. The default value is |
lower_bound |
the lower bound of the allocation probability in phase II design. It must be a value between 0 and |
weight1 |
the penalized weight in the utility function for the toxicity |
weight2 |
the additional penalized weight in utility function for dose(s) which has (have) the toxicity probability greater than the pre-specified DLT rate |
seed |
the seed. The default value is |
Value
SEARS()
returns a list with following elements (1) type I error (2) average sample size for the trial (3) average sample size for each dose (4) average sample size for placebo (5) selection percentage for each dose (6) average toxicity events for each dose
Author(s)
Chia-Wei Hsu, Haitao Pan
Examples
SEARS(p.p = 0.2, p.d = c(0.2, 0.2, 0.2, 0.2, 0.2), p.tox = c(0.03, 0.06, 0.17, 0.3, 0.5),
k1 = 0.95, k2 = 0.8, pi_t = 0.17, pi_e = 0.2, pT = 0.17, eff_a = 0.5, eff_b = 0.5,
plac_a = 0.5, plac_b = 0.5, tox_a = 1, tox_b = 1, csize = 3, csize2 = 3,
p.star = 0.2, q.star = 0.6, f.star = 0.06, p.star2 = 0.2, q.star2 = 0.98,
d.cs = 36, p.cs = 36, phase1_size = 30, n_earlystop = 100, extrasafe_BOIN = FALSE,
offset_BOIN = 0.05, Nsim = 10, n_catchup = 3, control_arm = "fixed", power_c = 0.5,
lower_bound = 0.05, weight1 = 0.5, weight2 = 0.5, seed = 100)