Merge branch 'develop' into add_diff_doc

Author: andyjiang1116

docs/api/paddle/Overview_cn.rst

@@ -32,6 +32,7 @@ tensor数学操作
     :widths: 10, 30
 
     " :ref:`paddle.abs <cn_api_fluid_layers_abs>` ", "绝对值函数"
+    " :ref:`paddle.angle <cn_api_paddle_angle>` ", "相位角函数"
     " :ref:`paddle.acos <cn_api_fluid_layers_acos>` ", "arccosine函数"
     " :ref:`paddle.add <cn_api_tensor_add>` ", "Tensor逐元素相加"
     " :ref:`paddle.add_n <cn_api_tensor_add_n>` ", "对输入的一至多个Tensor或LoDTensor求和"
@@ -113,6 +114,8 @@ tensor数学操作
     " :ref:`paddle.trunc <cn_api_tensor_trunc>` ", "对输入 Tensor 每个元素的小数部分进行截断"
     " :ref:`paddle.log1p <cn_api_paddle_tensor_log1p>` ", "该OP计算Log1p（加一的自然对数）结果"
     " :ref:`paddle.diff <cn_api_tensor_diff>` ", "沿着指定维度对输入Tensor计算n阶的前向差值"
+    " :ref:`paddle.rad2deg <cn_api_paddle_tensor_rad2deg>` ", "将元素从弧度的角度转换为度"
+    " :ref:`paddle.deg2rad <cn_api_paddle_tensor_deg2rad>` ", "将元素从度的角度转换为弧度"
 
 .. _tensor_logic:
 

docs/api/paddle/Tensor/Overview_en.rst

@@ -69,6 +69,7 @@ Methods
     addmm
     all
     allclose
+    angle
     any
     argmax
     argmin

docs/api/paddle/Tensor_cn.rst

@@ -212,6 +212,15 @@ abs(name=None)
 
 请参考 :ref:`cn_api_fluid_layers_abs`
 
+angle(name=None)
+:::::::::
+
+返回：计算后的Tensor
+
+返回类型：Tensor
+
+请参考 :ref:`cn_api_paddle_angle`
+
 acos(name=None)
 :::::::::
 
@@ -680,6 +689,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()
 :::::::::
 
@@ -1497,6 +1517,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()
 :::::::::
 

docs/api/paddle/angle_cn.rst

@@ -0,0 +1,27 @@
+.. _cn_api_paddle_angle:
+
+angle
+-------------------------------
+
+.. py:function:: paddle.angle(x, name=None)
+
+
+逐元素计算复数的相位角。对于非负实数，相位角为 0，而对于负实数，相位角为 :math:`\pi`.
+
+.. math::
+
+    angle(x) = arctan2(x.imag, x.real)
+
+参数
+:::::::::
+    - x (Tensor) - 输入的Tensor，数据类型为：complex64, complex128 或 float32, float64。
+    - name (str，可选） - 操作的名称(可选，默认值为None）。更多信息请参见 :ref:`api_guide_Name`。
+
+返回
+:::::::::
+输出实数Tensor，与 ``x`` 的数值精度一致。
+
+代码示例
+:::::::::
+
+COPY-FROM: paddle.angle

docs/api/paddle/deg2rad_cn.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])

docs/api/paddle/nn/Overview_cn.rst

@@ -102,6 +102,7 @@ Padding层
     " :ref:`paddle.nn.Pad1D <cn_api_nn_Pad1D>` ", "一维填充层"
     " :ref:`paddle.nn.Pad2D <cn_api_nn_Pad2D>` ", "二维填充层"
     " :ref:`paddle.nn.Pad3D <cn_api_nn_Pad3D>` ", "三维填充层"
+    " :ref:`paddle.nn.ZeroPad2D <cn_api_nn_ZeroPad2D>` ", "二维零填充层"
 
 .. _activation_layers:
 
@@ -344,6 +345,7 @@ Padding相关函数
 
 
     " :ref:`paddle.nn.functional.pad <cn_api_nn_cn_pad>` ", "依照 pad 和 mode 属性对input进行填充"
