var

paddle.var ( x, axis\=None, unbiased\=True, keepdim\=False, name\=None ) [源代码]

沿给定的轴 axis 计算 x 中元素的方差。

参数

  • x (Tensor) - 输入的Tensor,数据类型为:float32、float64。

  • axis (int|list|tuple, 可选) - 指定对 x 进行计算的轴。axis 可以是int、list(int)、tuple(int)。如果 axis 包含多个维度,则沿着 axis 中的所有轴进行计算。axis 或者其中的元素值应该在范围[-D, D)内,D是 x 的维度。如果 axis 或者其中的元素值小于0,则等价于

    var - 图1

    。如果 axis 是None,则对 x 的全部元素计算方差。默认值为None。

  • unbiased (bool, 可选) - 是否使用无偏估计来计算方差。使用

    var - 图2

    来代表在 axis 上的维度,如果 unbiased 为True, 则在计算中使用 N−1N−1 作为除数。为 False 时将使用 NN 作为除数。默认值为True。

  • keepdim (bool, 可选) - 是否在输出Tensor中保留减小的维度。如果 keepdim 为True,则输出Tensor和 x 具有相同的维度(减少的维度除外,减少的维度的大小为1)。否则,输出Tensor的形状会在 axis 上进行squeeze操作。默认值为False。

  • name (str, 可选) - 操作的名称(可选,默认值为None)。更多信息请参见 Name

返回

Tensor ,沿着 axis 进行方差计算的结果,数据类型和 x 相同。

代码示例

  1. import paddle
  2. x = paddle.to_tensor([[1.0, 2.0, 3.0], [1.0, 4.0, 5.0]])
  3. out1 = paddle.var(x)
  4. # [2.66666667]
  5. out2 = paddle.var(x, axis=1)
  6. # [1. 4.33333333]