scipy.stats.matrix_normal#

scipy.stats.matrix_normal = <scipy.stats._multivariate.matrix_normal_gen object>[source]#

矩阵正态随机变量。

mean 关键字指定均值。rowcov 关键字指定行间协方差矩阵。“colcov”关键字指定列间协方差矩阵。

参数:
meanarray_like,可选

分布的均值(默认:None

rowcovarray_like,可选

分布的行间协方差矩阵(默认:1

colcovarray_like,可选

分布的列间协方差矩阵(默认:1

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

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

备注

如果 mean 设置为 None,则使用一个全零矩阵作为平均值。此矩阵的维度可以从 rowcovcolcov 的形状推断出来(如果它们有提供),如果二义性,则设置为 1

rowcovcolcov 可以是直接指定协方差矩阵的二维数组类似物。或者,一维数组可解释为对角矩阵的条目,标量或零维数组可解释为该值乘以单位矩阵。

rowcovcolcov 指定的协方差矩阵必须为(对称)正定矩阵。如果 X 中的样本为 \(m \times n\),则 rowcov 必须为 \(m \times m\),并且 colcov 必须为 \(n \times n\)mean 必须与 X 具有相同的形状。

对于 matrix_normal,概率密度函数为

\[f(X) = (2 \pi)^{-\frac{mn}{2}}|U|^{-\frac{n}{2}} |V|^{-\frac{m}{2}} \exp\left( -\frac{1}{2} \mathrm{Tr}\left[ U^{-1} (X-M) V^{-1} (X-M)^T \right] \right),\]

其中 \(M\) 是均值,\(U\) 是行内协方差矩阵,\(V\) 是列间协方差矩阵。

目前不支持 multivariate_normal 分布的 allow_singular 行为。协方差矩阵必须是满秩的。

scipy.stats.matrix_normal 分布与 scipy.stats.multivariate_normal 分布密切相关。具体而言,Vec(X)(通过连接 X 的列形成的向量)具有均值为 Vec(M) 和协方差为 V ⊗ U (其中 ⊗ 是克罗内克积) 的多元正态分布。对于矩阵正态分布,采样和 pdf 评估是 O(m3 + n3 + m2 n + mn2),但对于等效的多元正态分布,采样和 pdf 评估是 O(m3 n3),这使得此等效形式在算法上效率低下。

从版本 0.17.0 开始添加。

示例

>>> import numpy as np
>>> from scipy.stats import matrix_normal
>>> M = np.arange(6).reshape(3,2); M
array([[0, 1],
       [2, 3],
       [4, 5]])
>>> U = np.diag([1,2,3]); U
array([[1, 0, 0],
       [0, 2, 0],
       [0, 0, 3]])
>>> V = 0.3*np.identity(2); V
array([[ 0.3,  0. ],
       [ 0. ,  0.3]])
>>> X = M + 0.1; X
array([[ 0.1,  1.1],
       [ 2.1,  3.1],
       [ 4.1,  5.1]])
>>> matrix_normal.pdf(X, mean=M, rowcov=U, colcov=V)
0.023410202050005054
>>> # Equivalent multivariate normal
>>> from scipy.stats import multivariate_normal
>>> vectorised_X = X.T.flatten()
>>> equiv_mean = M.T.flatten()
>>> equiv_cov = np.kron(V,U)
>>> multivariate_normal.pdf(vectorised_X, mean=equiv_mean, cov=equiv_cov)
0.023410202050005054

另外,可以调用该对象(作为函数)来固定均值和协方差参数,返回“冻结”矩阵正态随机变量

>>> rv = matrix_normal(mean=None, rowcov=1, colcov=1)
>>> # Frozen object with the same methods but holding the given
>>> # mean and covariance fixed.

方法

pdf(X, mean=None, rowcov=1, colcov=1)

概率密度函数。

logpdf(X, mean=None, rowcov=1, colcov=1)

概率密度函数的对数。

rvs(mean=None, rowcov=1, colcov=1, size=1, random_state=None)

绘制随机样本。

entropy(rowcol=1, colcov=1)

微分熵。