scipy.stats.mstats.gmean

scipy.stats.mstats.gmean(a, axis=0, dtype=None, weights=None)[源代码]

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

返回数组元素的几何平均值。即:(X1)的第n次根 * x2 * .*xn)

参数
aarray_like

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

axis整型或无型,可选

沿其计算几何平均值的轴。默认值为0。如果没有,则对整个阵列进行计算 a

dtype数据类型,可选

返回数组的类型和元素求和所在的累加器的类型。如果未指定dtype,则默认为a的数据类型,除非a具有精度小于默认平台整数的整数dtype。在这种情况下,使用默认平台整数。

weightsARRAY_LIKE,可选

权重数组可以是一维的(在这种情况下,其长度必须是 a 沿着给定的 axis )或形状与 a 。默认值为None,即为每个值赋予1.0的权重。

退货
gmeanndarray

看见 dtype 上述参数。

参见

numpy.mean

算术平均

numpy.average

加权平均

hmean

调和平均

注意事项

几何平均值是在输入数组的单个维度上计算的,默认情况下,AXIS=0,如果AXIS=NONE,则计算数组中的所有值。float64中间值和返回值用于整数输入。

使用掩码数组可以忽略输入中的任何非有限值或计算中出现的任何非有限值,例如非数字和无穷大,因为掩码数组会自动掩码任何非有限值。

参考文献

1

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

示例

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