【Hackathon 6th No.9】Add cartesian_prod API to Paddle (#6751)

Author: NKNaN

docs/api/paddle/Overview_cn.rst

@@ -399,6 +399,7 @@ tensor 元素操作相关（如：转置，reshape 等）
 
     " :ref:`paddle.broadcast_to <cn_api_paddle_broadcast_to>` ", "根据 shape 指定的形状广播 x ，广播后， x 的形状和 shape 指定的形状一致"
     " :ref:`paddle.broadcast_tensors <cn_api_paddle_broadcast_tensors>` ", "对一组输入 Tensor 进行广播操作, 输入应符合广播规范"
+    " :ref:`paddle.cartesian_prod <cn_api_paddle_cartesian_prod>` ", "对输入 Tensor 序列进行笛卡尔积操作"
     " :ref:`paddle.cast <cn_api_paddle_cast>` ", "将输入的 x 的数据类型转换为 dtype 并输出"
     " :ref:`paddle.chunk <cn_api_paddle_chunk>` ", "将输入 Tensor 分割成多个子 Tensor"
     " :ref:`paddle.concat <cn_api_paddle_concat>` ", "对输入沿 axis 轴进行联结，返回一个新的 Tensor"

docs/api/paddle/cartesian_prod_cn.rst

@@ -0,0 +1,28 @@
+.. _cn_api_paddle_cartesian_prod:
+
+cartesian_prod
+-------------------------------
+
+.. py:function:: paddle.cartesian_prod(x, name=None)
+
+
+对指定的 tensor 序列进行笛卡尔积操作。该行为类似于 python 标准库中的 itertools.product 方法。
+相当于将所有的输入 tensors 转换为列表后，对其使用 itertools.product 方法，最终将返回的列表转换为 tensor。
+
+
+参数
+:::::::::
+
+        - **x** (list[Tensor]|tuple[Tensor]) – 任意数量的 1-D Tensor 序列，支持的数据类型：bfloat16、float16、float32、float64、int32、int64、complex64、complex128。
+
+        - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+
+返回
+:::::::::
+
+笛卡尔积运算后的 Tensor，数据类型与输入 Tensor 相同。
+
+代码示例
+::::::::::::
+
+COPY-FROM: paddle.cartesian_prod