Rsampling {Rsampling} | R Documentation |
Repeats randomizations and scores summary statistics
Description
Repeats resampling/shuffling of dataframes and scores the values returned by user-define function which is applied to each randomized dataframe.
Usage
Rsampling(type = c("normal_rand", "rows_as_units", "columns_as_units",
"within_rows", "within_columns"), dataframe, statistics, ntrials = 10000,
simplify = TRUE, progress = "text", fix.zeroes = FALSE, ...)
Arguments
type |
character; the name of the randomization function to be applied to |
dataframe |
a dataframe with the data to be shuffled or resampled. |
statistics |
a function that calculates the statistics of interest from the dataframe. The first argument should be the dataframe with the data and preferably should return a (named) vector, data frame, matrix or array. |
ntrials |
integer; number of randomizations to perform. |
simplify |
logical; should the result be simplified to a vector, matrix or higher dimensional array if possible? |
progress |
which kind of progress bar should be used (currently unimplemented!) |
fix.zeroes |
logical; for normal_rand, within_rows or within_columns, should zeroes in the dataframe
be kept in place? See the help on |
... |
further arguments to be passed to the randomization functions
(e.g., |
Value
a list of objects returned by the function defined by statistics
or a vector, matrix or array when simplify=TRUE
and simplification can be done
(see simplify2array
).
Details
This function corresponds to Repeat and score in Resampling Stats add-in for Excel
(www.resample.com). The randomization function defined by type
is applied ntrials
times on the data provided by dataframe
. At each trial the function defined by argument
statistics
is applied to the resulting dataframe and the resulting objects are returned.
References
Statistics.com LCC. 2009. Resampling Stats Add-in for Excel User's Guide. http://www.resample.com/content/software/excel/userguide/RSXLHelp.pdf