From f8d7c2f2d577920d68278df4d770871169997136 Mon Sep 17 00:00:00 2001 From: BrilliantYuKaimin <91609464+BrilliantYuKaimin@users.noreply.github.com> Date: Fri, 8 Apr 2022 11:49:43 +0800 Subject: [PATCH 1/4] Create logspace_cn.rst --- docs/api/paddle/logspace_cn.rst | 35 +++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 docs/api/paddle/logspace_cn.rst diff --git a/docs/api/paddle/logspace_cn.rst b/docs/api/paddle/logspace_cn.rst new file mode 100644 index 00000000000..11d86ef9e66 --- /dev/null +++ b/docs/api/paddle/logspace_cn.rst @@ -0,0 +1,35 @@ +.. _cn_api_fluid_layers_logspace: + +logspace +------------------------------- + +.. py:function:: paddle.logspace(start, stop, num, base=10.0, dtype=None, name=None) + +该OP返回一个Tensor，Tensor的值为在区间 :math:`[base^{start}, base^{stop}]` 上按对数均匀间隔的 :math:`num` 个值，输出Tensor的长度为num。 +**注意：该OP不进行梯度计算** + +参数 +:::::::::::: + + - **start** (int|float|Tensor) – ``start`` 是区间开始值以 ``base`` 为底的指数，可以是一个标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32，float64，int32 或者int64。 + - **stop** (int|float|Tensor) – ``stop`` 是区间结束值以 ``base`` 为底的指数，可以是一个标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32，float64，int32或者int64。 + - **num** (int|Tensor) – ``num`` 是给定区间内需要划分的区间数，可以是一个整型标量，或是一个shape为[1]的Tensor，该Tensor的数据类型需为int32。 + - **base** (int|float|Tensor) – ``base`` 是对数函数的底数，可以是一个标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32，float64，int32或者int64。 + - **dtype** (np.dtype|str, 可选) – 输出Tensor的数据类型，可以是float32，float64， int32或者int64。如果dtype的数据类型为None，输出Tensor数据类型为float32。 + - **name** （str， 可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。 + +返回 +:::::::::::: +等对数间隔划分的1-D Tensor，该Tensor的shape大小为 :math:`[num]` ，在num为1的情况下，仅返回包含 :math:`base^{start}` 值的Tensor。 + + +代码示例 +:::::::::::: + +.. code-block:: python + + import paddle + data = paddle.logspace(0, 10, 5, 2, 'float32') + # [1. , 5.65685415 , 32. , 181.01933289, 1024. ] + data = paddle.logspace(0, 10, 1, 2, 'float32') + # [1.] From 82b5542dfdc8351cf5103c70fec8f47d0289bfed Mon Sep 17 00:00:00 2001 From: BrilliantYuKaimin <91609464+BrilliantYuKaimin@users.noreply.github.com> Date: Wed, 13 Apr 2022 15:29:34 +0800 Subject: [PATCH 2/4] Update logspace_cn.rst --- docs/api/paddle/logspace_cn.rst | 29 ++++++++++++----------------- 1 file changed, 12 insertions(+), 17 deletions(-) diff --git a/docs/api/paddle/logspace_cn.rst b/docs/api/paddle/logspace_cn.rst index 11d86ef9e66..2dc80f3de27 100644 --- a/docs/api/paddle/logspace_cn.rst +++ b/docs/api/paddle/logspace_cn.rst @@ -5,31 +5,26 @@ logspace .. py:function:: paddle.logspace(start, stop, num, base=10.0, dtype=None, name=None) -该OP返回一个Tensor，Tensor的值为在区间 :math:`[base^{start}, base^{stop}]` 上按对数均匀间隔的 :math:`num` 个值，输出Tensor的长度为num。 -**注意：该OP不进行梯度计算** +返回一个 Tensor，Tensor 的值为在区间 :math:`[base^{start}, base^{stop}]` 上按对数均匀间隔的 :math:`num` 个值，输出 Tensor 的长度为 num。 + +.. note:: + ``paddle.logspace`` 不进行梯度计算。 参数 :::::::::::: - - **start** (int|float|Tensor) – ``start`` 是区间开始值以 ``base`` 为底的指数，可以是一个标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32，float64，int32 或者int64。 - - **stop** (int|float|Tensor) – ``stop`` 是区间结束值以 ``base`` 为底的指数，可以是一个标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32，float64，int32或者int64。 - - **num** (int|Tensor) – ``num`` 是给定区间内需要划分的区间数，可以是一个整型标量，或是一个shape为[1]的Tensor，该Tensor的数据类型需为int32。 - - **base** (int|float|Tensor) – ``base`` 是对数函数的底数，可以是一个标量，或是一个shape为[1]的Tensor，该Tensor的数据类型可以是float32，float64，int32或者int64。 - - **dtype** (np.dtype|str, 可选) – 输出Tensor的数据类型，可以是float32，float64， int32或者int64。如果dtype的数据类型为None，输出Tensor数据类型为float32。 - - **name** （str， 可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。 + - **start** (int|float|Tensor) – ``start`` 是区间开始值以 ``base`` 为底的指数，可以是一个标量，或是一个 shape 为 [1] 的 Tensor，该 Tensor 的数据类型可以是 float32、float64、int32 或者 int64。 + - **stop** (int|float|Tensor) – ``stop`` 是区间结束值以 ``base`` 为底的指数，可以是一个标量，或是一个 shape 为 [1] 的 Tensor，该 Tensor 的数据类型可以是 float32、float64、int32 或者 int64。 + - **num** (int|Tensor) – ``num`` 是给定区间内需要划分的区间数，可以是一个整型标量，或是一个 shape 为 [1] 的 Tensor，该 Tensor 的数据类型需为 int32。 + - **base** (int|float|Tensor) – ``base`` 是对数函数的底数，可以是一个标量，或是一个 shape 为 [1] 的 Tensor，该 Tensor 的数据类型可以是 float32、float64、int32 或者 int64。 + - **dtype** (np.dtype|str，可选) – 输出Tensor的数据类型，可以是 float32、float64，int32 或者 int64。如果 dtype 的数据类型为 None，输出 Tensor 数据类型为 float32。 + - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 返回 :::::::::::: -等对数间隔划分的1-D Tensor，该Tensor的shape大小为 :math:`[num]` ，在num为1的情况下，仅返回包含 :math:`base^{start}` 值的Tensor。 +等对数间隔划分的 1-D Tensor，该 Tensor 的 shape 大小为 :math:`[num]` ，在 num 为 1 的情况下，仅返回包含 :math:`base^{start}` 值的 Tensor。 代码示例 :::::::::::: - -.. code-block:: python - - import paddle - data = paddle.logspace(0, 10, 5, 2, 'float32') - # [1. , 5.65685415 , 32. , 181.01933289, 1024. ] - data = paddle.logspace(0, 10, 1, 2, 'float32') - # [1.] +COPY-FROM: : From 4fdf65a9b9a7e7b1fb4bd722fa4560e747bc8fb8 Mon Sep 17 00:00:00 2001 From: BrilliantYuKaimin <91609464+BrilliantYuKaimin@users.noreply.github.com> Date: Wed, 13 Apr 2022 19:23:33 +0800 Subject: [PATCH 3/4] Update logspace_cn.rst --- docs/api/paddle/logspace_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/logspace_cn.rst b/docs/api/paddle/logspace_cn.rst index 2dc80f3de27..668af2acae5 100644 --- a/docs/api/paddle/logspace_cn.rst +++ b/docs/api/paddle/logspace_cn.rst @@ -17,7 +17,7 @@ logspace - **stop** (int|float|Tensor) – ``stop`` 是区间结束值以 ``base`` 为底的指数，可以是一个标量，或是一个 shape 为 [1] 的 Tensor，该 Tensor 的数据类型可以是 float32、float64、int32 或者 int64。 - **num** (int|Tensor) – ``num`` 是给定区间内需要划分的区间数，可以是一个整型标量，或是一个 shape 为 [1] 的 Tensor，该 Tensor 的数据类型需为 int32。 - **base** (int|float|Tensor) – ``base`` 是对数函数的底数，可以是一个标量，或是一个 shape 为 [1] 的 Tensor，该 Tensor 的数据类型可以是 float32、float64、int32 或者 int64。 - - **dtype** (np.dtype|str，可选) – 输出Tensor的数据类型，可以是 float32、float64，int32 或者 int64。如果 dtype 的数据类型为 None，输出 Tensor 数据类型为 float32。 + - **dtype** (np.dtype|str，可选) – 输出 Tensor 的数据类型，可以是 float32、float64，int32 或者 int64。如果 dtype 的数据类型为 None，输出 Tensor 数据类型为 float32。 - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 返回 From d105129174a24c6c73e39c633a0ef69744e68290 Mon Sep 17 00:00:00 2001 From: BrilliantYuKaimin <91609464+BrilliantYuKaimin@users.noreply.github.com> Date: Thu, 14 Apr 2022 13:43:01 +0800 Subject: [PATCH 4/4] Update logspace_cn.rst --- docs/api/paddle/logspace_cn.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/api/paddle/logspace_cn.rst b/docs/api/paddle/logspace_cn.rst index 668af2acae5..24abdadeb19 100644 --- a/docs/api/paddle/logspace_cn.rst +++ b/docs/api/paddle/logspace_cn.rst @@ -17,8 +17,9 @@ logspace - **stop** (int|float|Tensor) – ``stop`` 是区间结束值以 ``base`` 为底的指数，可以是一个标量，或是一个 shape 为 [1] 的 Tensor，该 Tensor 的数据类型可以是 float32、float64、int32 或者 int64。 - **num** (int|Tensor) – ``num`` 是给定区间内需要划分的区间数，可以是一个整型标量，或是一个 shape 为 [1] 的 Tensor，该 Tensor 的数据类型需为 int32。 - **base** (int|float|Tensor) – ``base`` 是对数函数的底数，可以是一个标量，或是一个 shape 为 [1] 的 Tensor，该 Tensor 的数据类型可以是 float32、float64、int32 或者 int64。 - - **dtype** (np.dtype|str，可选) – 输出 Tensor 的数据类型，可以是 float32、float64，int32 或者 int64。如果 dtype 的数据类型为 None，输出 Tensor 数据类型为 float32。 - - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 + - **dtype** (np.dtype|str，可选) – 输出 Tensor 的数据类型，可以是 float32、float64、int32 或者 int64。如果 dtype 的数据类型为 None，输出 Tensor 数据类型为 float32。 + - **name** (str，可选) – 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 + 返回 :::::::::::: @@ -27,4 +28,4 @@ logspace 代码示例 :::::::::::: -COPY-FROM: : +COPY-FROM: paddle.logspace:logspace-example