larray.random.permutation

larray.random.permutation(x, axis=0) Array[source]

Randomly permute a sequence along an axis, or return a permuted range.

Parameters
xint or array_like

If x is an integer, randomly permute sequence(x). If x is an array, returns a randomly shuffled copy.

axisint, str or Axis, optional

Axis along which to permute. Defaults to the first axis.

Returns
Array

Permuted sequence or array range.

Examples

>>> la.random.permutation(10)                               
{0}*  0  1  2  3  4  5  6  7  8  9
      6  8  0  9  4  7  1  5  3  2
>>> la.random.permutation([1, 4, 9, 12, 15])                
{0}*  0   1   2  3  4
      1  15  12  9  4
>>> la.random.permutation(la.ndtest(5))                     
a  a3  a1  a2  a4  a0
    3   1   2   4   0
>>> arr = la.ndtest((3, 3))                                 
>>> la.random.permutation(arr)                              
a\b  b0  b1  b2
 a1   3   4   5
 a2   6   7   8
 a0   0   1   2
>>> la.random.permutation(arr, axis='b')                    
a\b  b1  b2  b0
 a0   1   2   0
 a1   4   5   3
 a2   7   8   6