diff --git a/docs/api/paddle/Overview_cn.rst b/docs/api/paddle/Overview_cn.rst index 715acc06186..1849ee2a204 100644 --- a/docs/api/paddle/Overview_cn.rst +++ b/docs/api/paddle/Overview_cn.rst @@ -244,6 +244,8 @@ tensor 数学操作原位(inplace)版本 " :ref:`paddle.less_than_ ` ", "Inplace 版本的 less_than API,对输入 x 采用 Inplace 策略" " :ref:`paddle.lgamma_ ` ", "Inplace 版本的 lgamma API,对输入 x 采用 Inplace 策略" " :ref:`paddle.log_normal_ ` ", "Inplace 版本的 log_normal API,对输入 x 采用 Inplace 策略" + " :ref:`paddle.normal_ ` ", "Inplace 版本的 normal API,对输入 x 采用 Inplace 策略" + " :ref:`paddle.neg_ ` ", "Inplace 版本的 neg API,对输入 x 采用 Inplace 策略" " :ref:`paddle.nan_to_num_ ` ", "Inplace 版本的 nan_to_num API,对输入 x 采用 Inplace 策略" diff --git a/docs/api/paddle/neg__cn.rst b/docs/api/paddle/neg__cn.rst new file mode 100644 index 00000000000..8892a1a4737 --- /dev/null +++ b/docs/api/paddle/neg__cn.rst @@ -0,0 +1,12 @@ +.. _cn_api_paddle_neg_: + +neg\_ +------------------------------- + +.. py:function:: paddle.neg_(x, name=None) + +Inplace 版本的 :ref:`cn_api_paddle_neg` API,对输入 `input` 采用 Inplace 策略。 + +更多关于 inplace 操作的介绍请参考 `3.1.3 原位(Inplace)操作和非原位操作的区别`_ 了解详情。 + +.. _3.1.3 原位(Inplace)操作和非原位操作的区别: https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/guides/beginner/tensor_cn.html#id3 diff --git a/docs/api/paddle/normal__cn.rst b/docs/api/paddle/normal__cn.rst new file mode 100644 index 00000000000..9d98fb92942 --- /dev/null +++ b/docs/api/paddle/normal__cn.rst @@ -0,0 +1,30 @@ +.. _cn_api_paddle_normal_: + +normal\_ +------------------------------- + +.. py:function:: paddle.normal_(x, mean=0.0, std=1.0, name=None) + +Inplace 版本的 :ref:`cn_api_paddle_normal` API,对输入 x 采用 Inplace 策略。 + +更多关于 inplace 操作的介绍请参考 `3.1.3 原位(Inplace)操作和非原位操作的区别`_ 了解详情。 + +.. _3.1.3 原位(Inplace)操作和非原位操作的区别: https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/guides/beginner/tensor_cn.html#id3 + + +参数 +:::::::::: + - **x** (Tensor) - 随机值填充的输入 Tensor。 + - **mean** (float|complex|Tensor,可选) - 输出 Tensor 的正态分布的平均值,默认值为 0.0。 + - **std** (float|Tensor,可选) - 输出 Tensor 的正态分布的标准差,默认值为 1.0。 + - **name** (str,可选) - 具体用法请参见 :ref:`api_guide_Name`,一般无需设置,默认值为 None。 + + +返回 +:::::::::: + Tensor:符合正态分布(均值为 ``mean``,标准差为 ``std`` 的正态随机分布)的随机 Tensor。 + +示例代码 +:::::::::: + + COPY-FROM: paddle.normal_