distribution.random: Nonexhaustive randomization distribution

Description Usage Arguments Details References See Also Examples


The nonexhaustive randomization distribution is generated by a random sample of all assignment possibilities.


distribution.random(design, statistic, save = "no", 
number, limit, data = read.table(file.choose(new = FALSE)), 
starts = file.choose(new = FALSE))



Type of single-case design: "AB", "ABA", "ABAB", "CRD" (completely randomized design), "RBD" (randomized block design), "ATD" (alternating treatments design), or "MBD" (multiple-baseline AB design).


Test statistic. For alternation designs, multiple-baseline designs and AB phase designs, there are 3 built-in possibilities: "A-B", "B-A", and "|A-B|", which stand for the (absolute value of the) difference between condition means. For phase designs with more than 2 phases, 6 more options are available: "PA-PB", "PB-PA", and "|PA-PB|" refer to the (absolute value of the) difference between the means of phase means, and "AA-BB", "BB-AA" and "|AA-BB|" represent the (absolute value of the) difference between the sums of phase means.


Save the randomization distribution to a file (save="yes") or just see it as output in the R console (default: save="no").


Number of randomizations required.


For phase designs: minimum number of observations per phase. For alternating treatments designs: maximum number of consecutive administrations of the same condition.


File in which the data can be found. Default: a window pops up in which the file can be selected.


Only for multiple baseline designs: location of the file where the possible start points can be found. Default: a window pops up in which the file can be selected.


When using the default data argument, a window will pop up to ask in what file the data can be found. This text file containing the data should consist of two columns for single-case phase and alternation designs: the first with the condition labels and the second with the obtained scores. For multiple-baseline designs it should consist of these two columns for EACH unit. This way, each row represents one measurement occasion. It is important not to label the rows or columns.

For multiple baseline designs, when using the default starts argument, second a window pops up in which is asked in what file the possible start points can be found. In this startpoint file, each row should contain all possibilities for one unit, separated by a tab. The rows and columns should not be labeled.

When choosing to save the randomization distribution to a file, next a window will pop up (for multiple baseline designs this is the third pop-up window, for all other designs it is the second window) to ask where to save it. This location can be an existing file, as well as a new file that can be created by giving a file name and the extension .txt. In this latter case a confirmation is required ("The file does not exist yet. Create the file?").


Bulte, I., & Onghena, P. (2008). An R package for single-case randomization tests. Behavior Research Methods, 40, 467-478.

Bulte, I., & Onghena, P. (2009). Randomization tests for multiple baseline designs: An extension of the SCRT-R package. Behavior Research Methods, 41, 477-485.


See Also

pvalue.random to obtain the corresponding p-value for the nonexhaustive randomization distribution.

observed to calculate the observed test statistic.

distribution.systematic to generate the exhaustive randomization distribution and pvalue.systematic to obtain the corresponding p-value.


distribution.random(design = "ABAB", statistic = "AA-BB", save = "no", 
number = 100, limit = 4, data = ABAB)

Search within the SCRT package
Search all R packages, documentation and source code

Questions? Problems? Suggestions? or email at ian@mutexlabs.com.

Please suggest features or report bugs with the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.