Shuffle - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

Statistics

  

Shuffle

  

apply random permutation to a data sample

 

Calling Sequence

Parameters

Description

Notes

Examples

Calling Sequence

Shuffle(X, options)

Parameters

X

-

data sample

options

-

(optional) equation of the form inplace = truefalse; indicates whether to change the argument

Description

• 

The Shuffle command applies a random permutation to X.

• 

The first parameter X is a data sample - given as e.g. a Vector.

• 

An option inplace = true or inplace = false can be specified as a second argument. With inplace = true, Shuffle will change X in place if it is an Array or a Vector; with inplace = false, Shuffle will return a new (shuffled) copy of X. If X is a list, then Shuffle returns a new copy either way. The default is inplace = false.

  

The option inplace = true can be abbreviated to inplace.

Notes

• 

The Shuffle command accepts non-numeric data.

Examples

withStatistics:

AArraya,b,c,d,e,f,g,h,i,j

Aabcdefghij

(1)

A1ShuffleA

A1gdeaifbhjc

(2)

A2ShuffleA

A2cejgafbhid

(3)

A3ShuffleA

A3cdibhefjga

(4)

sortA1

abcdefghij

(5)

BArrayseqi,i=1..10

B12345678910

(6)

CShuffleB

C10351269487

(7)

OrderByRankA,C

debhcfjiga

(8)

So far, A itself has not changed. The inplace option changes this.

A

abcdefghij

(9)

ShuffleA,inplace:A

edhibjgcfa

(10)

Note that the output of Maple's random number generator is reproducible after a restart. If this is undesirable, one can use the randomize command.

restart

withStatistics:

AArraya,b,c,d,e,f,g,h,i,j

Aabcdefghij

(11)

A1ShuffleA

A1gdeaifbhjc

(12)

restart

withStatistics:

AArraya,b,c,d,e,f,g,h,i,j

Aabcdefghij

(13)

randomize

47294191414

(14)

A1ShuffleA

A1fchjgdibea

(15)

See Also

Statistics

Statistics[Computation]

Statistics[OrderByRank]

Statistics[Rank]

Statistics[Sort]

 


Download Help Document