Nonexhaustive randomization distribution

Share:

Description

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

Usage

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

Arguments

design

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).

statistic

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

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

number

Number of randomizations required.

limit

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

data

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

starts

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.

Details

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?").

References

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.

http://ppw.kuleuven.be/english/research/mesrg

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.

Examples

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