add doc for paddle.angle

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求和"

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)
 :::::::::
 

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