std¶
沿给定的轴 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,则等价于 \(axis + D\) 。如果axis是None,则对x的全部元素计算标准差。默认值为None。unbiased (bool, 可选) - 是否使用无偏估计来计算标准差。使用 \(N\) 来代表在 axis 上的维度,如果
unbiased为True, 则在计算中使用 \(N - 1\) 作为除数。为 False 时将使用 \(N\) 作为除数。默认值为True。keepdim (bool, 可选) - 是否在输出Tensor中保留减小的维度。如果
keepdim为True,则输出Tensor和x具有相同的维度(减少的维度除外,减少的维度的大小为1)。否则,输出Tensor的形状会在axis上进行squeeze操作。默认值为False。name (str, 可选) - 操作的名称(可选,默认值为None)。更多信息请参见 Name。
返回¶
Tensor,沿着axis进行标准差计算的结果,数据类型和x相同。
代码示例¶
import paddle
x = paddle.to_tensor([[1.0, 2.0, 3.0], [1.0, 4.0, 5.0]])
out1 = paddle.std(x)
# [1.63299316]
out2 = paddle.std(x, axis=1)
# [1. 2.081666]