|
6 | 6 | .. py:function:: paddle.normal(mean=0.0, std=1.0, shape=None, name=None) |
7 | 7 |
|
8 | 8 |
|
9 | | -返回符合正态分布(均值为 ``mean`` ,标准差为 ``std`` 的正态随机分布)的随机Tensor。 |
| 9 | +返回符合正态分布(均值为 ``mean`` ,标准差为 ``std`` 的正态随机分布)的随机 Tensor。 |
10 | 10 |
|
11 | | -如果 ``mean`` 是Tensor,则输出Tensor和 ``mean`` 具有相同的形状和数据类型。 |
12 | | -如果 ``mean`` 不是Tensor,且 ``std`` 是Tensor,则输出Tensor和 ``std`` 具有相同的形状和数据类型。 |
13 | | -如果 ``mean`` 和 ``std`` 都不是Tensor,则输出Tensor的形状为 ``shape``,数据类型为float32。 |
| 11 | +如果 ``mean`` 是 Tensor,则输出 Tensor 和 ``mean`` 具有相同的形状和数据类型。 |
| 12 | +如果 ``mean`` 不是 Tensor,且 ``std`` 是 Tensor,则输出 Tensor 和 ``std`` 具有相同的形状和数据类型。 |
| 13 | +如果 ``mean`` 和 ``std`` 都不是 Tensor,则输出 Tensor 的形状为 ``shape``,数据类型为 float32。 |
14 | 14 |
|
15 | | -如果 ``mean`` 和 ``std`` 都是Tensor,则 ``mean`` 和 ``std`` 的元素个数应该相同。 |
| 15 | +如果 ``mean`` 和 ``std`` 都是 Tensor,则 ``mean`` 和 ``std`` 的元素个数应该相同。 |
16 | 16 |
|
17 | 17 | 参数 |
18 | 18 | :::::::::: |
19 | | - - mean (float|Tensor, 可选) - 输出Tensor的正态分布的平均值。如果 ``mean`` 是float,则表示输出Tensor中所有元素的正态分布的平均值。如果 ``mean`` 是Tensor(支持的数据类型为float32、float64),则表示输出Tensor中每个元素的正态分布的平均值。默认值为0.0 |
20 | | - - std (float|Tensor, 可选) - 输出Tensor的正态分布的标准差。如果 ``std`` 是float,则表示输出Tensor中所有元素的正态分布的标准差。如果 ``std`` 是Tensor(支持的数据类型为float32、float64),则表示输出Tensor中每个元素的正态分布的标准差。默认值为0.0 |
21 | | - - shape (list|tuple|Tensor, 可选) - 生成的随机Tensor的形状。如果 ``shape`` 是list、tuple,则其中的元素可以是int,或者是形状为[1]且数据类型为int32、int64的Tensor。如果 ``shape`` 是Tensor,则是数据类型为int32、int64的1-D Tensor。如果 ``mean`` 或者 ``std`` 是Tensor,输出Tensor的形状和 ``mean`` 或者 ``std`` 相同(此时 ``shape`` 无效)。默认值为None。 |
22 | | - - name (str, 可选) - 操作的名称(可选,默认值为None)。更多信息请参见 :ref:`api_guide_Name`。 |
| 19 | + - mean (float|Tensor, 可选) - 输出 Tensor 的正态分布的平均值。如果 ``mean`` 是 float,则表示输出 Tensor 中所有元素的正态分布的平均值。如果 ``mean`` 是 Tensor (支持的数据类型为 float32、float64),则表示输出Tensor中每个元素的正态分布的平均值。默认值为0.0。 |
| 20 | + - std (float|Tensor, 可选) - 输出 Tensor 的正态分布的标准差。如果 ``std`` 是 float,则表示输出 Tensor 中所有元素的正态分布的标准差。如果 ``std`` 是 Tensor (支持的数据类型为 float32、float64),则表示输出Tensor中每个元素的正态分布的标准差。默认值为0.0。 |
| 21 | + - shape (list|tuple|Tensor, 可选) - 生成的随机 Tensor 的形状。如果 ``shape`` 是 list、tuple,则其中的元素可以是 int,或者是形状为[1]且数据类型为 int32、int64 的 Tensor。如果 ``shape`` 是 Tensor,则是数据类型为 int32、int64 的一维 Tensor。如果 ``mean`` 或者 ``std`` 是 Tensor,输出 Tensor 的形状和 ``mean`` 或者 ``std`` 相同(此时 ``shape`` 无效)。默认值为 None。 |
| 22 | + - name (str, 可选) - 操作的名称(可选,默认值为 None)。更多信息请参见 :ref:`api_guide_Name`。 |
23 | 23 |
|
24 | 24 | 返回 |
25 | 25 | :::::::::: |
26 | | - Tensor:符合正态分布(均值为 ``mean`` ,标准差为 ``std`` 的正态随机分布)的随机Tensor。 |
| 26 | + Tensor:符合正态分布(均值为 ``mean`` ,标准差为 ``std`` 的正态随机分布)的随机 Tensor。 |
27 | 27 |
|
28 | 28 | 示例代码 |
29 | 29 | :::::::::: |
|
33 | 33 | import paddle |
34 | 34 |
|
35 | 35 | out1 = paddle.normal(shape=[2, 3]) |
36 | | - # [[ 0.17501129 0.32364586 1.561118 ] # random |
| 36 | + # [[ 0.17501129 0.32364586 1.561118 ] |
37 | 37 | # [-1.7232178 1.1545963 -0.76156676]] # random |
38 | 38 |
|
39 | 39 | mean_tensor = paddle.to_tensor([1.0, 2.0, 3.0]) |
|
0 commit comments