jax.random.multivariate_normal#
- jax.random.multivariate_normal(key, mean, cov, shape=None, dtype=None, method='cholesky')[source]#
使用给定的均值和协方差采样多元正态随机值。
这些值根据概率密度函数返回
\[f(x;\mu, \Sigma) = (2\pi)^{-k/2} \det(\Sigma)^{-1}e^{-\frac{1}{2}(x - \mu)^T \Sigma^{-1} (x - \mu)}\]其中 \(k\) 是维数,\(\mu\) 是均值(由
mean
给出)和 \(\Sigma\) 是协方差矩阵(由cov
给出)。- 参数::
key (KeyArrayLike) – 用作随机键的 PRNG 键。
mean (RealArray) – 形状为
(..., n)
的均值向量。cov (RealArray) – 形状为
(..., n, n)
的正定协方差矩阵。批次形状...
必须与mean
的批次形状广播兼容。shape (Shape | None | None) – 可选,一个非负整数元组,指定结果批次形状;即,结果形状中除最后一个轴以外的前缀。必须与
mean.shape[:-1]
和cov.shape[:-2]
广播兼容。默认值(None)通过将mean
和cov
的批次形状广播在一起生成结果批次形状。dtype (DTypeLikeFloat | None | None) – 可选,返回值的浮点类型(如果 jax_enable_x64 为真,则默认为 float64,否则为 float32)。
method (str) – 可选,计算
cov
因子的方法。必须是 'svd'、'eigh' 和 'cholesky' 之一。默认 'cholesky'。对于奇异协方差矩阵,请使用 'svd' 或 'eigh'。
- 返回值:
一个具有指定数据类型和形状的随机数组,该形状由
shape + mean.shape[-1:]
给出(如果shape
不为 None),否则为broadcast_shapes(mean.shape[:-1], cov.shape[:-2]) + mean.shape[-1:]
。- 返回类型: