megengine.functional.std

std(inp, axis=None, keepdims=False)[源代码]

在给定的维度 (或坐标轴) 上计算元素的标准差。

参数
  • inp (Tensor) – 输入张量。 应该有一个数字数据类型。

  • axis (Union[int, Sequence[int], None]) – 计算标准差的维度或坐标轴。默认情况下,标准差计算范围是 Tensor 中的全部元素。如果参数是整数数组,标准差将按照数组中整数给定的维度进行计算。

  • keepdims (bool) – 若为 “True”,则指定用来reduce的轴(维度)必须包含在结果中,因此,结果必须与输入tensor兼容(参见:ref:`broadcasting-rule `)。否则,若为 “False”,结果中不得包含用于reduce的轴(维度)。

返回类型

Tensor

返回

如果标准差计算范围是 Tensor 中的全部元素,计算结果将是一个没有维度的 Tensor,否则将是有维度的 Tensor 。

注解

标准差指的是数据方差的平方根结果,即 std = sqrt(mean(x)), where x = abs(a - a.mean())**2.

实际案例

>>> x = Tensor([[1, 2], [3, 4]])
>>> F.std(x)
Tensor(1.118034, device=xpux:0)
>>> x = Tensor([[14, 8, 11, 10], [7, 9, 10, 11], [10, 15, 5, 10]])
>>> F.std(x)
Tensor(2.6140645, device=xpux:0)