Skip to content

Commit 47d7dc4

Browse files
authored
add deg2rad & rad2deg docs (#4121)
* add deg2rad & rad2deg docs * fix file name
1 parent cb49f94 commit 47d7dc4

File tree

4 files changed

+118
-0
lines changed

4 files changed

+118
-0
lines changed

docs/api/paddle/Overview_cn.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -112,6 +112,8 @@ tensor数学操作
112112
" :ref:`paddle.diagonal <cn_api_tensor_diagonal>` ", "根据给定的轴 axis 返回输入 Tensor 的局部视图"
113113
" :ref:`paddle.trunc <cn_api_tensor_trunc>` ", "对输入 Tensor 每个元素的小数部分进行截断"
114114
" :ref:`paddle.log1p <cn_api_paddle_tensor_log1p>` ", "该OP计算Log1p(加一的自然对数)结果"
115+
" :ref:`paddle.rad2deg <cn_api_paddle_tensor_rad2deg>` ", "将元素从弧度的角度转换为度"
116+
" :ref:`paddle.deg2rad <cn_api_paddle_tensor_deg2rad>` ", "将元素从度的角度转换为弧度"
115117

116118
.. _tensor_logic:
117119

docs/api/paddle/Tensor_cn.rst

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -671,6 +671,17 @@ cumsum(axis=None, dtype=None, name=None)
671671

672672
请参考 :ref:`cn_api_tensor_cn_cumsum`
673673

674+
deg2rad(x, name=None)
675+
:::::::::
676+
677+
将元素从度的角度转换为弧度
678+
679+
返回:计算后的Tensor
680+
681+
返回类型:Tensor
682+
683+
请参考 :ref:`cn_api_paddle_tensor_deg2rad`
684+
674685
detach()
675686
:::::::::
676687

@@ -1479,6 +1490,17 @@ prod(axis=None, keepdim=False, dtype=None, name=None)
14791490

14801491
请参考 :ref:`cn_api_tensor_cn_prod`
14811492

1493+
rad2deg(x, name=None)
1494+
:::::::::
1495+
1496+
将元素从弧度的角度转换为度
1497+
1498+
返回:计算后的Tensor
1499+
1500+
返回类型:Tensor
1501+
1502+
请参考 :ref:`cn_api_paddle_tensor_rad2deg`
1503+
14821504
rank()
14831505
:::::::::
14841506

docs/api/paddle/deg2rad_cn.rst

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
.. _cn_api_paddle_tensor_deg2rad:
2+
3+
deg2rad
4+
-------------------------------
5+
6+
.. py:function:: paddle.deg2rad(x, name=None)
7+
8+
将元素从弧度的角度转换为度
9+
10+
.. math::
11+
12+
deg2rad(x)=\pi * x / 180
13+
14+
参数
15+
:::::::::
16+
17+
- **x** (Tensor) - 输入的Tensor,数据类型为:int32、int64、float32、float64。
18+
- **name** (str,可选) - 操作的名称(可选,默认值为None)。更多信息请参见 :ref:`api_guide_Name`。
19+
20+
返回
21+
:::::::::
22+
23+
输出Tensor,与 ``x`` 维度相同、数据类型相同(输入为int时,输出数据类型为float32)。
24+
25+
代码示例
26+
:::::::::
27+
28+
.. code-block:: python
29+
30+
import paddle
31+
import numpy as np
32+
33+
x1 = paddle.to_tensor([180.0, -180.0, 360.0, -360.0, 90.0, -90.0])
34+
result1 = paddle.deg2rad(x1)
35+
print(result1)
36+
# Tensor(shape=[6], dtype=float32, place=CUDAPlace(0), stop_gradient=True,
37+
# [3.14159274, -3.14159274, 6.28318548, -6.28318548, 1.57079637,
38+
# -1.57079637])
39+
40+
x2 = paddle.to_tensor(180)
41+
result2 = paddle.deg2rad(x2)
42+
print(result2)
43+
# Tensor(shape=[1], dtype=float32, place=CUDAPlace(0), stop_gradient=True,
44+
# [3.14159274])

docs/api/paddle/rad2deg_cn.rst

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
.. _cn_api_paddle_tensor_rad2deg:
2+
3+
rad2deg
4+
-------------------------------
5+
6+
.. py:function:: paddle.rad2deg(x, name=None)
7+
8+
将元素从弧度的角度转换为度
9+
10+
.. math::
11+
12+
rad2deg(x)=180/ \pi * x
13+
14+
参数
15+
:::::::::
16+
17+
- **x** (Tensor) - 输入的Tensor,数据类型为:int32、int64、float32、float64。
18+
- **name** (str,可选) - 操作的名称(可选,默认值为None)。更多信息请参见 :ref:`api_guide_Name`。
19+
20+
返回
21+
:::::::::
22+
23+
输出Tensor,与 ``x`` 维度相同、数据类型相同(输入为int时,输出数据类型为float32)。
24+
25+
代码示例
26+
:::::::::
27+
28+
.. code-block:: python
29+
30+
import paddle
31+
import numpy as np
32+
33+
x1 = paddle.to_tensor([3.142, -3.142, 6.283, -6.283, 1.570, -1.570])
34+
result1 = paddle.rad2deg(x1)
35+
print(result1)
36+
# Tensor(shape=[6], dtype=float32, place=CUDAPlace(0), stop_gradient=True,
37+
# [180.02334595, -180.02334595, 359.98937988, -359.98937988,
38+
# 9.95437622 , -89.95437622])
39+
40+
x2 = paddle.to_tensor(np.pi/2)
41+
result2 = paddle.rad2deg(x2)
42+
print(result2)
43+
# Tensor(shape=[1], dtype=float32, place=CUDAPlace(0), stop_gradient=True,
44+
# [90.])
45+
46+
x3 = paddle.to_tensor(1)
47+
result3 = paddle.rad2deg(x3)
48+
print(result3)
49+
# Tensor(shape=[1], dtype=float32, place=CUDAPlace(0), stop_gradient=True,
50+
# [57.29578018])

0 commit comments

Comments
 (0)