Time2Nsubjects: Simulate the number of weeks needed to recruit a given number...

In RCTRecruit: Non-Parametric Recruitment Prediction for Randomized Clinical Trials

Simulate the number of weeks needed to recruit a given number of subjects

Description

Simulate the number of weeks needed to recruit a given number of subjects

Usage

Time2Nsubjects(
  nSub = 50L,
  nSim = 10000L,
  fillGaps = FALSE,
  cauchyWt = FALSE,
  efficiencyFactor = 1
)

Arguments

nSub	Number of subjects to recruit (default = 50L)
nSim	Number of simulations to run (default = 1e4L). Accepted values are in the range of 1 to 10,000.
fillGaps	Whether to fill recruitment gaps in the data (default = FALSE). Recruitment gaps are defined as any full week (Monday through Sunday) with no dates recorded in the loaded data. If at least one date is present within a given week, that week will not be considered a gap in recruitment.
cauchyWt	Whether to use Cauchy weights for sampling. If FALSE (default), binomial weights are used.
efficiencyFactor	An efficiency coefficient to apply to the recruitment rate (default = 1). If the efficiency of the recruitment process is expected to match the provided data, this value should be set to 1. If the recruitment process is expected to be slower, this value should less than 1. Finally, if the recruitment process is expected to proceed faster, this value should be greater than 1. Accepted values range from 0.1 to 2: 0.1: Indicates that the recruitment rate is expected to be 10% of the original rate. 2.0: Indicates that the recruitment rate is expected to be double the original rate.

Value

An object of RCTNWeeks class with four elements.

1. weeks is an integer vector with length equal to nSim containing the simulation results.

2. CI shows the median and the 95% CI.

3. call.: The call (deparsed) that created the object

4. cargs: A list with the arguments of the call that created the object
   including the default arguments

See Also

Other Links: GetDistance(), GetWeekPredCI(), LoadData(), RCTRecruit-package, gripsYR1, gripsYR2, gripsYR2Weekly, plot.RCTPredCI()

Examples

LoadData(gripsYR1, ScreenDt, Enrolled)
(res <- Time2Nsubjects())
str(res)

RCTRecruit documentation built on June 8, 2025, 10:50 a.m.