diff --git a/docs/api/paddle/Overview_cn.rst b/docs/api/paddle/Overview_cn.rst index b7e8722fad4..b1d75edd48f 100755 --- a/docs/api/paddle/Overview_cn.rst +++ b/docs/api/paddle/Overview_cn.rst @@ -117,6 +117,8 @@ tensor数学操作 " :ref:`paddle.diff ` ", "沿着指定维度对输入Tensor计算n阶的前向差值" " :ref:`paddle.rad2deg ` ", "将元素从弧度的角度转换为度" " :ref:`paddle.deg2rad ` ", "将元素从度的角度转换为弧度" + " :ref:`paddle.gcd ` ", "计算两个输入的按元素绝对值的最大公约数" + " :ref:`paddle.lcm ` ", "计算两个输入的按元素绝对值的最小公倍数" .. _tensor_logic: diff --git a/docs/api/paddle/Tensor_cn.rst b/docs/api/paddle/Tensor_cn.rst index 592129e59bc..e1584c39a93 100755 --- a/docs/api/paddle/Tensor_cn.rst +++ b/docs/api/paddle/Tensor_cn.rst @@ -1041,6 +1041,15 @@ gather_nd(index, name=None) 请参考 :ref:`cn_api_tensor_cn_gather_nd` +gcd(x, y, name=None) +::::::::: + +计算两个输入的按元素绝对值的最大公约数 + +返回:计算后的Tensor + +请参考 :ref:`cn_api_paddle_tensor_gcd` + gradient() ::::::::: @@ -1177,6 +1186,15 @@ kron(y, name=None) 请参考 :ref:`cn_api_paddle_tensor_kron` +lcm(x, y, name=None) +::::::::: + +计算两个输入的按元素绝对值的最小公倍数 + +返回:计算后的Tensor + +请参考 :ref:`cn_api_paddle_tensor_lcm` + less_equal(y, name=None) ::::::::: diff --git a/docs/api/paddle/deg2rad_cn.rst b/docs/api/paddle/deg2rad_cn.rst index 026fd311ad3..e971832ce25 100644 --- a/docs/api/paddle/deg2rad_cn.rst +++ b/docs/api/paddle/deg2rad_cn.rst @@ -25,20 +25,4 @@ deg2rad 代码示例 ::::::::: -.. 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]) +COPY-FROM: paddle.deg2rad diff --git a/docs/api/paddle/gcd_cn.rst b/docs/api/paddle/gcd_cn.rst new file mode 100644 index 00000000000..87562d5d1be --- /dev/null +++ b/docs/api/paddle/gcd_cn.rst @@ -0,0 +1,32 @@ +.. _cn_api_paddle_tensor_gcd: + +gcd +------------------------------- + +.. py:function:: paddle.gcd(x, y, name=None) + +计算两个输入的按元素绝对值的最大公约数,输入必须是整型。 + +.. note:: + + gcd(0,0)=0, gcd(0, y)=|y| + + 如果x和y的shape不一致,会对两个shape进行广播操作,得到一致的shape(并作为输出结果的shape), + 请参见 :ref:`cn_user_guide_broadcasting` 。 + +参数 +::::::::: + +- **x** (Tensor) - 输入的Tensor,数据类型为:int8,int16,int32,int64,uint8。 +- **y** (Tensor) - 输入的Tensor,数据类型为:int8,int16,int32,int64,uint8。 +- **name** (str,可选) - 操作的名称(可选,默认值为None)。更多信息请参见 :ref:`api_guide_Name`。 + +返回 +::::::::: + +输出Tensor,与输入数据类型相同。 + +代码示例 +::::::::: + +COPY-FROM: paddle.gcd diff --git a/docs/api/paddle/lcm_cn.rst b/docs/api/paddle/lcm_cn.rst new file mode 100644 index 00000000000..2c76cd9dcb0 --- /dev/null +++ b/docs/api/paddle/lcm_cn.rst @@ -0,0 +1,32 @@ +.. _cn_api_paddle_tensor_lcm: + +lcm +------------------------------- + +.. py:function:: paddle.lcm(x, y, name=None) + +计算两个输入的按元素绝对值的最小公倍数,输入必须是整型。 + +.. note:: + + lcm(0,0)=0, lcm(0, y)=0 + + 如果x和y的shape不一致,会对两个shape进行广播操作,得到一致的shape(并作为输出结果的shape), + 请参见 :ref:`cn_user_guide_broadcasting` 。 + +参数 +::::::::: + +- **x** (Tensor) - 输入的Tensor,数据类型为:int8,int16,int32,int64,uint8。 +- **y** (Tensor) - 输入的Tensor,数据类型为:int8,int16,int32,int64,uint8。 +- **name** (str,可选) - 操作的名称(可选,默认值为None)。更多信息请参见 :ref:`api_guide_Name`。 + +返回 +::::::::: + +输出Tensor,与输入数据类型相同。 + +代码示例 +::::::::: + +COPY-FROM: paddle.lcm diff --git a/docs/api/paddle/rad2deg_cn.rst b/docs/api/paddle/rad2deg_cn.rst index 3baa5f80a3d..f286cbd4bfc 100644 --- a/docs/api/paddle/rad2deg_cn.rst +++ b/docs/api/paddle/rad2deg_cn.rst @@ -25,26 +25,4 @@ rad2deg 代码示例 ::::::::: -.. 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]) +COPY-FROM: paddle.rad2deg