numpy.random.Generator.choice#

method

random.Generator.choice(a, size=None, replace=True, p=None, axis=0, shuffle=True)#

从给定数组中生成随机样本

参数:
a{array_like, int}

如果是一个 ndarray,则从它的元素中生成一个随机样本.如果是一个 int,则从 np.arange(a) 中生成随机样本.

size{int, tuple[int]}, optional

输出形状.如果给定的形状是, e.g., (m, n, k) , 那么从 1-d a 中抽取 m * n * k 个样本.如果 a 有多个维度, size 形状将会被插入到 axis 维度, 因此输出 ndim 将会是 a.ndim - 1 + len(size) .默认是 None,此时返回一个单独的值.

replacebool,可选

样本是有放回还是无放回.默认为 True,表示 a 的值可以被多次选择.

p1-D array_like, 可选

与 a 中每个条目相关联的概率.如果未给出,则样本假定在 a 的所有条目上均匀分布.

轴int, optional

执行选择的轴.默认值 0 按行选择.

shufflebool,可选

在没有替换的情况下进行采样时,是否对样本进行洗牌.默认为 True,False 提供加速.

返回:
samples单个条目或者ndarray

生成的随机样本

Raises:
ValueError

如果 a 是小于零的整数,如果 p 不是 1 维的,如果 a 是大小为 0 的类数组,如果 p 不是概率向量,如果 a 和 p 的长度不同,或者如果 replace=False 且样本大小大于总体大小.

参见

integers , shuffle , permutation

注释

通过 p 设置用户指定的概率使用比默认值更通用但效率较低的采样器.即使 p 的每个元素都是 1 / len(a),通用采样器也会产生与优化采样器不同的样本.

当强制转换为 float64 时, p 必须总和为 1.为确保这一点,您可能希望使用 p = p / np.sum(p, dtype=float) 进行归一化.

当传递 a 作为整数类型并且未指定 size 时,返回类型是原生 Python int .

示例

从大小为 3 的 np.arange(5) 生成均匀随机样本:

>>> rng = np.random.default_rng()
>>> rng.choice(5, 3)
array([0, 3, 4]) # random
>>> #This is equivalent to rng.integers(0,5,3)

从大小为 3 的 np.arange(5) 生成非均匀随机样本:

>>> rng.choice(5, 3, p=[0.1, 0, 0.3, 0.6, 0])
array([3, 3, 0]) # random

从大小为 3 的 np.arange(5) 生成无放回的均匀随机样本:

>>> rng.choice(5, 3, replace=False)
array([3,1,0]) # random
>>> #This is equivalent to rng.permutation(np.arange(5))[:3]

沿第一个轴(默认)从二维数组生成无放回的均匀随机样本:

>>> rng.choice([[0, 1, 2], [3, 4, 5], [6, 7, 8]], 2, replace=False)
array([[3, 4, 5], # random
       [0, 1, 2]])

从大小为 3 的 np.arange(5) 生成无放回的非均匀随机样本:

>>> rng.choice(5, 3, replace=False, p=[0.1, 0, 0.3, 0.6, 0])
array([2, 3, 0]) # random

以上任何一种都可以使用任意类数组而不是整数来重复.例如:

>>> aa_milne_arr = ['pooh', 'rabbit', 'piglet', 'Christopher']
>>> rng.choice(aa_milne_arr, 5, p=[0.5, 0.1, 0.1, 0.3])
array(['pooh', 'pooh', 'pooh', 'Christopher', 'piglet'], # random
      dtype='<U11')
On this page