scipy.stats.

tstd#

scipy.stats.tstd(a, limits=None, inclusive=(True, True), axis=0, ddof=1, *, nan_policy='propagate', keepdims=False)[源代码]#

计算修剪后的样本标准差。

此函数查找给定值的样本标准差,忽略给定 limits 之外的值。

参数:
aarray_like

值数组。

limitsNone 或 (下限, 上限), 可选

输入数组中小于下限或大于上限的值将被忽略。当 limits 为 None 时,将使用所有值。元组中的任一限制值也可以为 None,表示半开区间。默认值为 None。

inclusive(bool, bool), 可选

一个由(下限标志,上限标志)组成的元组。这些标志确定是否包含正好等于下限或上限的值。默认值为 (True, True)。

axisint 或 None, 默认值: 0

如果为 int,则为计算统计量的输入轴。输入的每个轴切片(例如行)的统计量将出现在输出的相应元素中。如果为 None,则在计算统计量之前将展开输入。

ddofint, 可选

自由度增量。默认值为 1。

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

定义如何处理输入 NaN。

  • propagate:如果沿其计算统计量的轴切片(例如行)中存在 NaN,则输出的相应条目将为 NaN。

  • omit:执行计算时将忽略 NaN。如果沿其计算统计量的轴切片中剩余数据不足,则输出的相应条目将为 NaN。

  • raise:如果存在 NaN,将引发 ValueError

keepdimsbool, 默认值: False

如果设置为 True,则会将缩减的轴保留在结果中,作为大小为 1 的维度。使用此选项,结果将正确地广播到输入数组。

返回值:
tstdfloat

修剪后的样本标准差。

说明

tstd 计算无偏样本标准差,即使用校正因子 n / (n - 1)

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

示例

>>> import numpy as np
>>> from scipy import stats
>>> x = np.arange(20)
>>> stats.tstd(x)
5.9160797830996161
>>> stats.tstd(x, (3,17))
4.4721359549995796