numpy.random.Generator.hypergeometric

метод

random.Generator.hypergeometric(ngood, nbad, nsample, size=None)

Генерация выборок из гипергеометрического распределения.

Выборка производится из гипергеометрического распределения со следующими параметрами: ngood (способы сделать хороший выбор), nbad (способы сделать плохой выбор), и nsample (количество отобранных элементов, которое меньше или равно сумме ngood + nbad).

Параметры

ngoodint или array_like целых чисел

Количество способов сделать хороший выбор. Должно быть неотрицательным и меньше 10**9.

nbadint или array_like целых чисел

Количество способов сделать плохой выбор. Должно быть неотрицательным и меньше 10**9.

nsampleint или array_like целых чисел

Количество отобранных элементов. Должно быть неотрицательным и меньше ngood + nbad.

sizeint или кортеж из целых чисел, необязательно

Форма выходных данных. Если заданная форма, например, (m, n, k), тогда m * n * k выборок генерируются. Если size не указан (по умолчанию), возвращается одно значение, если ngood, nbad, и nsample являются скалярами. В противном случае np.broadcast(ngood, nbad, nsample).size выборок генерируются.

Возвращает

outndarray или скаляр

Сгенерированные выборки из гипергеометрического распределения. Каждая выборка — количество «хороших» элементов в случайной подвыборке размера nsample, взятой из набора ngood «хороших» элементов и nbad «плохих» элементов.

См. также

multivariate_hypergeometric

Генерирует выборки из многомерного гипергеометрического распределения.

scipy.stats.hypergeom

Функция плотности вероятности, распределение или кумулятивная функция распределения и т. д.

Примечания

Функция плотности вероятности гипергеометрического распределения:

\[P(x) = \frac{\binom{g}{x}\binom{b}{n-x}}{\binom{g+b}{n}},\]

где \(0 \le x \le n\) и \(n-b \le x \le g\)

для P(x) вероятности x «хороших» результатов в отобранной выборке, g = ngood, b = nbad, и n = nsample.

Представьте урну с черными и белыми шариками, ngood из них черные, и nbad — белые. Если вы вытаскиваете nsample шариков без возвращения, то гипергеометрическое распределение описывает распределение черных шариков в отобранной выборке.

Обратите внимание, что это распределение очень похоже на биномиальное распределение, за исключением того, что в этом случае выборки делаются без возвращения, а в случае биномиального распределения — с возвращением (или пространство выборки бесконечно). По мере увеличения пространства выборки это распределение приближается к биномиальному.

Аргументы ngood и nbad должны быть меньше 10**9. Для чрезвычайно больших аргументов алгоритм, используемый для вычисления выборок [4], дает сбой из-за потери точности в вычислениях с плавающей запятой. Для таких больших значений, если nsample также не велико, распределение может быть аппроксимировано биномиальным распределением, binomial(n=nsample, p=ngood/(ngood + nbad)).

Ссылки

1

Lentner, Marvin, “Elementary Applied Statistics”, Bogden and Quigley, 1972.

2

Weisstein, Eric W. “Hypergeometric Distribution.” From MathWorld–A Wolfram Web Resource. http://mathworld.wolfram.com/HypergeometricDistribution.html

3

Wikipedia, “Hypergeometric distribution”, https://en.wikipedia.org/wiki/Hypergeometric_distribution

4

Stadlober, Ernst, “The ratio of uniforms approach for generating discrete random variates”, Journal of Computational and Applied Mathematics, 31, pp. 181-189 (1990).

Примеры

Генерация выборок из распределения:

>>> rng = np.random.default_rng()
>>> ngood, nbad, nsamp = 100, 2, 10
# number of good, number of bad, and number of samples
>>> s = rng.hypergeometric(ngood, nbad, nsamp, 1000)
>>> from matplotlib.pyplot import hist
>>> hist(s)
#   note that it is very unlikely to grab both bad items

Предположим, у вас есть урна с 15 белыми и 15 черными шариками. Если вы вытаскиваете 15 шариков случайным образом, какова вероятность того, что 12 или более из них — одного цвета?

>>> s = rng.hypergeometric(15, 15, 15, 100000)
>>> sum(s>=12)/100000. + sum(s<=3)/100000.
#   answer = 0.003 ... pretty unlikely!