numpy.random.Generator.permuted#

method

random.Generator.permuted(x, axis=None, out=None)#

沿轴 axis 随机置换 x .

与 shuffle 不同,沿着给定轴的每个切片都是彼此独立地进行洗牌的.

参数:
xarray_like,至少一维

要打乱的数组.

axis整数,可选

x 在此轴上的切片被打乱.每个切片都与其他切片独立地被打乱.如果 axis 为 None,则展平的数组被打乱.

outndarray, 可选

如果给定,则是打乱数组的目标位置.如果 out 为 None,则返回数组的打乱副本.

返回:
ndarray

如果 out 为 None,则返回 x 的一个打乱副本.否则,打乱后的数组存储在 out 中,并返回 out .

参见

shuffle
permutation

注释

方法 shuffle 和 permuted 的一个重要区别是它们如何处理可以在 处理 axis 参数 中找到的 axis 参数.

示例

创建一个 numpy.random.Generator 实例:

>>> rng = np.random.default_rng()

创建一个测试数组:

>>> x = np.arange(24).reshape(3, 8)
>>> x
array([[ 0,  1,  2,  3,  4,  5,  6,  7],
       [ 8,  9, 10, 11, 12, 13, 14, 15],
       [16, 17, 18, 19, 20, 21, 22, 23]])

打乱 x 的行:

>>> y = rng.permuted(x, axis=1)
>>> y
array([[ 4,  3,  6,  7,  1,  2,  5,  0],  # random
       [15, 10, 14,  9, 12, 11,  8, 13],
       [17, 16, 20, 21, 18, 22, 23, 19]])

x 没有被修改:

>>> x
array([[ 0,  1,  2,  3,  4,  5,  6,  7],
       [ 8,  9, 10, 11, 12, 13, 14, 15],
       [16, 17, 18, 19, 20, 21, 22, 23]])

要在原地打乱 x 的行,将 x 作为 out 参数传递:

>>> y = rng.permuted(x, axis=1, out=x)
>>> x
array([[ 3,  0,  4,  7,  1,  6,  2,  5],  # random
       [ 8, 14, 13,  9, 12, 11, 15, 10],
       [17, 18, 16, 22, 19, 23, 20, 21]])

请注意,当给出 out 参数时,返回值是 out :

>>> y is x
True