dask.array.random.permutation

dask.array.random.permutation(x)

Randomly permute a sequence, or return a permuted range.

This docstring was copied from numpy.random.mtrand.RandomState.permutation.

Some inconsistencies with the Dask version may exist.

If x is a multi-dimensional array, it is only shuffled along its first index.

Note

New code should use the permutation method of a default_rng() instance instead; please see the Quick Start.

Parameters
xint or array_like

If x is an integer, randomly permute np.arange(x). If x is an array, make a copy and shuffle the elements randomly.

Returns
outndarray

Permuted sequence or array range.

See also

Generator.permutation

which should be used for new code.

Examples

>>> np.random.permutation(10)  
array([1, 7, 4, 3, 0, 9, 2, 5, 8, 6]) # random
>>> np.random.permutation([1, 4, 9, 12, 15])  
array([15,  1,  9,  4, 12]) # random
>>> arr = np.arange(9).reshape((3, 3))  
>>> np.random.permutation(arr)  
array([[6, 7, 8], # random
       [0, 1, 2],
       [3, 4, 5]])