scipy.stats.
tmax#
- scipy.stats.tmax(a, upperlimit=None, axis=0, inclusive=True, nan_policy='propagate', *, keepdims=False)[来源]#
计算修剪的最大值。
此函数计算沿着给定轴的数组的最大值,同时忽略大于指定上限的值。
- 参数:
- aarray_like
值数组。
- upperlimit无或浮点数,可选
输入数组中大于给定限制的值将被忽略。当 upperlimit 为无时,使用所有值。默认值为 None。
- axis整数或无,默认值为 0
如果为整数,则输入轴是计算统计数据的。输入的每个轴切片(例如,行)的统计数据将显示在输出的对应元素中。如果为
None
,则计算统计数据之前将对输入进行扁平化。- inclusive{True, False},可选
此标志确定是否包含等于上限的值。默认值为 True。
- nan_policy{'propagate', 'omit', 'raise'}
定义如何处理输入 NaN。
propagate
:如果沿计算统计数据的轴段(例如,行)中存在 NaN,则输出的相应条目将为 NaN。omit
:在执行计算时,将忽略 NaN。如果沿计算统计数据的轴段中剩余的数据不足,则输出的相应条目将为 NaN。raise
:如果存在 NaN,则会引发ValueError
。
- keepdims布尔值,默认值:False
如果将此项设置为 True,则缩减的轴会作为尺寸大小为一的维度保留在结果中。使用此选项,结果将针对输入数组进行正确的广播。
- 返回:
- tmax浮点数、整数或 ndarray
修剪后的最大值。
备注
从 SciPy 1.9 开始,
np.matrix
输入(不建议用于新代码)在执行计算之前会被转换为np.ndarray
。在这种情况下,输出将是标量或形状合适的np.ndarray
,而不是二维np.matrix
。类似地,虽然会忽略掩码数组的掩码元素,但输出将是标量或np.ndarray
,而不是 mask=False 的掩码数组。示例
>>> import numpy as np >>> from scipy import stats >>> x = np.arange(20) >>> stats.tmax(x) 19
>>> stats.tmax(x, 13) 13
>>> stats.tmax(x, 13, inclusive=False) 12