From 057b5192456d569203b4a59498a26b2c2f816b90 Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Mon, 29 Nov 2021 17:07:50 +0800 Subject: [PATCH 1/2] add deg2rad & rad2deg docs --- docs/api/paddle/Overview_cn.rst | 2 ++ docs/api/paddle/Tensor_cn.rst | 22 +++++++++++++++ docs/api/paddle/deg2rad.rst | 44 +++++++++++++++++++++++++++++ docs/api/paddle/rad2deg.rst | 50 +++++++++++++++++++++++++++++++++ 4 files changed, 118 insertions(+) create mode 100644 docs/api/paddle/deg2rad.rst create mode 100644 docs/api/paddle/rad2deg.rst diff --git a/docs/api/paddle/Overview_cn.rst b/docs/api/paddle/Overview_cn.rst index 4a46417a212..5de293cdbb7 100755 --- a/docs/api/paddle/Overview_cn.rst +++ b/docs/api/paddle/Overview_cn.rst @@ -112,6 +112,8 @@ tensor数学操作 " :ref:`paddle.diagonal ` ", "根据给定的轴 axis 返回输入 Tensor 的局部视图" " :ref:`paddle.trunc ` ", "对输入 Tensor 每个元素的小数部分进行截断" " :ref:`paddle.log1p ` ", "该OP计算Log1p（加一的自然对数）结果" + " :ref:`paddle.rad2deg ` ", "将元素从弧度的角度转换为度" + " :ref:`paddle.deg2rad ` ", "将元素从度的角度转换为弧度" .. _tensor_logic: diff --git a/docs/api/paddle/Tensor_cn.rst b/docs/api/paddle/Tensor_cn.rst index 53ae7d96efe..a6318d41925 100755 --- a/docs/api/paddle/Tensor_cn.rst +++ b/docs/api/paddle/Tensor_cn.rst @@ -671,6 +671,17 @@ cumsum(axis=None, dtype=None, name=None) 请参考 :ref:`cn_api_tensor_cn_cumsum` +deg2rad(x, name=None) +::::::::: + +将元素从度的角度转换为弧度 + +返回：计算后的Tensor + +返回类型：Tensor + +请参考 :ref:`cn_api_paddle_tensor_deg2rad` + detach() ::::::::: @@ -1479,6 +1490,17 @@ prod(axis=None, keepdim=False, dtype=None, name=None) 请参考 :ref:`cn_api_tensor_cn_prod` +rad2deg(x, name=None) +::::::::: + +将元素从弧度的角度转换为度 + +返回：计算后的Tensor + +返回类型：Tensor + +请参考 :ref:`cn_api_paddle_tensor_rad2deg` + rank() ::::::::: diff --git a/docs/api/paddle/deg2rad.rst b/docs/api/paddle/deg2rad.rst new file mode 100644 index 00000000000..026fd311ad3 --- /dev/null +++ b/docs/api/paddle/deg2rad.rst @@ -0,0 +1,44 @@ +.. _cn_api_paddle_tensor_deg2rad: + +deg2rad +------------------------------- + +.. py:function:: paddle.deg2rad(x, name=None) + +将元素从弧度的角度转换为度 + +.. math:: + + deg2rad(x)=\pi * x / 180 + +参数 +::::::::: + +- **x** (Tensor) - 输入的Tensor，数据类型为：int32、int64、float32、float64。 +- **name** (str，可选） - 操作的名称(可选，默认值为None）。更多信息请参见 :ref:`api_guide_Name`。 + +返回 +::::::::: + +输出Tensor，与 ``x`` 维度相同、数据类型相同（输入为int时，输出数据类型为float32）。 + +代码示例 +::::::::: + +.. code-block:: python + + import paddle + import numpy as np + + x1 = paddle.to_tensor([180.0, -180.0, 360.0, -360.0, 90.0, -90.0]) + result1 = paddle.deg2rad(x1) + print(result1) + # Tensor(shape=[6], dtype=float32, place=CUDAPlace(0), stop_gradient=True, + # [3.14159274, -3.14159274, 6.28318548, -6.28318548, 1.57079637, + # -1.57079637]) + + x2 = paddle.to_tensor(180) + result2 = paddle.deg2rad(x2) + print(result2) + # Tensor(shape=[1], dtype=float32, place=CUDAPlace(0), stop_gradient=True, + # [3.14159274]) diff --git a/docs/api/paddle/rad2deg.rst b/docs/api/paddle/rad2deg.rst new file mode 100644 index 00000000000..3baa5f80a3d --- /dev/null +++ b/docs/api/paddle/rad2deg.rst @@ -0,0 +1,50 @@ +.. _cn_api_paddle_tensor_rad2deg: + +rad2deg +------------------------------- + +.. py:function:: paddle.rad2deg(x, name=None) + +将元素从弧度的角度转换为度 + +.. math:: + + rad2deg(x)=180/ \pi * x + +参数 +::::::::: + +- **x** (Tensor) - 输入的Tensor，数据类型为：int32、int64、float32、float64。 +- **name** (str，可选） - 操作的名称(可选，默认值为None）。更多信息请参见 :ref:`api_guide_Name`。 + +返回 +::::::::: + +输出Tensor，与 ``x`` 维度相同、数据类型相同（输入为int时，输出数据类型为float32）。 + +代码示例 +::::::::: + +.. code-block:: python + + import paddle + import numpy as np + + x1 = paddle.to_tensor([3.142, -3.142, 6.283, -6.283, 1.570, -1.570]) + result1 = paddle.rad2deg(x1) + print(result1) + # Tensor(shape=[6], dtype=float32, place=CUDAPlace(0), stop_gradient=True, + # [180.02334595, -180.02334595, 359.98937988, -359.98937988, + # 9.95437622 , -89.95437622]) + + x2 = paddle.to_tensor(np.pi/2) + result2 = paddle.rad2deg(x2) + print(result2) + # Tensor(shape=[1], dtype=float32, place=CUDAPlace(0), stop_gradient=True, + # [90.]) + + x3 = paddle.to_tensor(1) + result3 = paddle.rad2deg(x3) + print(result3) + # Tensor(shape=[1], dtype=float32, place=CUDAPlace(0), stop_gradient=True, + # [57.29578018]) From f0a26a509cfdf11579a842d34cc2ba4f9cc05918 Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Mon, 29 Nov 2021 19:18:36 +0800 Subject: [PATCH 2/2] fix file name --- docs/api/paddle/{deg2rad.rst => deg2rad_cn.rst} | 0 docs/api/paddle/{rad2deg.rst => rad2deg_cn.rst} | 0 2 files changed, 0 insertions(+), 0 deletions(-) rename docs/api/paddle/{deg2rad.rst => deg2rad_cn.rst} (100%) rename docs/api/paddle/{rad2deg.rst => rad2deg_cn.rst} (100%) diff --git a/docs/api/paddle/deg2rad.rst b/docs/api/paddle/deg2rad_cn.rst similarity index 100% rename from docs/api/paddle/deg2rad.rst rename to docs/api/paddle/deg2rad_cn.rst diff --git a/docs/api/paddle/rad2deg.rst b/docs/api/paddle/rad2deg_cn.rst similarity index 100% rename from docs/api/paddle/rad2deg.rst rename to docs/api/paddle/rad2deg_cn.rst