scipy.stats.mstats.

gmean#

scipy.stats.mstats.gmean(a, axis=0, dtype=None, weights=None, *, nan_policy='propagate', keepdims=False)[source]#

沿指定轴计算加权几何平均值。

与权重 \(w_i\) 关联的数组 \(a_i\) 的加权几何平均值是

\[\exp \left( \frac{ \sum_{i=1}^n w_i \ln a_i }{ \sum_{i=1}^n w_i } \right) \, ,\]

并且，在权重相等的情况下，它给出

\[\sqrt[n]{ \prod_{i=1}^n a_i } \, .\]

参数:

a类数组

输入数组或可以转换为数组的对象。

axisint 或 None，默认值：0

如果为 int，则为输入沿其计算统计量的轴。输入的每个轴切片（例如，行）的统计量将出现在输出的相应元素中。如果为 None，则在计算统计量之前会将输入展平。

dtypedtype，可选

在执行计算之前将输入数组转换为的类型。

weights类数组，可选

weights 数组必须可广播到与 a 相同的形状。默认值为 None，它为每个值赋予 1.0 的权重。

nan_policy{‘propagate’, ‘omit’, ‘raise’}

定义如何处理输入 NaN。

propagate: 如果在计算统计量的轴切片（例如，行）中存在 NaN，则输出的对应条目将为 NaN。
omit: 在执行计算时将忽略 NaN。如果在计算统计量的轴切片中剩余数据不足，则输出的对应条目将为 NaN。
raise: 如果存在 NaN，则会引发 ValueError。

keepdimsbool，默认值：False

如果将其设置为 True，则将被减少的轴保留在结果中，作为大小为一的维度。使用此选项，结果将与输入数组正确广播。

返回值:

gmeanndarray: 请参阅上面的 dtype 参数。

另请参阅

numpy.mean: 算术平均值
numpy.average: 加权平均值
hmean: 调和平均值

注释

从 SciPy 1.9 开始，np.matrix 输入（不推荐用于新代码）在执行计算之前会转换为 np.ndarray。在这种情况下，输出将是标量或形状适当的 np.ndarray，而不是 2D np.matrix。同样，虽然忽略了掩码数组的掩码元素，但输出将是标量或 np.ndarray，而不是具有 mask=False 的掩码数组。

参考资料

[1]

“加权几何平均值”，维基百科，https://en.wikipedia.org/wiki/Weighted_geometric_mean.

[2]

Grossman, J., Grossman, M., Katz, R., “平均值：一种新方法”，阿基米德基金会，1983 年

示例

>>> from scipy.stats import gmean
>>> gmean([1, 4])
2.0
>>> gmean([1, 2, 3, 4, 5, 6, 7])
3.3800151591412964
>>> gmean([1, 4, 7], weights=[3, 1, 3])
2.80668351922014