a vector (or matrix, when multiple treatment factors are present) of assignments.
nrand
a number specifying the desired number of random hypothetical assignments.
calcTestStat
a function to calculate the specified test statistic(s).
calcOptions
a list of options for calculating the test statistic(s) (if necessary).
calcPO
a function to calculate potential outcomes (defaults to zeroEffect).
poOptions
a list of options for calculating potential outcomes (if necessary).
randOptions
a list of options governing the random assignment mechanism.
userRand
a function to generate random assignments (if necessary).
userOptions
a list of options governing the user-defined random assignment mechanism (if necessary).
null
a number or numeric vector specifying the comparison value(s) under the null hypothesis.
alternative
a character string specifying the alternative hypothesis, must be one of the following: "two.sided" (default), "greater", or "less".
Details
The inputs to calcTestStat are y, w, and calcOptions (if necessary).
The output of calcTestStat is a number or numeric vector representing the test statistic value(s).
Several common test statistics (diffMeans, anovaF, diffMeansVector) are built-in for convenience.
calcTestStat can also be a custom function, as long as the inputs and output are as described above.
If multiple test statistics are tested simultaneously, users should be wary of multiple comparisons and make appropriate adjustments (e.g., Bonferroni corrections).
The inputs to calcPO are y, w, w_new (a vector or matrix of modified assignments), and poOptions (if necessary).
The output of calcPO is a vector of potential outcomes under the modified assignments.
Two common potential outcome calculations (zeroEffect (default) and constEffect) are built-in for convenience.
calcPO can also be a custom function, as long as the inputs and output are as described above.
If unspecified, randOptions$type defaults to "complete".
If randOptions$type equals "block", then randOptions$block must be specified.
If randOptions$type equals "Latin", then randOptions$row and randOptions$col must be specified.
If randOptions$type equals "user.defined", then userRand must be specified.
The inputs to userRand are nrand and userOptions (if necessary).
If null is specified, its length must equal the length of the output of calcTestStat.
If unspecified, null defaults to 0 or an appropriately sized vector of 0's.
alternative="greater" is the alternative that the test statistic is greater than the comparison value.
Value
A list containing the following elements:
perm_stats
a vector or matrix of hypothetical test statistic values.
obs_stat
the observed test statistic value(s).
null
a number or numeric vector specifying the comparison value(s) under the null hypothesis.
alternative
a character string specifying the alternative hypothesis.
pvalue
the randomization-based p-value(s).
Author(s)
Joseph J. Lee and Tirthankar Dasgupta
References
Wu, C. F. J. and Hamada, M. (2009) Experiments, Planning, Analysis and Optimization (2nd ed), Wiley.
Moore, David S., and George P. McCabe (1989). Introduction to the Practice of Statistics. Original source: study conducted by Jim Baumann and Leah Jones of the Purdue University Education Department.