+    " :ref:`paddle.nn.functional.zeropad2d <cn_api_nn_functional_zeropad2d>` ", "依照 pad 对x进行零填充"
 
 .. _activation_functional:
 

docs/api/paddle/nn/ZeroPad2D_cn.rst

@@ -0,0 +1,50 @@
+.. _cn_api_nn_ZeroPad2D:
+
+ZeroPad2D
+-------------------------------
+.. py:class:: paddle.nn.ZeroPad2D(padding, data_format="NCHW", name=None)
+
+**ZeroPad2D**
+
+按照 padding 属性对输入进行零填充。
+
+参数
+:::::::::
+
+  - **padding** (Tensor | List[int] | int]) - 填充大小。如果是int，则在所有待填充边界使用相同的填充，
+    否则填充的格式为[pad_left, pad_right, pad_top, pad_bottom]。
+  - **data_format** (str)  - 指定输入的format，可为 ``'NCHW'`` 或者 ``'NHWC'``，默认值为 ``'NCHW'``。
+  - **name** (str, 可选) - 该参数供开发人员打印调试信息时使用，具体用法请参见 :ref:`api_guide_Name` ，缺省值为None。
+
+返回：无
+
+形状
+:::::::::
+
+  - x(Tensor): ZeroPadD层的输入，要求形状为4-D，dtype为 ``'float32'`` 或 ``'float64'``
+  - output(Tensor): 输出，形状为4-D，dtype与 ``'input'`` 相同
+
+代码示例
+:::::::::
+
+.. code-block:: python
+
+    import paddle
+    import paddle.nn as nn
+    import numpy as np
+
+    input_shape = (1, 1, 2, 3)
+    pad = [1, 0, 1, 2]
+    data = paddle.arange(np.prod(input_shape), dtype="float32").reshape(input_shape) + 1
+
+    my_pad = nn.ZeroPad2D(padding=pad)
+    result = my_pad(data)
+
+    print(result)
+    # [[[[0. 0. 0. 0.]
+    #    [0. 1. 2. 3.]
+    #    [0. 4. 5. 6.]
+    #    [0. 0. 0. 0.]
+    #    [0. 0. 0. 0.]]]]
+
+

docs/api/paddle/nn/functional/zeropad2d_cn.rst

@@ -0,0 +1,37 @@
+.. _cn_api_nn_functional_zeropad2d:
+
+zeropad2d
+-------------------------------
+.. py:function:: paddle.nn.functional.zeropad2d(x, padding, data_format="NCHW", name=None)
+
+该OP返回一个按照 ``padding`` 属性对 ``x`` 进行零填充的Tensor，数据类型与 ``x`` 相同。
+
+参数
+::::::::::
+    - **x** (Tensor) - Tensor，format可以为 ``'NCHW'``, ``'NHWC'`` ，默认值为 ``'NCHW'``，数据类型支持float16, float32, float64, int32, int64。
+    - **padding** (Tensor | List[int] | Tuple[int]) - 填充大小。pad的格式为[pad_left, pad_right, pad_top, pad_bottom]；
+    - **data_format** (str)  - 指定 ``x`` 的format，可为 ``'NCHW'``, ``'NHWC'``, 默认值为 ``'NCHW'``。
+    - **name** (str, 可选) - 该参数供开发人员打印调试信息时使用，具体用法请参见 :ref:`api_guide_Name` ，缺省值为None。
+
+返回
+::::::::::
+    Tensor：对 ``x`` 进行 ``'pad'`` 的结果，数据类型和 ``x`` 相同。
+
+代码示例
+::::::::::
+
+.. code-block:: python
+
+    import paddle
+    import numpy as np
+
+    x_shape = (1, 1, 2, 3)
+    x = paddle.arange(np.prod(x_shape), dtype="float32").reshape(x_shape) + 1
+    y = paddle.nn.functional.zeropad2d(x, [1, 2, 1, 1])
+
+    # [[[[0. 0. 0. 0. 0. 0.]
+    #    [0. 1. 2. 3. 0. 0.]
+    #    [0. 4. 5. 6. 0. 0.]
+    #    [0. 0. 0. 0. 0. 0.]]]]
+
+

docs/api/paddle/rad2deg_cn.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])