scipy.stats.multinomial#

scipy.stats.multinomial = <scipy.stats._multivariate.multinomial_gen object>[源代码]#

一个多项随机变量。

参数:
nint

试验次数

parray_like

每次试验落入每个类别的概率;总和应为 1

seed{None, int, np.random.RandomState, np.random.Generator}, 可选

用于绘制随机变量。如果 seedNone,则使用 RandomState 单例。如果 seed 是一个整数,则使用一个新的 RandomState 实例,并用种子进行播种。如果 seed 已经是 RandomStateGenerator 实例,则使用该对象。默认为 None

参见

scipy.stats.binom

二项分布。

numpy.random.Generator.multinomial

从多项分布中采样。

scipy.stats.multivariate_hypergeom

多元超几何分布。

注释

n 应该是非负整数。p 的每个元素都应在区间 \([0,1]\) 中,并且这些元素的总和应为 1。如果它们总和不为 1,则不使用 p 数组的最后一个元素,并将其替换为前面元素剩余的概率。

multinomial 的概率质量函数是

\[f(x) = \frac{n!}{x_1! \cdots x_k!} p_1^{x_1} \cdots p_k^{x_k},\]

支持于 \(x=(x_1, \ldots, x_k)\),其中每个 \(x_i\) 都是非负整数,并且它们的总和为 \(n\)

在 0.19.0 版本中添加。

示例

>>> from scipy.stats import multinomial
>>> rv = multinomial(8, [0.3, 0.2, 0.5])
>>> rv.pmf([1, 3, 4])
0.042000000000000072

\(k=2\) 的多项分布与相应的二项分布相同(尽管存在微小的数值差异)

>>> from scipy.stats import binom
>>> multinomial.pmf([3, 4], n=7, p=[0.4, 0.6])
0.29030399999999973
>>> binom.pmf(3, 7, 0.4)
0.29030400000000012

函数 pmflogpmfentropycov 支持广播,约定向量参数(xp)被解释为好像最后一个轴上的每一行都是一个对象。例如

>>> multinomial.pmf([[3, 4], [3, 5]], n=[7, 8], p=[.3, .7])
array([0.2268945,  0.25412184])

此处,x.shape == (2, 2)n.shape == (2,)p.shape == (2,),但按照上述规则,它们的行为就好像 x 中的行 [3, 4][3, 5] 以及 p 中的 [.3, .7] 是一个对象,并且我们有 x.shape = (2,)n.shape = (2,)p.shape = ()。要获得没有广播的单个元素,我们将执行此操作

>>> multinomial.pmf([3, 4], n=7, p=[.3, .7])
0.2268945
>>> multinomial.pmf([3, 5], 8, p=[.3, .7])
0.25412184

这种广播也适用于 cov,其中输出对象是大小为 p.shape[-1] 的方阵。例如

>>> multinomial.cov([4, 5], [[.3, .7], [.4, .6]])
array([[[ 0.84, -0.84],
        [-0.84,  0.84]],
       [[ 1.2 , -1.2 ],
        [-1.2 ,  1.2 ]]])

在此示例中,n.shape == (2,)p.shape == (2, 2),并且按照上述规则,它们广播为好像 p.shape == (2,)。因此,结果也应该具有形状 (2,),但由于每个输出都是 \(2 \times 2\) 矩阵,因此结果实际上具有形状 (2, 2, 2),其中 result[0] 等于 multinomial.cov(n=4, p=[.3, .7]),而 result[1] 等于 multinomial.cov(n=5, p=[.4, .6])

或者,可以调用该对象(作为函数)来固定 np 参数,从而返回“冻结的”多项随机变量

>>> rv = multinomial(n=7, p=[.3, .7])
>>> # Frozen object with the same methods but holding the given
>>> # degrees of freedom and scale fixed.

方法

pmf(x, n, p)

概率质量函数。

logpmf(x, n, p)

概率质量函数的对数。

rvs(n, p, size=1, random_state=None)

从多项分布中抽取随机样本。

entropy(n, p)

计算多项分布的熵。

cov(n, p)

计算多项分布的协方差矩阵。