Programmer Guide/Command Reference/EVAL/shuffle

Create a shuffled version of a set.

Usage

shuffle(x {, n {, once { seed}}})

x

the set to be shuffled; must be a vector or matrix

n

the number of row exchanges applied top x; 0 < n (default=nrow(x)/2)

once

change row position only once

once=0: the number of exchanges of a row is not limited

once≠0: the number of exchanges of a row is limited to 1

seed

if this value is not equal 0, it is used to initialize the random number generator which generates the indices of the rows to be exchanged

Result

The result has the same type and content as x, but the order of the rows is changed (shuffled) randomly. To shuffle the row indices, n times two randomly selected rows are exchanged.

See also

rand, grand, sample, sort

<function list>