getBlockSize returns the minimum block size (possibly within a specified range) that is compatible with a trial's overall treatment assignment totals.
vector specifying the number of participants to be assigned to each treatment group. The vector should have one component per group, so that its length equals number of groups. The sum of
(Optional) vector of length two giving the lower and upper bounds (respectively) on block sizes that the user wishes to consider.
The ordering of the components of
nvec is not important, so using
nvec = c(x,y,z) will produce the same results as using
nvec = c(z,x,y).
In block randomization one does not necessarily want the smallest block size, which is the reason for the existance of the
range argument. For example, a trial with a 1:1 randomization allocation between two groups would have a minimum block size of 2, which most people would consider to be too small. So a typical usage of
getBlockSize would be to use
range to set a minimum acceptable block size, through use of vector of form
c(lowerBound, Inf). A large trial should probably have a block size on the order of 10-20 or larger, depending on factors including the total trial size and speed of enrollment, so setting a minimum is a good idea.
An integer or NA. If the user does not specify
range, then the function will always return an integer, which is the smallest block size compatible with the specified vector of treatment group sizes. If the user has specified the
range, then the function adds the further constraint that the block size must lie in the closed interval given by
range (i.e., the block size must be greater-than-or-equal-to
range and less-than-or-equal-to
range). If there are no compatible block sizes that lie in the given interval, then an NA is returned.
Note that the value returned is the minimum block size that is compatible, not necessarily the only one. Any other compatible block sizes (if any exist) will be integer multiples of the minimum size. You can check the feasibility of various integer multiples by seeing if they divide evenly into the total trial size (i.e., into the sum of
1 2 3 4 5 6 7 8
getBlockSize(nvec = c(375, 375) ) ## specify a minimum block size of 10 (no maximum) getBlockSize(nvec = c(375, 375), range = c(10, Inf) ) getBlockSize( nvec = c(30, 510, 390) ) ## require a minimum block size of 10 and maximum of 30 ## (not possible with this nvec, so function returns NA) getBlockSize( nvec = c(30, 510, 390), range = c(10, 30) )