numpy.random.Generator.shuffle#

方法

random.Generator.shuffle(x, axis=0)#

就地修改陣列或序列，透過混亂其內容。

子陣列的順序會被更改，但其內容保持不變。

參數:

xndarray 或 MutableSequence: 要混亂的陣列、列表或可變序列。
axisint，選用: x 沿著混亂的軸。預設值為 0。僅在 ndarray 物件上支援。

回傳值:

None

參見

permuted
permutation

說明

方法 shuffle 與 permuted 之間的重要區別在於它們如何處理 axis 參數，可以在處理軸參數中找到。

範例

>>> rng = np.random.default_rng()
>>> arr = np.arange(10)
>>> arr
array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9])
>>> rng.shuffle(arr)
>>> arr
array([2, 0, 7, 5, 1, 4, 8, 9, 3, 6]) # random

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

>>> arr = np.arange(9).reshape((3, 3))
>>> arr
array([[0, 1, 2],
       [3, 4, 5],
       [6, 7, 8]])
>>> rng.shuffle(arr, axis=1)
>>> arr
array([[2, 0, 1], # random
       [5, 3, 4],
       [8, 6, 7]])