【Hackathon 6th No.3】为 Paddle 新增 ZeroPad1D / ZeroPad3D / block_diag API (#6651)

* ZeroPad1D and ZeroPad3D and block_diag docs

* update

* update

* finish

Author: ADream-ki

docs/api/paddle/Tensor_cn.rst

@@ -3253,6 +3253,17 @@ signbit(x, name=None)
 
 请参考 :ref:`cn_api_paddle_signbit`
 
+block_diag(inputs, name=None)
+:::::::::
+
+根据 `inputs` 创建对角矩阵。
+
+返回：对角矩阵 Tensor。
+
+返回类型：Tensor
+
+请参考 :ref:`cn_api_paddle_block_diag`
+
 ormqr(x, tau, other, left=True, transpose=False)
 :::::::::
 

docs/api/paddle/block_diag_cn.rst

@@ -0,0 +1,23 @@
+.. _cn_api_paddle_block_diag:
+
+block_diag
+-------------------------------
+
+.. py:function:: paddle.block_diag(inputs, name=None)
+
+根据 `inputs` 创建对角矩阵。
+
+参数
+:::::::::
+    - **inputs**  (list|tuple) - 是一个 Tensor 列表或 Tensor 元组，其子项为 0、1、2 维的 Tensor 。数据类型为： `bool`、 `float16`、 `float32`、 `float64`、 `uint8`、 `int8`、 `int16`、 `int32`、 `int64`、 `bfloat16`、 `complex64`、 `complex128`。
+    - **name**  (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 `None`。
+
+返回
+:::::::::
+
+Tensor， 与 ``inputs`` 数据类型相同。
+
+代码示例
+:::::::::
+
+COPY-FROM: paddle.block_diag

docs/api/paddle/nn/Overview_cn.rst

@@ -108,7 +108,9 @@ Padding 层
     " :ref:`paddle.nn.Pad1D <cn_api_paddle_nn_Pad1D>` ", "一维填充层"
     " :ref:`paddle.nn.Pad2D <cn_api_paddle_nn_Pad2D>` ", "二维填充层"
     " :ref:`paddle.nn.Pad3D <cn_api_paddle_nn_Pad3D>` ", "三维填充层"
+    " :ref:`paddle.nn.ZeroPad1D <cn_api_paddle_nn_ZeroPad1D>` ", "一维零填充层"
     " :ref:`paddle.nn.ZeroPad2D <cn_api_paddle_nn_ZeroPad2D>` ", "二维零填充层"
+    " :ref:`paddle.nn.ZeroPad3D <cn_api_paddle_nn_ZeroPad3D>` ", "三维零填充层"
 
 .. _activation_layers:
 

docs/api/paddle/nn/ZeroPad1D_cn.rst

@@ -0,0 +1,32 @@
+.. _cn_api_paddle_nn_ZeroPad1D:
+
+ZeroPad1D
+-------------------------------
+.. py:class:: paddle.nn.ZeroPad1D(padding, data_format="NCL", name=None)
+
+**ZeroPad1D**
+
+按照 padding 属性对输入进行零填充。
+
+参数
+:::::::::
+
+  - **padding** (Tensor | List[int] | int) - 如果输入数据类型为 int，则在所有待填充边界使用相同的填充，
+    否则填充的格式为[pad_left, pad_right]。
+  - **data_format** (str)  - 指定输入的 format，可为 ``'NCL'`` 或者 ``'NLC'``，默认值为 ``'NCL'``，其中 `N` 是 batch size， `C` 是通道数， `L` 输入特征的长度。
+  - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+
+返回
+::::::::::::
+无
+
+形状
+:::::::::
+
+  - x(Tensor): ZeroPadD 层的输入，要求形状为 3-D，dtype 为 ``'float32'`` 或 ``'float64'``
+  - output(Tensor)：输出，形状为 3-D，dtype 与 ``'input'`` 相同
+
+代码示例
+:::::::::
+
+COPY-FROM: paddle.nn.ZeroPad1D

docs/api/paddle/nn/ZeroPad3D_cn.rst

@@ -0,0 +1,32 @@
+.. _cn_api_paddle_nn_ZeroPad3D:
+
+ZeroPad3D
+-------------------------------
+.. py:class:: paddle.nn.ZeroPad3D(padding, data_format="NCDHW", name=None)
+
+**ZeroPad3D**
+
+按照 padding 属性对输入进行零填充。
+
+参数
+:::::::::
+
+  - **padding** (Tensor | List[int] | int) - 如果输入数据类型为 int，则在所有待填充边界使用相同的填充，
+    否则填充的格式为[pad_left, pad_right, pad_top, pad_bottom, pad_front, pad_back]。
+  - **data_format** (str，可选)  - 指定输入的 format，可为 ``'NCDHW'`` 或者 ``'NDHWC'``，默认值为 ``'NCDHW'``，其中 `N` 是批尺寸， `C` 是通道数， `D` 是特征层深度， `H` 是特征层高度， `W` 是特征层宽度。。
+  - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+
+返回
+::::::::::::
+无
+
+形状
+:::::::::
+
+  - x(Tensor): ZeroPadD 层的输入，要求形状为 5-D，dtype 为 ``'float32'`` 或 ``'float64'``
+  - output(Tensor)：输出，形状为 5-D，dtype 与 ``'input'`` 相同
+
+代码示例
+:::::::::
+
+COPY-FROM: paddle.nn.ZeroPad3D