tmean#
- scipy.stats.tmean(a, limits=None, inclusive=(True, True), axis=None, *, nan_policy='propagate', keepdims=False)[源代码]#
计算截断均值。
此函数查找给定值的算术平均值,忽略给定limits之外的值。
- 参数:
- aarray_like
值的数组。
- limitsNone 或 (下限, 上限),可选
输入数组中小于下限或大于上限的值将被忽略。当 limits 为 None(默认)时,将使用所有值。元组中的任一限制值也可以为 None,表示半开区间。
- inclusive(bool, bool),可选
一个包含(下限标志,上限标志)的元组。这些标志确定是否包含完全等于下限或上限的值。默认值为 (True, True)。
- axisint 或 None,默认值:None
如果为 int,则为沿其计算统计信息的输入轴。输入的每个轴切片(例如,行)的统计信息将显示在输出的相应元素中。如果为
None
,则在计算统计信息之前将展开输入。- nan_policy{‘propagate’, ‘omit’, ‘raise’}
定义如何处理输入 NaN。
propagate
:如果在计算统计信息的轴切片(例如,行)中存在 NaN,则输出的相应条目将为 NaN。omit
:执行计算时将省略 NaN。如果在计算统计信息的轴切片中剩余的数据不足,则输出的相应条目将为 NaN。raise
:如果存在 NaN,将引发ValueError
。
- keepdimsbool,默认值:False
如果将其设置为 True,则缩减的轴将保留在结果中,作为大小为 1 的维度。使用此选项,结果将与输入数组正确广播。
- 返回值:
- tmeanndarray
截断均值。
参见
trim_mean
从两端尾部修剪一定比例后返回平均值。
注释
从 SciPy 1.9 开始,
np.matrix
输入(不建议用于新代码)在执行计算之前会转换为np.ndarray
。在这种情况下,输出将是标量或具有适当形状的np.ndarray
,而不是 2Dnp.matrix
。 类似地,虽然忽略了掩码数组的掩码元素,但输出将是标量或np.ndarray
,而不是mask=False
的掩码数组。tmean
除了 NumPy 之外,还对 Python Array API Standard 兼容后端提供实验性支持。 请考虑通过设置环境变量SCIPY_ARRAY_API=1
并提供 CuPy、PyTorch、JAX 或 Dask 数组作为数组参数来测试这些功能。 支持以下后端和设备(或其他功能)的组合。库
CPU
GPU
NumPy
✅
不适用
CuPy
不适用
✅
PyTorch
✅
✅
JAX
✅
✅
Dask
✅
不适用
有关更多信息,请参见对数组 API 标准的支持。
示例
>>> import numpy as np >>> from scipy import stats >>> x = np.arange(20) >>> stats.tmean(x) 9.5 >>> stats.tmean(x, (3,17)) 10.0