recruitment {interim} | R Documentation |
Scheduling interim analyses in clinical trials
Description
Function recruitment
simulates the recruitment of patients in clinical trials.
Usage
recruitment(nc, ns, cw, sw, sf, tb, en)
Arguments
nc |
maximum number of centers to be opened or |
ns |
maximum number of patients to be screened within each center or |
cw |
number of center openings per week. |
sw |
number of screened patients per week within each center. |
sf |
screening failure rate. |
tb |
time between screening and enrollment/randomization in weeks. |
en |
number of patients to be enrolled. |
Details
Function recruitment
simulates the recruitment progress for a required
number of enrolled patients in clinical trials based on the expected number
of centers to be opened per week and the expected number of patients being recruited per site and week.
The function assumes that centers are being opened at a constant rate per week (cw
)
and patient per center are screened at a constant rate per week (sw
).
The function can handle recruitment limits by limiting the total number of centers (nc
)
and/or the number of patients recruitable per site (ns
).
The function discriminates between screening timepoint and enrollment/randomization timepoint by
allowing a screening period (tb
) and screen failure rate (sf
) to be specified.
If both are zero then patients are directly enrolled at screening.
Function recruitment
can handle four different recruitment scenarios.
Scenario 1. Centers are being opened over the entire trial duration, i.e. no limit of centers (
nc=Inf
) and are kept open during the complete trial duration, i.e. no limit of patients per center (ns=Inf
).Scenario 2. Only a limited number of centers can be opened (
nc=
a positive number) and are kept open during the complete trial duration (ns=Inf
).Scenario 3. Centers are being opened over the entire trial duration (
nc=Ind
) and are only have a limited capacity for patient recruitment (ns=
a positive number).Scenario 4. Only a limited number of centers can be opened (
nc=
a positive number) and are only have a limited capacity for patient recruitment (ns=
a positive number).
Under scenario 4 only a limited number of patients can be recruited. The auxilliary function capacity
can
be used to derive the maximum number of patients that can be enrolled under this scenario.
Results of recruitment
are required as input for function treatment
to derive
the time when treatment of patients is finished.
Value
recruitment
returns a list of vectors with the following components:
-
weeksOfTrial
a vector counting the trial week for recruitment(from 0 (start of site openings) to the required number of weeks for recruitment) -
openCenters
a vector with the (cumulative) number of opened centers per trial week -
closedCenters
a vector with the (cumulative) number of closed centers per trial week -
centerWeeks
a vector with the (cumulative) number of opened center weeks per trial week -
screenings
a vector with the (cumulative) number of screened patients per trial week -
weeksOfEnrollment
a vector counting the weeks of enrollment (with start of site openings as reference start) -
enrollments
a vector with the (cumulative) number of enrolled/randomized patients per week of enrollment
See Also
treatment
for simulating the treatment duration for a given recruitment scenario;
trialCourse
for plots of recruitment and treatment scenarios;
capacity
for deriving the maximum number of patients that can be enrolled under scenario 4;
Examples
x=recruitment(nc=Inf,ns=Inf,cw=4,sw=2,sf=0.3,tb=4,en=400)