From f21854581a1c9ea3fa0c1a941ec0b76849443d40 Mon Sep 17 00:00:00 2001 From: Regan Yue <1131625869@qq.com> Date: Fri, 1 Jul 2022 10:17:24 +0800 Subject: [PATCH 01/49] Update amax_cn.rst MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit fix paddle.amax 参数与英文文档不一致问题。 --- docs/api/paddle/amax_cn.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/api/paddle/amax_cn.rst b/docs/api/paddle/amax_cn.rst index 7916bbd4f73..dcb52ae27a3 100644 --- a/docs/api/paddle/amax_cn.rst +++ b/docs/api/paddle/amax_cn.rst @@ -15,8 +15,8 @@ amax 参数 ::::::::: - **x** （Tensor）- Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 - - **axis** （list | int，可选）- 求最大值运算的维度。如果为None，则计算所有元素的最大值并返回包含单个元素的Tensor变量，否则必须在 :math:`[-x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] <0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 - - **keepdim** （bool）- 是否在输出Tensor中保留减小的维度。如果keepdim 为 False，结果张量的维度将比输入张量的小，默认值为False。 + - **axis** （int|list|tuple，可选）- 求最大值运算的维度。如果为None，则计算所有元素的最大值并返回包含单个元素的Tensor变量，否则必须在 :math:`[-x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] <0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 + - **keepdim** （bool，可选）- 是否在输出Tensor中保留减小的维度。如果keepdim 为 False，结果张量的维度将比输入张量的小，默认值为False。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 返回 From f64239b8866eef8f1cbf67cd529b7164577ca6cf Mon Sep 17 00:00:00 2001 From: Regan Yue <1131625869@qq.com> Date: Fri, 1 Jul 2022 10:25:25 +0800 Subject: [PATCH 02/49] Update amin_cn.rst MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit fix paddle.amin 参数与英文文档不一致问题 --- docs/api/paddle/amin_cn.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/api/paddle/amin_cn.rst b/docs/api/paddle/amin_cn.rst index 6b2ef3632fc..4d6ce3258da 100644 --- a/docs/api/paddle/amin_cn.rst +++ b/docs/api/paddle/amin_cn.rst @@ -15,8 +15,8 @@ amin 参数 ::::::::: - **x** （Tensor）- Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 - - **axis** （list | int，可选）- 求最小值运算的维度。如果为None，则计算所有元素的最小值并返回包含单个元素的Tensor变量，否则必须在 :math:`[−x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] < 0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 - - **keepdim** （bool）- 是否在输出Tensor中保留减小的维度。如果keepdim 为False，结果张量的维度将比输入张量的小，默认值为False。 + - **axis** （int | list | tuple，可选）- 求最小值运算的维度。如果为None，则计算所有元素的最小值并返回包含单个元素的Tensor变量，否则必须在 :math:`[−x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] < 0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 + - **keepdim** （bool，可选）- 是否在输出Tensor中保留减小的维度。如果keepdim 为False，结果张量的维度将比输入张量的小，默认值为False。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 返回 From 4d273f6905949762fb949f7eb0835b67db16c01f Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Thu, 21 Jul 2022 17:04:36 +0800 Subject: [PATCH 03/49] Update py_reader_cn.rst --- docs/api/paddle/fluid/layers/py_reader_cn.rst | 4 ---- 1 file changed, 4 deletions(-) diff --git a/docs/api/paddle/fluid/layers/py_reader_cn.rst b/docs/api/paddle/fluid/layers/py_reader_cn.rst index 788d3b53d77..7be017f1c71 100644 --- a/docs/api/paddle/fluid/layers/py_reader_cn.rst +++ b/docs/api/paddle/fluid/layers/py_reader_cn.rst @@ -30,10 +30,6 @@ py_reader :::::::::::: reader，从reader中可以获取feed的数据，其dtype和feed的数据dtype相同。 -返回类型 -:::::::::::: -Variable - 代码示例 From b8b654b88c16dfc6b7f4136d612498533ea04c19 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Thu, 21 Jul 2022 17:09:28 +0800 Subject: [PATCH 04/49] Update ctc_greedy_decoder_cn.rst --- docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst index 94c8aeffc4e..3568e87469a 100644 --- a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst +++ b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst @@ -84,11 +84,7 @@ ctc_greedy_decoder 返回 :::::::::::: -对于输入为LoDTensor的情况，返回CTC贪婪解码器的结果，即2-D LoDTensor，形状为[Lp，1]，数据类型为int64。 “ Lp”是所有输出序列长度的总和。如果结果中的所有序列均为空，则结果LoDTensor将为[-1]，其中LoD为[[]]。对于输入为Tensor的情况，返回一个元组，(output, output_length)，其中，output是一个形状为 [batch_size, N]，类型为int64的Tensor。output_length是一个形状为[batch_size, 1]，类型为int64的Tensor，表示Tensor输入下，每个输出序列的长度。 - -返回类型 -:::::::::::: - Variable +Tensor,对于输入为LoDTensor的情况，返回CTC贪婪解码器的结果，即2-D LoDTensor，形状为[Lp，1]，数据类型为int64。 “ Lp”是所有输出序列长度的总和。如果结果中的所有序列均为空，则结果LoDTensor将为[-1]，其中LoD为[[]]。对于输入为Tensor的情况，返回一个元组，(output, output_length)，其中，output是一个形状为 [batch_size, N]，类型为int64的Tensor。output_length是一个形状为[batch_size, 1]，类型为int64的Tensor，表示Tensor输入下，每个输出序列的长度。 代码示例 From a1fd757062ad90795c833f6ff683fc4ccf20e4b6 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Thu, 21 Jul 2022 21:10:04 +0800 Subject: [PATCH 05/49] Update im2sequence_cn.rst --- docs/api/paddle/fluid/layers/im2sequence_cn.rst | 4 ---- 1 file changed, 4 deletions(-) diff --git a/docs/api/paddle/fluid/layers/im2sequence_cn.rst b/docs/api/paddle/fluid/layers/im2sequence_cn.rst index 2c6e07cd084..d95823e9260 100644 --- a/docs/api/paddle/fluid/layers/im2sequence_cn.rst +++ b/docs/api/paddle/fluid/layers/im2sequence_cn.rst @@ -33,10 +33,6 @@ im2sequence :::::::::::: 数据类型为float32, `shape` 为 `{batch_size * output_height * output_width, filter_size_height * filter_size_width * input.channels}` 的 2-D LodTensor。 -返回类型 -:::::::::::: - Variable - :: Given: From fcd450c0f431a953b999dee6875af5433f412a8f Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Thu, 21 Jul 2022 21:11:59 +0800 Subject: [PATCH 06/49] Update pad_constant_like_cn.rst --- docs/api/paddle/fluid/layers/pad_constant_like_cn.rst | 4 ---- 1 file changed, 4 deletions(-) diff --git a/docs/api/paddle/fluid/layers/pad_constant_like_cn.rst b/docs/api/paddle/fluid/layers/pad_constant_like_cn.rst index 5b2be40c70d..bd08b4b0774 100644 --- a/docs/api/paddle/fluid/layers/pad_constant_like_cn.rst +++ b/docs/api/paddle/fluid/layers/pad_constant_like_cn.rst @@ -68,10 +68,6 @@ pad_constant_like :::::::::::: 经过维度填充后的Tensor，与x具有相同的shape，与y具有相同的数据类型 -返回类型 -:::::::::::: - Variable - 代码示例 :::::::::::: From 2780a6b1f19f3732b8977eed7ecc28c3479e6e77 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Thu, 21 Jul 2022 21:17:29 +0800 Subject: [PATCH 07/49] Update space_to_depth_cn.rst --- docs/api/paddle/fluid/layers/space_to_depth_cn.rst | 4 ---- 1 file changed, 4 deletions(-) diff --git a/docs/api/paddle/fluid/layers/space_to_depth_cn.rst b/docs/api/paddle/fluid/layers/space_to_depth_cn.rst index eb7057b2360..d72e0bcd0a3 100644 --- a/docs/api/paddle/fluid/layers/space_to_depth_cn.rst +++ b/docs/api/paddle/fluid/layers/space_to_depth_cn.rst @@ -50,10 +50,6 @@ space_to_depth :::::::::::: 输出，形状为 ``[batch, channel * blocksize * blocksize, height/blocksize, width/blocksize]`` 的4维Tensor或LoD Tensor。数据类型与输入 ``x`` 一致。 -返回类型 -:::::::::::: -Variable - 抛出异常 :::::::::::: From 50fc0ccbd7ceb47e581927ab5f97185bccef6f03 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Thu, 21 Jul 2022 21:29:29 +0800 Subject: [PATCH 08/49] Update simple_img_conv_pool_cn.rst --- docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst b/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst index 023430f2230..3181bd6493f 100644 --- a/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst +++ b/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst @@ -34,11 +34,7 @@ simple_img_conv_pool 返回 :::::::::::: - 输入input经过conv2d和pool2d之后输入的结果，数据类型与input相同 - -返回类型 -:::::::::::: - Variable + Tensor, 输入input经过conv2d和pool2d之后输入的结果，数据类型与input相同 代码示例 :::::::::::: From ede3ab30ed07fb75be080d54d7a582cf379dbc82 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Thu, 21 Jul 2022 21:31:25 +0800 Subject: [PATCH 09/49] Update sequence_conv_pool_cn.rst --- docs/api/paddle/fluid/nets/sequence_conv_pool_cn.rst | 5 ----- 1 file changed, 5 deletions(-) diff --git a/docs/api/paddle/fluid/nets/sequence_conv_pool_cn.rst b/docs/api/paddle/fluid/nets/sequence_conv_pool_cn.rst index 95b32fce2e1..c972f623a01 100644 --- a/docs/api/paddle/fluid/nets/sequence_conv_pool_cn.rst +++ b/docs/api/paddle/fluid/nets/sequence_conv_pool_cn.rst @@ -29,11 +29,6 @@ sequence_conv_pool :::::::::::: 经过sequence_conv和sequence_pool两个操作之后的结果所表示的Tensor，数据类型与 ``input`` 相同 - -返回类型 -:::::::::::: -Variable - 代码示例 :::::::::::: From dd26059d2923cba7de44eeb332a11bfc13295285 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sat, 23 Jul 2022 09:59:13 +0800 Subject: [PATCH 10/49] Update roi_perspective_transform_cn.rst --- docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst | 4 ---- 1 file changed, 4 deletions(-) diff --git a/docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst b/docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst index c6f67d00880..02876e3c9c4 100644 --- a/docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst +++ b/docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst @@ -26,10 +26,6 @@ roi_perspective_transform - ``mask`` : ``ROIPerspectiveTransformOp`` 的掩码，4D-LoDTensor，形状是(num_rois,1,transformed_height,transformed_width)，lod_level为1 - ``transform_matrix`` : ``ROIPerspectiveTransformOp`` 的转换矩阵，2D-LoDTensor，形状是(num_rois,9)，lod_level为1 -返回类型 -:::::::::::: - 元组 - 代码示例 :::::::::::: From cb45e67c9f814a8b220f285a90e4da426609ad7b Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sat, 23 Jul 2022 10:02:40 +0800 Subject: [PATCH 11/49] Modify English punctuation marks --- docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst | 2 +- docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst index 3568e87469a..249f0385033 100644 --- a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst +++ b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst @@ -84,7 +84,7 @@ ctc_greedy_decoder 返回 :::::::::::: -Tensor,对于输入为LoDTensor的情况，返回CTC贪婪解码器的结果，即2-D LoDTensor，形状为[Lp，1]，数据类型为int64。 “ Lp”是所有输出序列长度的总和。如果结果中的所有序列均为空，则结果LoDTensor将为[-1]，其中LoD为[[]]。对于输入为Tensor的情况，返回一个元组，(output, output_length)，其中，output是一个形状为 [batch_size, N]，类型为int64的Tensor。output_length是一个形状为[batch_size, 1]，类型为int64的Tensor，表示Tensor输入下，每个输出序列的长度。 +Tensor，对于输入为LoDTensor的情况，返回CTC贪婪解码器的结果，即2-D LoDTensor，形状为[Lp，1]，数据类型为int64。 “ Lp”是所有输出序列长度的总和。如果结果中的所有序列均为空，则结果LoDTensor将为[-1]，其中LoD为[[]]。对于输入为Tensor的情况，返回一个元组，(output, output_length)，其中，output是一个形状为 [batch_size, N]，类型为int64的Tensor。output_length是一个形状为[batch_size, 1]，类型为int64的Tensor，表示Tensor输入下，每个输出序列的长度。 代码示例 diff --git a/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst b/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst index 3181bd6493f..142351cc412 100644 --- a/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst +++ b/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst @@ -34,7 +34,7 @@ simple_img_conv_pool 返回 :::::::::::: - Tensor, 输入input经过conv2d和pool2d之后输入的结果，数据类型与input相同 + Tensor， 输入input经过conv2d和pool2d之后输入的结果，数据类型与input相同 代码示例 :::::::::::: From e80c824d92041210fef1fbb72212c9d9646405b1 Mon Sep 17 00:00:00 2001 From: Regan Yue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:00:38 +0800 Subject: [PATCH 12/49] Update docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst Co-authored-by: Nyakku Shigure --- docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst index 249f0385033..c36cab2c970 100644 --- a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst +++ b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst @@ -84,7 +84,7 @@ ctc_greedy_decoder 返回 :::::::::::: -Tensor，对于输入为LoDTensor的情况，返回CTC贪婪解码器的结果，即2-D LoDTensor，形状为[Lp，1]，数据类型为int64。 “ Lp”是所有输出序列长度的总和。如果结果中的所有序列均为空，则结果LoDTensor将为[-1]，其中LoD为[[]]。对于输入为Tensor的情况，返回一个元组，(output, output_length)，其中，output是一个形状为 [batch_size, N]，类型为int64的Tensor。output_length是一个形状为[batch_size, 1]，类型为int64的Tensor，表示Tensor输入下，每个输出序列的长度。 +Tensor，对于输入为LoDTensor的情况，返回CTC贪婪解码器的结果，即2-D LoDTensor，形状为[Lp，1]，数据类型为int64。“Lp”是所有输出序列长度的总和。如果结果中的所有序列均为空，则结果LoDTensor将为[-1]，其中LoD为[[]]。对于输入为Tensor的情况，返回一个元组，(output, output_length)，其中，output是一个形状为 [batch_size, N]，类型为int64的Tensor。output_length是一个形状为[batch_size, 1]，类型为int64的Tensor，表示Tensor输入下，每个输出序列的长度。 代码示例 From b91588e711f333f34e1c0f85c757b6f80a4a5f4b Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:04:31 +0800 Subject: [PATCH 13/49] Update ctc_greedy_decoder_cn.rst --- docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst index c36cab2c970..501559fcedf 100644 --- a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst +++ b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst @@ -86,7 +86,10 @@ ctc_greedy_decoder :::::::::::: Tensor，对于输入为LoDTensor的情况，返回CTC贪婪解码器的结果，即2-D LoDTensor，形状为[Lp，1]，数据类型为int64。“Lp”是所有输出序列长度的总和。如果结果中的所有序列均为空，则结果LoDTensor将为[-1]，其中LoD为[[]]。对于输入为Tensor的情况，返回一个元组，(output, output_length)，其中，output是一个形状为 [batch_size, N]，类型为int64的Tensor。output_length是一个形状为[batch_size, 1]，类型为int64的Tensor，表示Tensor输入下，每个输出序列的长度。 - +返回类型 +:::::::::::: + Variable + 代码示例 :::::::::::: From 2a86c72e52ed25a64947666366c9b6b049249505 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:05:44 +0800 Subject: [PATCH 14/49] Update ctc_greedy_decoder_cn.rst --- docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst index 501559fcedf..2f506b4f3e8 100644 --- a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst +++ b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst @@ -84,7 +84,7 @@ ctc_greedy_decoder 返回 :::::::::::: -Tensor，对于输入为LoDTensor的情况，返回CTC贪婪解码器的结果，即2-D LoDTensor，形状为[Lp，1]，数据类型为int64。“Lp”是所有输出序列长度的总和。如果结果中的所有序列均为空，则结果LoDTensor将为[-1]，其中LoD为[[]]。对于输入为Tensor的情况，返回一个元组，(output, output_length)，其中，output是一个形状为 [batch_size, N]，类型为int64的Tensor。output_length是一个形状为[batch_size, 1]，类型为int64的Tensor，表示Tensor输入下，每个输出序列的长度。 +对于输入为LoDTensor的情况，返回CTC贪婪解码器的结果，即2-D LoDTensor，形状为[Lp，1]，数据类型为int64。“Lp”是所有输出序列长度的总和。如果结果中的所有序列均为空，则结果LoDTensor将为[-1]，其中LoD为[[]]。对于输入为Tensor的情况，返回一个元组，(output, output_length)，其中，output是一个形状为 [batch_size, N]，类型为int64的Tensor。output_length是一个形状为[batch_size, 1]，类型为int64的Tensor，表示Tensor输入下，每个输出序列的长度。 返回类型 :::::::::::: From b70adae63762f905c291af0b2d8abf4991b66821 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:06:11 +0800 Subject: [PATCH 15/49] Update ctc_greedy_decoder_cn.rst --- docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst index 2f506b4f3e8..e91e04977ff 100644 --- a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst +++ b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst @@ -89,7 +89,6 @@ ctc_greedy_decoder 返回类型 :::::::::::: Variable - 代码示例 :::::::::::: From 83973f364efee3d75300642cc5dfdfab84c27970 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:06:38 +0800 Subject: [PATCH 16/49] Update ctc_greedy_decoder_cn.rst --- docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst index e91e04977ff..09244bd9c3f 100644 --- a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst +++ b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst @@ -89,6 +89,8 @@ ctc_greedy_decoder 返回类型 :::::::::::: Variable + + 代码示例 :::::::::::: From cfd1e38bb1801379dbc70c84a1e24dc8b813bf49 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:15:38 +0800 Subject: [PATCH 17/49] Update ctc_greedy_decoder_cn.rst --- docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst index 09244bd9c3f..6c07df9f45d 100644 --- a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst +++ b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst @@ -90,7 +90,7 @@ ctc_greedy_decoder :::::::::::: Variable - + 代码示例 :::::::::::: From e8a91f0ffe973b2bf82b10305d312be966a79190 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:17:15 +0800 Subject: [PATCH 18/49] Update im2sequence_cn.rst --- docs/api/paddle/fluid/layers/im2sequence_cn.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/api/paddle/fluid/layers/im2sequence_cn.rst b/docs/api/paddle/fluid/layers/im2sequence_cn.rst index d95823e9260..f5555c84914 100644 --- a/docs/api/paddle/fluid/layers/im2sequence_cn.rst +++ b/docs/api/paddle/fluid/layers/im2sequence_cn.rst @@ -33,6 +33,10 @@ im2sequence :::::::::::: 数据类型为float32, `shape` 为 `{batch_size * output_height * output_width, filter_size_height * filter_size_width * input.channels}` 的 2-D LodTensor。 +返回类型 +:::::::::::: + Variable + :: Given: From 17e07f86af8152a117e0484b520eb2e2611c325a Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:17:34 +0800 Subject: [PATCH 19/49] Update im2sequence_cn.rst --- docs/api/paddle/fluid/layers/im2sequence_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/fluid/layers/im2sequence_cn.rst b/docs/api/paddle/fluid/layers/im2sequence_cn.rst index f5555c84914..2c6e07cd084 100644 --- a/docs/api/paddle/fluid/layers/im2sequence_cn.rst +++ b/docs/api/paddle/fluid/layers/im2sequence_cn.rst @@ -36,7 +36,7 @@ im2sequence 返回类型 :::::::::::: Variable - + :: Given: From 46a3b4fae0adde6f0d5ce20f450c67c411e3af4a Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:18:14 +0800 Subject: [PATCH 20/49] Update pad_constant_like_cn.rst --- docs/api/paddle/fluid/layers/pad_constant_like_cn.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/api/paddle/fluid/layers/pad_constant_like_cn.rst b/docs/api/paddle/fluid/layers/pad_constant_like_cn.rst index bd08b4b0774..5b2be40c70d 100644 --- a/docs/api/paddle/fluid/layers/pad_constant_like_cn.rst +++ b/docs/api/paddle/fluid/layers/pad_constant_like_cn.rst @@ -68,6 +68,10 @@ pad_constant_like :::::::::::: 经过维度填充后的Tensor，与x具有相同的shape，与y具有相同的数据类型 +返回类型 +:::::::::::: + Variable + 代码示例 :::::::::::: From 55152457123dcbb4ee5946a3019162400aa82e91 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:19:12 +0800 Subject: [PATCH 21/49] Update py_reader_cn.rst --- docs/api/paddle/fluid/layers/py_reader_cn.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/api/paddle/fluid/layers/py_reader_cn.rst b/docs/api/paddle/fluid/layers/py_reader_cn.rst index 7be017f1c71..788d3b53d77 100644 --- a/docs/api/paddle/fluid/layers/py_reader_cn.rst +++ b/docs/api/paddle/fluid/layers/py_reader_cn.rst @@ -30,6 +30,10 @@ py_reader :::::::::::: reader，从reader中可以获取feed的数据，其dtype和feed的数据dtype相同。 +返回类型 +:::::::::::: +Variable + 代码示例 From 6ac74a7b115cacea6f714ab3440d620b216d42ad Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:20:02 +0800 Subject: [PATCH 22/49] Update roi_perspective_transform_cn.rst --- docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst b/docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst index 02876e3c9c4..29fd0bc66f5 100644 --- a/docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst +++ b/docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst @@ -26,6 +26,10 @@ roi_perspective_transform - ``mask`` : ``ROIPerspectiveTransformOp`` 的掩码，4D-LoDTensor，形状是(num_rois,1,transformed_height,transformed_width)，lod_level为1 - ``transform_matrix`` : ``ROIPerspectiveTransformOp`` 的转换矩阵，2D-LoDTensor，形状是(num_rois,9)，lod_level为1 +返回类型 +:::::::::::: + 元组 + 代码示例 :::::::::::: From 4061facc48421bd717127257d4ea97bd91e30914 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:20:26 +0800 Subject: [PATCH 23/49] Update roi_perspective_transform_cn.rst --- docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst b/docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst index 29fd0bc66f5..c6f67d00880 100644 --- a/docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst +++ b/docs/api/paddle/fluid/layers/roi_perspective_transform_cn.rst @@ -29,7 +29,7 @@ roi_perspective_transform 返回类型 :::::::::::: 元组 - + 代码示例 :::::::::::: From 6863f3087b29872a1efe2c11ead904b33deab83e Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:21:01 +0800 Subject: [PATCH 24/49] Update space_to_depth_cn.rst --- docs/api/paddle/fluid/layers/space_to_depth_cn.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/api/paddle/fluid/layers/space_to_depth_cn.rst b/docs/api/paddle/fluid/layers/space_to_depth_cn.rst index d72e0bcd0a3..eb7057b2360 100644 --- a/docs/api/paddle/fluid/layers/space_to_depth_cn.rst +++ b/docs/api/paddle/fluid/layers/space_to_depth_cn.rst @@ -50,6 +50,10 @@ space_to_depth :::::::::::: 输出，形状为 ``[batch, channel * blocksize * blocksize, height/blocksize, width/blocksize]`` 的4维Tensor或LoD Tensor。数据类型与输入 ``x`` 一致。 +返回类型 +:::::::::::: +Variable + 抛出异常 :::::::::::: From 4b6e7b63eccac14f2871626dfa1f6dec29042af9 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:22:08 +0800 Subject: [PATCH 25/49] Update sequence_conv_pool_cn.rst --- docs/api/paddle/fluid/nets/sequence_conv_pool_cn.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/api/paddle/fluid/nets/sequence_conv_pool_cn.rst b/docs/api/paddle/fluid/nets/sequence_conv_pool_cn.rst index c972f623a01..95b32fce2e1 100644 --- a/docs/api/paddle/fluid/nets/sequence_conv_pool_cn.rst +++ b/docs/api/paddle/fluid/nets/sequence_conv_pool_cn.rst @@ -29,6 +29,11 @@ sequence_conv_pool :::::::::::: 经过sequence_conv和sequence_pool两个操作之后的结果所表示的Tensor，数据类型与 ``input`` 相同 + +返回类型 +:::::::::::: +Variable + 代码示例 :::::::::::: From e83103ce2c1753fb30977a4b15cab6d990ff3ae1 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:23:21 +0800 Subject: [PATCH 26/49] Update simple_img_conv_pool_cn.rst --- docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst b/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst index 142351cc412..b0934e5d335 100644 --- a/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst +++ b/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst @@ -34,7 +34,11 @@ simple_img_conv_pool 返回 :::::::::::: - Tensor， 输入input经过conv2d和pool2d之后输入的结果，数据类型与input相同 +输入input经过conv2d和pool2d之后输入的结果，数据类型与input相同 + +返回类型 +:::::::::::: + Variable 代码示例 :::::::::::: From b0ffc527f4ce8c2c88e61a33864697717935cf8a Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Sun, 24 Jul 2022 22:23:57 +0800 Subject: [PATCH 27/49] Update simple_img_conv_pool_cn.rst --- docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst b/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst index b0934e5d335..023430f2230 100644 --- a/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst +++ b/docs/api/paddle/fluid/nets/simple_img_conv_pool_cn.rst @@ -34,7 +34,7 @@ simple_img_conv_pool 返回 :::::::::::: -输入input经过conv2d和pool2d之后输入的结果，数据类型与input相同 + 输入input经过conv2d和pool2d之后输入的结果，数据类型与input相同 返回类型 :::::::::::: From 196f3e749fb1b4022be55373d4b8598b54508404 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 27 Jul 2022 15:15:01 +0800 Subject: [PATCH 28/49] Update amax_cn.rst --- docs/api/paddle/amax_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/amax_cn.rst b/docs/api/paddle/amax_cn.rst index dcb52ae27a3..df8d3fbc8a6 100644 --- a/docs/api/paddle/amax_cn.rst +++ b/docs/api/paddle/amax_cn.rst @@ -15,7 +15,7 @@ amax 参数 ::::::::: - **x** （Tensor）- Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 - - **axis** （int|list|tuple，可选）- 求最大值运算的维度。如果为None，则计算所有元素的最大值并返回包含单个元素的Tensor变量，否则必须在 :math:`[-x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] <0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 + - **axis** （int | list | tuple，可选）- 求最大值运算的维度。如果为None，则计算所有元素的最大值并返回包含单个元素的Tensor变量，否则必须在 :math:`[-x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] <0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 - **keepdim** （bool，可选）- 是否在输出Tensor中保留减小的维度。如果keepdim 为 False，结果张量的维度将比输入张量的小，默认值为False。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 From 7ef06298374abf88dd089f2a08a7809f23603eef Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 27 Jul 2022 15:29:21 +0800 Subject: [PATCH 29/49] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E6=A0=BC=E5=BC=8F?= =?UTF-8?q?=E5=8F=8A=E4=B8=AD=E8=8B=B1=E6=96=87=E6=8B=AC=E5=8F=B7=E9=97=AE?= =?UTF-8?q?=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/api/paddle/amax_cn.rst | 6 +++--- docs/api/paddle/amin_cn.rst | 4 ++-- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/api/paddle/amax_cn.rst b/docs/api/paddle/amax_cn.rst index df8d3fbc8a6..ca43b2de9a0 100644 --- a/docs/api/paddle/amax_cn.rst +++ b/docs/api/paddle/amax_cn.rst @@ -14,9 +14,9 @@ amax 参数 ::::::::: - - **x** （Tensor）- Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 - - **axis** （int | list | tuple，可选）- 求最大值运算的维度。如果为None，则计算所有元素的最大值并返回包含单个元素的Tensor变量，否则必须在 :math:`[-x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] <0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 - - **keepdim** （bool，可选）- 是否在输出Tensor中保留减小的维度。如果keepdim 为 False，结果张量的维度将比输入张量的小，默认值为False。 + - **x** (Tensor)- Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 + - **axis** (int \| list \| tuple，可选) - 求最大值运算的维度。如果为None，则计算所有元素的最大值并返回包含单个元素的Tensor变量，否则必须在 :math:`[-x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] <0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 + - **keepdim** (bool，可选)- 是否在输出Tensor中保留减小的维度。如果keepdim 为 False，结果张量的维度将比输入张量的小，默认值为False。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 返回 diff --git a/docs/api/paddle/amin_cn.rst b/docs/api/paddle/amin_cn.rst index 4d6ce3258da..28cfd9cca7f 100644 --- a/docs/api/paddle/amin_cn.rst +++ b/docs/api/paddle/amin_cn.rst @@ -14,8 +14,8 @@ amin 参数 ::::::::: - - **x** （Tensor）- Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 - - **axis** （int | list | tuple，可选）- 求最小值运算的维度。如果为None，则计算所有元素的最小值并返回包含单个元素的Tensor变量，否则必须在 :math:`[−x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] < 0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 + - **x** (Tensor)- Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 + - **axis** (int \| list \| tuple，可选) - 求最小值运算的维度。如果为None，则计算所有元素的最小值并返回包含单个元素的Tensor变量，否则必须在 :math:`[−x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] < 0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 - **keepdim** （bool，可选）- 是否在输出Tensor中保留减小的维度。如果keepdim 为False，结果张量的维度将比输入张量的小，默认值为False。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 From a71c5c85a4edf7c58bfc88a186540eaa7acf49a6 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 27 Jul 2022 15:55:22 +0800 Subject: [PATCH 30/49] update --- docs/api/paddle/amax_cn.rst | 4 ++-- docs/api/paddle/amin_cn.rst | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/api/paddle/amax_cn.rst b/docs/api/paddle/amax_cn.rst index ca43b2de9a0..5a009a639bb 100644 --- a/docs/api/paddle/amax_cn.rst +++ b/docs/api/paddle/amax_cn.rst @@ -14,8 +14,8 @@ amax 参数 ::::::::: - - **x** (Tensor)- Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 - - **axis** (int \| list \| tuple，可选) - 求最大值运算的维度。如果为None，则计算所有元素的最大值并返回包含单个元素的Tensor变量，否则必须在 :math:`[-x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] <0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 + - **x** (Tensor) - Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 + - **axis** (int | list | tuple，可选) - 求最大值运算的维度。如果为None，则计算所有元素的最大值并返回包含单个元素的Tensor变量，否则必须在 :math:`[-x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] <0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 - **keepdim** (bool，可选)- 是否在输出Tensor中保留减小的维度。如果keepdim 为 False，结果张量的维度将比输入张量的小，默认值为False。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 diff --git a/docs/api/paddle/amin_cn.rst b/docs/api/paddle/amin_cn.rst index 28cfd9cca7f..1ddd9eab0ce 100644 --- a/docs/api/paddle/amin_cn.rst +++ b/docs/api/paddle/amin_cn.rst @@ -14,8 +14,8 @@ amin 参数 ::::::::: - - **x** (Tensor)- Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 - - **axis** (int \| list \| tuple，可选) - 求最小值运算的维度。如果为None，则计算所有元素的最小值并返回包含单个元素的Tensor变量，否则必须在 :math:`[−x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] < 0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 + - **x** (Tensor) - Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 + - **axis** (int | list | tuple，可选) - 求最小值运算的维度。如果为None，则计算所有元素的最小值并返回包含单个元素的Tensor变量，否则必须在 :math:`[−x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] < 0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 - **keepdim** （bool，可选）- 是否在输出Tensor中保留减小的维度。如果keepdim 为False，结果张量的维度将比输入张量的小，默认值为False。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 From b4cee44e85ba51c6d414e30b525ffde6b2b75df6 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 27 Jul 2022 16:00:43 +0800 Subject: [PATCH 31/49] Update amin_cn.rst --- docs/api/paddle/amin_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/amin_cn.rst b/docs/api/paddle/amin_cn.rst index 1ddd9eab0ce..fb6218aeddc 100644 --- a/docs/api/paddle/amin_cn.rst +++ b/docs/api/paddle/amin_cn.rst @@ -16,7 +16,7 @@ amin ::::::::: - **x** (Tensor) - Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 - **axis** (int | list | tuple，可选) - 求最小值运算的维度。如果为None，则计算所有元素的最小值并返回包含单个元素的Tensor变量，否则必须在 :math:`[−x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] < 0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 - - **keepdim** （bool，可选）- 是否在输出Tensor中保留减小的维度。如果keepdim 为False，结果张量的维度将比输入张量的小，默认值为False。 + - **keepdim** (bool，可选)- 是否在输出Tensor中保留减小的维度。如果keepdim 为False，结果张量的维度将比输入张量的小，默认值为False。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 返回 From 89219d01939ad7a6104ae04bf508a9056e2d1911 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 27 Jul 2022 16:12:08 +0800 Subject: [PATCH 32/49] Update ctc_greedy_decoder_cn.rst --- docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst index 6c07df9f45d..f8726681141 100644 --- a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst +++ b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst @@ -84,7 +84,8 @@ ctc_greedy_decoder 返回 :::::::::::: -对于输入为LoDTensor的情况，返回CTC贪婪解码器的结果，即2-D LoDTensor，形状为[Lp，1]，数据类型为int64。“Lp”是所有输出序列长度的总和。如果结果中的所有序列均为空，则结果LoDTensor将为[-1]，其中LoD为[[]]。对于输入为Tensor的情况，返回一个元组，(output, output_length)，其中，output是一个形状为 [batch_size, N]，类型为int64的Tensor。output_length是一个形状为[batch_size, 1]，类型为int64的Tensor，表示Tensor输入下，每个输出序列的长度。 +对于输入为LoDTensor的情况，返回CTC贪婪解码器的结果，即2-D LoDTensor，形状为[Lp，1]，数据类型为int64。“Lp”是所有输出序列长度的总和。如果结果中的所有序列均为空，则结果LoDTensor将为[-1]，其中LoD为[[]]。 +对于输入为Tensor的情况，返回一个元组，(output, output_length)，其中，output是一个形状为 [batch_size, N]，类型为int64的Tensor。output_length是一个形状为[batch_size, 1]，类型为int64的Tensor，表示Tensor输入下，每个输出序列的长度。 返回类型 :::::::::::: From 4d8bc3b8472db7043a000d4f42e338f2d3f3b298 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 27 Jul 2022 16:36:20 +0800 Subject: [PATCH 33/49] Update ctc_greedy_decoder_cn.rst --- docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst index f8726681141..e9b260c781d 100644 --- a/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst +++ b/docs/api/paddle/fluid/layers/ctc_greedy_decoder_cn.rst @@ -85,6 +85,7 @@ ctc_greedy_decoder 返回 :::::::::::: 对于输入为LoDTensor的情况，返回CTC贪婪解码器的结果，即2-D LoDTensor，形状为[Lp，1]，数据类型为int64。“Lp”是所有输出序列长度的总和。如果结果中的所有序列均为空，则结果LoDTensor将为[-1]，其中LoD为[[]]。 + 对于输入为Tensor的情况，返回一个元组，(output, output_length)，其中，output是一个形状为 [batch_size, N]，类型为int64的Tensor。output_length是一个形状为[batch_size, 1]，类型为int64的Tensor，表示Tensor输入下，每个输出序列的长度。 返回类型 From a7ae51c929c84d26b2d5dc23b8deda018d70eaa4 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Fri, 29 Jul 2022 17:22:21 +0800 Subject: [PATCH 34/49] update --- docs/api/paddle/amax_cn.rst | 2 +- docs/api/paddle/amin_cn.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/api/paddle/amax_cn.rst b/docs/api/paddle/amax_cn.rst index 5a009a639bb..13990883ed4 100644 --- a/docs/api/paddle/amax_cn.rst +++ b/docs/api/paddle/amax_cn.rst @@ -15,7 +15,7 @@ amax 参数 ::::::::: - **x** (Tensor) - Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 - - **axis** (int | list | tuple，可选) - 求最大值运算的维度。如果为None，则计算所有元素的最大值并返回包含单个元素的Tensor变量，否则必须在 :math:`[-x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] <0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 + - **axis** (int、list、tuple，可选) - 求最大值运算的维度。如果为None，则计算所有元素的最大值并返回包含单个元素的Tensor变量，否则必须在 :math:`[-x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] <0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 - **keepdim** (bool，可选)- 是否在输出Tensor中保留减小的维度。如果keepdim 为 False，结果张量的维度将比输入张量的小，默认值为False。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 diff --git a/docs/api/paddle/amin_cn.rst b/docs/api/paddle/amin_cn.rst index fb6218aeddc..f1cbac87be4 100644 --- a/docs/api/paddle/amin_cn.rst +++ b/docs/api/paddle/amin_cn.rst @@ -15,7 +15,7 @@ amin 参数 ::::::::: - **x** (Tensor) - Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 - - **axis** (int | list | tuple，可选) - 求最小值运算的维度。如果为None，则计算所有元素的最小值并返回包含单个元素的Tensor变量，否则必须在 :math:`[−x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] < 0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 + - **axis** (int、list、tuple，可选) - 求最小值运算的维度。如果为None，则计算所有元素的最小值并返回包含单个元素的Tensor变量，否则必须在 :math:`[−x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] < 0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 - **keepdim** (bool，可选)- 是否在输出Tensor中保留减小的维度。如果keepdim 为False，结果张量的维度将比输入张量的小，默认值为False。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 From bd384403e73a228601aa29c003b6c1756f22364d Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Fri, 29 Jul 2022 17:35:59 +0800 Subject: [PATCH 35/49] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=A0=87=E7=82=B9?= =?UTF-8?q?=E7=AC=A6=E5=8F=B7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/api/paddle/amax_cn.rst | 4 ++-- docs/api/paddle/amin_cn.rst | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/api/paddle/amax_cn.rst b/docs/api/paddle/amax_cn.rst index 13990883ed4..9084f6377c3 100644 --- a/docs/api/paddle/amax_cn.rst +++ b/docs/api/paddle/amax_cn.rst @@ -14,8 +14,8 @@ amax 参数 ::::::::: - - **x** (Tensor) - Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 - - **axis** (int、list、tuple，可选) - 求最大值运算的维度。如果为None，则计算所有元素的最大值并返回包含单个元素的Tensor变量，否则必须在 :math:`[-x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] <0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 + - **x** (Tensor) - Tensor，支持数据类型为float32、float64、int32、int64，维度不超过4维。 + - **axis** (int|list|tuple，可选) - 求最大值运算的维度。如果为None，则计算所有元素的最大值并返回包含单个元素的Tensor变量，否则必须在 :math:`[-x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] <0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 - **keepdim** (bool，可选)- 是否在输出Tensor中保留减小的维度。如果keepdim 为 False，结果张量的维度将比输入张量的小，默认值为False。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 diff --git a/docs/api/paddle/amin_cn.rst b/docs/api/paddle/amin_cn.rst index f1cbac87be4..45c05472c23 100644 --- a/docs/api/paddle/amin_cn.rst +++ b/docs/api/paddle/amin_cn.rst @@ -14,8 +14,8 @@ amin 参数 ::::::::: - - **x** (Tensor) - Tensor，支持数据类型为float32，float64，int32，int64，维度不超过4维。 - - **axis** (int、list、tuple，可选) - 求最小值运算的维度。如果为None，则计算所有元素的最小值并返回包含单个元素的Tensor变量，否则必须在 :math:`[−x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] < 0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 + - **x** (Tensor) - Tensor，支持数据类型为float32、float64、int32、int64，维度不超过4维。 + - **axis** (int|list|tuple，可选) - 求最小值运算的维度。如果为None，则计算所有元素的最小值并返回包含单个元素的Tensor变量，否则必须在 :math:`[−x.ndim, x.ndim]` 范围内。如果 :math:`axis[i] < 0`，则维度将变为 :math:`x.ndim+axis[i]`，默认值为None。 - **keepdim** (bool，可选)- 是否在输出Tensor中保留减小的维度。如果keepdim 为False，结果张量的维度将比输入张量的小，默认值为False。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 From db1db9bb05c82acd5f6c467f9dbe2f5afca349f5 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 3 Aug 2022 16:30:40 +0800 Subject: [PATCH 36/49] Update save_inference_model_cn.rst --- docs/api/paddle/static/save_inference_model_cn.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/api/paddle/static/save_inference_model_cn.rst b/docs/api/paddle/static/save_inference_model_cn.rst index 9d40bd5ef94..e1918845b8d 100644 --- a/docs/api/paddle/static/save_inference_model_cn.rst +++ b/docs/api/paddle/static/save_inference_model_cn.rst @@ -19,10 +19,12 @@ save_inference_model - **feed_vars** (Variable | list[Variable]) – 模型的所有输入变量。 - **fetch_vars** (Variable | list[Variable]) – 模型的所有输出变量。 - **executor** (Executor) – 用于保存预测模型的 ``executor``，详见 :ref:`api_guide_executor` 。 - - **kwargs** - 支持的 key 包括 'program'。(注意：kwargs 主要是用来做反向兼容的)。 + - **kwargs** - 支持的 key 包括 'program'和 'clip_extra'。(注意：kwargs 主要是用来做反向兼容的)。 - **program** - 自定义一个 program，默认使用 default_main_program。 + - **clip_extra** - 如果你想为每个算子附加额外的信息，则设置为True。 + 返回 :::::::::::: From c867398ba7ec26d173dc26364d56c46146c01827 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 3 Aug 2022 16:37:44 +0800 Subject: [PATCH 37/49] Update crop_cn.rst --- docs/api/paddle/crop_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/crop_cn.rst b/docs/api/paddle/crop_cn.rst index 94d93cfbeab..2e1aca66116 100644 --- a/docs/api/paddle/crop_cn.rst +++ b/docs/api/paddle/crop_cn.rst @@ -57,7 +57,7 @@ crop 参数 ::::::::: - - **x** (Tensor): 1-D到6-D Tensor，数据类型为float32、float64、int32或者int64。 + - **x** (Tensor) - 1-D到6-D Tensor，数据类型为float32、float64、int32或者int64。 - **shape** (list|tuple|Tensor) - 输出Tensor的形状，数据类型为int32。如果是列表或元组，则其长度必须与x的维度大小相同，如果是Tensor，则其应该是1-D Tensor。当它是列表时，每一个元素可以是整数或者形状为[1]的Tensor。含有Variable的方式适用于每次迭代时需要改变输出形状的情况。 - **offsets** (list|tuple|Tensor，可选) - 每个维度上裁剪的偏移量，数据类型为int32。如果是列表或元组，则其长度必须与x的维度大小相同，如果是Tensor，则其应是1-D Tensor。当它是列表时，每一个元素可以是整数或者形状为[1]的Variable。含有Variable的方式适用于每次迭代的偏移量（offset）都可能改变的情况。默认值：None，每个维度的偏移量为0。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 From 0ed4d8f9564e3021c06abcd56d85d8976f52e625 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 3 Aug 2022 16:49:29 +0800 Subject: [PATCH 38/49] Update unfold_cn.rst --- docs/api/paddle/nn/functional/unfold_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/nn/functional/unfold_cn.rst b/docs/api/paddle/nn/functional/unfold_cn.rst index 8d910dcd827..b2d25cd52b5 100644 --- a/docs/api/paddle/nn/functional/unfold_cn.rst +++ b/docs/api/paddle/nn/functional/unfold_cn.rst @@ -8,7 +8,7 @@ unfold -该OP实现的功能与卷积中用到的im2col函数一样，通常也被称作为im2col过程。对于每一个卷积核覆盖下的区域，元素会被重新排成一列。当卷积核在整个图片上滑动时，将会形成一系列的列向量。对于每一个输入形状为[N, C, H, W]的 ``x``，都将会按照下面公式计算出一个形状为[N, Cout, Lout]的输出。 +实现的功能与卷积中用到的im2col函数一样，通常也被称作为im2col过程。对于每一个卷积核覆盖下的区域，元素会被重新排成一列。当卷积核在整个图片上滑动时，将会形成一系列的列向量。对于每一个输入形状为[N, C, H, W]的 ``x``，都将会按照下面公式计算出一个形状为[N, Cout, Lout]的输出。 .. math:: From d8930dc50d7217ef19178a9c0c438d85132c1ab0 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 3 Aug 2022 16:53:52 +0800 Subject: [PATCH 39/49] Update pad_cn.rst --- docs/api/paddle/nn/functional/pad_cn.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/api/paddle/nn/functional/pad_cn.rst b/docs/api/paddle/nn/functional/pad_cn.rst index 6e34465f20f..d99c31b97df 100644 --- a/docs/api/paddle/nn/functional/pad_cn.rst +++ b/docs/api/paddle/nn/functional/pad_cn.rst @@ -5,7 +5,7 @@ pad .. py:function:: paddle.nn.functional.pad(x, pad, mode="constant", value=0.0, data_format="NCHW", name=None) -该OP依照 ``pad`` 和 ``mode`` 属性对 ``x`` 进行 ``pad``。如果 ``mode`` 为 ``'constant'``，并且 ``pad`` 的长度为 ``x`` 维度的2倍时，则会根据 ``pad`` 和 ``value`` 对 ``x`` 从前面的维度向后依次补齐；否则只会对 ``x`` 在除 ``batch size`` 和 ``channel`` 之外的所有维度进行补齐。如果 ``mode`` 为 ``reflect``，则 ``x`` 对应维度上的长度必须大于对应的 ``pad`` 值。 +依照 ``pad`` 和 ``mode`` 属性对 ``x`` 进行 ``pad``。如果 ``mode`` 为 ``'constant'``，并且 ``pad`` 的长度为 ``x`` 维度的2倍时，则会根据 ``pad`` 和 ``value`` 对 ``x`` 从前面的维度向后依次补齐；否则只会对 ``x`` 在除 ``batch size`` 和 ``channel`` 之外的所有维度进行补齐。如果 ``mode`` 为 ``reflect``，则 ``x`` 对应维度上的长度必须大于对应的 ``pad`` 值。 @@ -18,11 +18,11 @@ pad 则会根据 ``pad`` 和 ``value`` 对 ``x`` 从前面的维度向后依次补齐；否则：1。当输入维度为3时，pad的格式为[pad_left, pad_right]； 2. 当输入维度为4时，pad的格式为[pad_left, pad_right, pad_top, pad_bottom]； 3. 当输入维度为5时，pad的格式为[pad_left, pad_right, pad_top, pad_bottom, pad_front, pad_back]。 - - **mode** (str) - padding的四种模式，分别为 ``'constant'``, ``'reflect'``, ``'replicate'`` 和 ``'circular'``。 + - **mode** (str，可选) - padding的四种模式，分别为 ``'constant'``, ``'reflect'``, ``'replicate'`` 和 ``'circular'``。 ``'constant'`` 表示填充常数 ``value``； ``'reflect'`` 表示填充以 ``x`` 边界值为轴的映射；``'replicate'`` 表示 填充 ``x`` 边界值；``'circular'`` 为循环填充 ``x``。具体结果可见以下示例。默认值为 ``'constant'``。 - - **value** (float32) - 以 ``'constant'`` 模式填充区域时填充的值。默认值为0.0。 - - **data_format** (str) - 指定 ``x`` 的format，可为 ``'NCL'``, ``'NLC'``, ``'NCHW'``, ``'NHWC'``, ``'NCDHW'`` + - **value** (float32，可选) - 以 ``'constant'`` 模式填充区域时填充的值。默认值为0.0。 + - **data_format** (str，可选) - 指定 ``x`` 的format，可为 ``'NCL'``, ``'NLC'``, ``'NCHW'``, ``'NHWC'``, ``'NCDHW'`` 或 ``'NDHWC'``，默认值为 ``'NCHW'``。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 返回 From c299623ecc8442b4b723c53a087a2a6d67e389cc Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 3 Aug 2022 16:56:56 +0800 Subject: [PATCH 40/49] Update zeropad2d_cn.rst --- docs/api/paddle/nn/functional/zeropad2d_cn.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/api/paddle/nn/functional/zeropad2d_cn.rst b/docs/api/paddle/nn/functional/zeropad2d_cn.rst index 8bc036883eb..82cc0d34206 100644 --- a/docs/api/paddle/nn/functional/zeropad2d_cn.rst +++ b/docs/api/paddle/nn/functional/zeropad2d_cn.rst @@ -4,13 +4,13 @@ zeropad2d ------------------------------- .. py:function:: paddle.nn.functional.zeropad2d(x, padding, data_format="NCHW", name=None) -该OP返回一个按照 ``padding`` 属性对 ``x`` 进行零填充的Tensor，数据类型与 ``x`` 相同。 +返回一个按照 ``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'``。 + - **data_format** (str，可选) - 指定 ``x`` 的format，可为 ``'NCHW'``, ``'NHWC'``，默认值为 ``'NCHW'``。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 返回 From de664817509e3b42d2f0bd14cfc4f697cc7bb2a2 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 3 Aug 2022 16:58:32 +0800 Subject: [PATCH 41/49] Update cosine_similarity_cn.rst --- docs/api/paddle/nn/functional/cosine_similarity_cn.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/api/paddle/nn/functional/cosine_similarity_cn.rst b/docs/api/paddle/nn/functional/cosine_similarity_cn.rst index 25699c498ac..6f5c3cd7c56 100644 --- a/docs/api/paddle/nn/functional/cosine_similarity_cn.rst +++ b/docs/api/paddle/nn/functional/cosine_similarity_cn.rst @@ -5,15 +5,15 @@ cosine_similarity .. py:function:: paddle.nn.functional.cosine_similarity(x1, x2, axis=1, eps=1e-8) -该OP用于计算x1与x2沿axis维度的余弦相似度。 +用于计算x1与x2沿axis维度的余弦相似度。 参数 :::::::::::: - **x1** (Tensor) - Tensor，数据类型支持float32, float64。 - **x2** (Tensor) - Tensor，数据类型支持float32, float64。 - - **axis** (int) - 指定计算的维度，会在该维度上计算余弦相似度，默认值为1。 - - **eps** (float) - 很小的值，防止计算时分母为0，默认值为1e-8。 + - **axis** (int，可选) - 指定计算的维度，会在该维度上计算余弦相似度，默认值为1。 + - **eps** (float，可选) - 很小的值，防止计算时分母为0，默认值为1e-8。 返回 From 1dff704097143ae0b2a4151cc96b20612373bd3d Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 3 Aug 2022 17:30:39 +0800 Subject: [PATCH 42/49] Update square_error_cost_cn.rst --- docs/api/paddle/nn/functional/square_error_cost_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/nn/functional/square_error_cost_cn.rst b/docs/api/paddle/nn/functional/square_error_cost_cn.rst index 5e3f70ba886..0fd369e49f1 100644 --- a/docs/api/paddle/nn/functional/square_error_cost_cn.rst +++ b/docs/api/paddle/nn/functional/square_error_cost_cn.rst @@ -6,7 +6,7 @@ square_error_cost .. py:function:: paddle.nn.functional.square_error_cost(input,label) -该OP用于计算预测值和目标值的方差估计。 +用于计算预测值和目标值的方差估计。 对于预测值input和目标值label，公式为： From 9fe00400434464f5c79dae8795a80883a0a0d05b Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 3 Aug 2022 17:31:24 +0800 Subject: [PATCH 43/49] Update smooth_l1_loss_cn.rst --- docs/api/paddle/nn/functional/smooth_l1_loss_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/nn/functional/smooth_l1_loss_cn.rst b/docs/api/paddle/nn/functional/smooth_l1_loss_cn.rst index 87306e28afe..3e6cd8681a5 100644 --- a/docs/api/paddle/nn/functional/smooth_l1_loss_cn.rst +++ b/docs/api/paddle/nn/functional/smooth_l1_loss_cn.rst @@ -5,7 +5,7 @@ smooth_l1_loss .. py:function:: paddle.nn.functional.smooth_l1_loss(input, label, reduction='mean', delta=1.0, name=None) -该OP计算输入input和标签label间的SmoothL1损失，如果逐个元素的绝对误差低于1，则创建使用平方项的条件 +计算输入input和标签label间的SmoothL1损失，如果逐个元素的绝对误差低于1，则创建使用平方项的条件 ，否则为L1损失。在某些情况下，它可以防止爆炸梯度，也称为Huber损失，该损失函数的数学计算公式如下： .. math:: From f3e42a57153a0605873cd672094d68d6881959bb Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 3 Aug 2022 17:35:13 +0800 Subject: [PATCH 44/49] Update margin_ranking_loss_cn.rst --- .../paddle/nn/functional/margin_ranking_loss_cn.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/api/paddle/nn/functional/margin_ranking_loss_cn.rst b/docs/api/paddle/nn/functional/margin_ranking_loss_cn.rst index 58d31ecf37c..262bfceaf68 100644 --- a/docs/api/paddle/nn/functional/margin_ranking_loss_cn.rst +++ b/docs/api/paddle/nn/functional/margin_ranking_loss_cn.rst @@ -5,7 +5,7 @@ margin_ranking_loss .. py:function:: paddle.nn.functional.margin_ranking_loss(input, other, label, margin=0.0, reduction='mean', name=None) -该算子计算输入input，other 和 标签label间的 `margin rank loss` 损失。该损失函数的数学计算公式如下： +计算输入input，other 和 标签label间的 `margin rank loss` 损失。该损失函数的数学计算公式如下： .. math:: margin\_rank\_loss = max(0, -label * (input - other) + margin) @@ -24,11 +24,11 @@ margin_ranking_loss 参数 :::::::: - - **input** （Tensor）：第一个输入的 `Tensor`，数据类型为：float32、float64。 - - **other** （Tensor）：第二个输入的 `Tensor`，数据类型为：float32、float64。 - - **label** （Tensor）：训练数据的标签，数据类型为：float32, float64。 - - **margin** （float，可选）： - 用于加和的margin值，默认值为0。 - - **reduction** （string，可选）： - 指定应用于输出结果的计算方式，可选值有：``'none'`` 、 ``'mean'`` 、 ``'sum'``。如果设置为 ``'none'``，则直接返回 最原始的 ``margin_rank_loss``。如果设置为 ``'sum'``，则返回 ``margin_rank_loss`` 的总和。如果设置为 ``'mean'``，则返回 ``margin_rank_loss`` 的平均值。默认值为 ``'none'`` 。 + - **input** （Tensor） - 第一个输入的 `Tensor`，数据类型为：float32、float64。 + - **other** （Tensor） - 第二个输入的 `Tensor`，数据类型为：float32、float64。 + - **label** （Tensor） - 训练数据的标签，数据类型为：float32、float64。 + - **margin** （float，可选） - 用于加和的margin值，默认值为0。 + - **reduction** （string，可选） - 指定应用于输出结果的计算方式，可选值有：``'none'`` 、 ``'mean'`` 、 ``'sum'``。如果设置为 ``'none'``，则直接返回 最原始的 ``margin_rank_loss``。如果设置为 ``'sum'``，则返回 ``margin_rank_loss`` 的总和。如果设置为 ``'mean'``，则返回 ``margin_rank_loss`` 的平均值。默认值为 ``'none'`` 。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 返回 From 7d516c34c05cc6f9070c82931e28c1d352d02c17 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 3 Aug 2022 17:42:34 +0800 Subject: [PATCH 45/49] Update mse_loss_cn.rst --- docs/api/paddle/nn/functional/mse_loss_cn.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/api/paddle/nn/functional/mse_loss_cn.rst b/docs/api/paddle/nn/functional/mse_loss_cn.rst index bf4e0c51409..85d6b614c67 100644 --- a/docs/api/paddle/nn/functional/mse_loss_cn.rst +++ b/docs/api/paddle/nn/functional/mse_loss_cn.rst @@ -5,7 +5,7 @@ mse_loss .. py:function:: paddle.nn.functional.mse_loss(input, label, reduction='mean', name=None) -该OP用于计算预测值和目标值的均方差误差。 +用于计算预测值和目标值的均方差误差。 对于预测值input和目标值label，公式为： @@ -29,6 +29,11 @@ mse_loss ::::::::: - **input** (Tensor) - 预测值，维度为 :math:`[N_1, N_2, ..., N_k]` 的多维Tensor。数据类型为float32或float64。 - **label** (Tensor) - 目标值，维度为 :math:`[N_1, N_2, ..., N_k]` 的多维Tensor。数据类型为float32或float64。 + - **reduction** (string, optional) - 输出的归约方法可以是'none'、'mean'或'sum'。 + 如果 :attr:`reduction` 是 ``'mean'``，则返回减少的平均损失。 + 如果 :attr:`reduction` 是 ``'sum'``，则返回减少的总损失。 + 如果 :attr: `reduction` 为 `'none'`，返回未减少的损失。默认为 `'mean'`。 + - **name** (str, optional) - 操作的名称（可选，默认为None）。 更多信息请参考:ref:`api_guide_Name`。 返回 ::::::::: From 7cd5aaf8ed4ba89cfce10cd4d7ac22b450b53891 Mon Sep 17 00:00:00 2001 From: ReganYue <1131625869@qq.com> Date: Wed, 3 Aug 2022 17:50:42 +0800 Subject: [PATCH 46/49] update*test=document_fix --- docs/api/paddle/nn/functional/smooth_l1_loss_cn.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/api/paddle/nn/functional/smooth_l1_loss_cn.rst b/docs/api/paddle/nn/functional/smooth_l1_loss_cn.rst index 3e6cd8681a5..3092ebefb94 100644 --- a/docs/api/paddle/nn/functional/smooth_l1_loss_cn.rst +++ b/docs/api/paddle/nn/functional/smooth_l1_loss_cn.rst @@ -5,8 +5,8 @@ smooth_l1_loss .. py:function:: paddle.nn.functional.smooth_l1_loss(input, label, reduction='mean', delta=1.0, name=None) -计算输入input和标签label间的SmoothL1损失，如果逐个元素的绝对误差低于1，则创建使用平方项的条件 -，否则为L1损失。在某些情况下，它可以防止爆炸梯度，也称为Huber损失，该损失函数的数学计算公式如下： +计算输入input和标签label间的SmoothL1损失，如果逐个元素的绝对误差低于1，则创建使用平方项的条件， +否则为L1损失。在某些情况下，它可以防止爆炸梯度，也称为Huber损失，该损失函数的数学计算公式如下： .. math:: loss(x,y) = \frac{1}{n}\sum_{i}z_i @@ -22,10 +22,10 @@ smooth_l1_loss 参数 :::::::::: - - **input** (Tensor)：输入 `Tensor`，数据类型为float32。其形状为 :math:`[N, C]`，其中 `C` 为类别数。对于多维度的情形下，它的形状为 :math:`[N, C, d_1, d_2, ..., d_k]`，k >= 1。 - - **label** (Tensor)：输入input对应的标签值，数据类型为float32。数据类型和input相同。 - - **reduction** (string，可选): - 指定应用于输出结果的计算方式，数据类型为string，可选值有：`none`, `mean`, `sum`。默认为 `mean`，计算`mini-batch` loss均值。设置为 `sum` 时，计算 `mini-batch` loss的总和。设置为 `none` 时，则返回loss Tensor。 - - **delta** (string，可选): SmoothL1Loss损失的阈值参数，用于控制Huber损失对线性误差或平方误差的侧重。数据类型为float32。默认值= 1.0。 + - **input** (Tensor) - 输入 `Tensor`，数据类型为float32。其形状为 :math:`[N, C]`，其中 `C` 为类别数。对于多维度的情形下，它的形状为 :math:`[N, C, d_1, d_2, ..., d_k]`，k >= 1。 + - **label** (Tensor) - 输入input对应的标签值，数据类型为float32。数据类型和input相同。 + - **reduction** (string，可选) - 指定应用于输出结果的计算方式，数据类型为string，可选值有：`none`, `mean`, `sum`。默认为 `mean`，计算`mini-batch` loss均值。设置为 `sum` 时，计算 `mini-batch` loss的总和。设置为 `none` 时，则返回loss Tensor。 + - **delta** (string，可选) - SmoothL1Loss损失的阈值参数，用于控制Huber损失对线性误差或平方误差的侧重。数据类型为float32。默认值= 1.0。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 From 7e95631e5eae1ea3f892f8d1f14335352d499305 Mon Sep 17 00:00:00 2001 From: Ligoml <39876205+Ligoml@users.noreply.github.com> Date: Wed, 3 Aug 2022 20:03:02 +0800 Subject: [PATCH 47/49] Update margin_ranking_loss_cn.rst --- .../paddle/nn/functional/margin_ranking_loss_cn.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/api/paddle/nn/functional/margin_ranking_loss_cn.rst b/docs/api/paddle/nn/functional/margin_ranking_loss_cn.rst index 262bfceaf68..f0e3ca13a88 100644 --- a/docs/api/paddle/nn/functional/margin_ranking_loss_cn.rst +++ b/docs/api/paddle/nn/functional/margin_ranking_loss_cn.rst @@ -24,11 +24,11 @@ margin_ranking_loss 参数 :::::::: - - **input** （Tensor） - 第一个输入的 `Tensor`，数据类型为：float32、float64。 - - **other** （Tensor） - 第二个输入的 `Tensor`，数据类型为：float32、float64。 - - **label** （Tensor） - 训练数据的标签，数据类型为：float32、float64。 - - **margin** （float，可选） - 用于加和的margin值，默认值为0。 - - **reduction** （string，可选） - 指定应用于输出结果的计算方式，可选值有：``'none'`` 、 ``'mean'`` 、 ``'sum'``。如果设置为 ``'none'``，则直接返回 最原始的 ``margin_rank_loss``。如果设置为 ``'sum'``，则返回 ``margin_rank_loss`` 的总和。如果设置为 ``'mean'``，则返回 ``margin_rank_loss`` 的平均值。默认值为 ``'none'`` 。 + - **input** (Tensor) - 第一个输入的 `Tensor`，数据类型为：float32、float64。 + - **other** (Tensor) - 第二个输入的 `Tensor`，数据类型为：float32、float64。 + - **label** (Tensor) - 训练数据的标签，数据类型为：float32、float64。 + - **margin** (float，可选) - 用于加和的margin值，默认值为0。 + - **reduction** (string，可选) - 指定应用于输出结果的计算方式，可选值有：``'none'`` 、 ``'mean'`` 、 ``'sum'``。如果设置为 ``'none'``，则直接返回 最原始的 ``margin_rank_loss``。如果设置为 ``'sum'``，则返回 ``margin_rank_loss`` 的总和。如果设置为 ``'mean'``，则返回 ``margin_rank_loss`` 的平均值。默认值为 ``'none'`` 。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 返回 @@ -38,4 +38,4 @@ Tensor，如果 :attr:`reduction` 为 ``'sum'`` 或者是 ``'mean'``，则形状 代码示例 :::::::: -COPY-FROM: paddle.nn.functional.margin_ranking_loss \ No newline at end of file +COPY-FROM: paddle.nn.functional.margin_ranking_loss From 92adaaec0afb1fb8c375f9cc7c8f5a716d732c81 Mon Sep 17 00:00:00 2001 From: Ligoml <39876205+Ligoml@users.noreply.github.com> Date: Wed, 3 Aug 2022 20:16:16 +0800 Subject: [PATCH 48/49] Update crop_cn.rst --- docs/api/paddle/crop_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/crop_cn.rst b/docs/api/paddle/crop_cn.rst index 2e1aca66116..762ef6bc591 100644 --- a/docs/api/paddle/crop_cn.rst +++ b/docs/api/paddle/crop_cn.rst @@ -58,7 +58,7 @@ crop ::::::::: - **x** (Tensor) - 1-D到6-D Tensor，数据类型为float32、float64、int32或者int64。 - - **shape** (list|tuple|Tensor) - 输出Tensor的形状，数据类型为int32。如果是列表或元组，则其长度必须与x的维度大小相同，如果是Tensor，则其应该是1-D Tensor。当它是列表时，每一个元素可以是整数或者形状为[1]的Tensor。含有Variable的方式适用于每次迭代时需要改变输出形状的情况。 + - **shape** (list|tuple|Tensor，可选) - 输出Tensor的形状，数据类型为int32。如果是列表或元组，则其长度必须与x的维度大小相同，如果是Tensor，则其应该是1-D Tensor。当它是列表时，每一个元素可以是整数或者形状为[1]的Tensor。含有Variable的方式适用于每次迭代时需要改变输出形状的情况。 - **offsets** (list|tuple|Tensor，可选) - 每个维度上裁剪的偏移量，数据类型为int32。如果是列表或元组，则其长度必须与x的维度大小相同，如果是Tensor，则其应是1-D Tensor。当它是列表时，每一个元素可以是整数或者形状为[1]的Variable。含有Variable的方式适用于每次迭代的偏移量（offset）都可能改变的情况。默认值：None，每个维度的偏移量为0。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 From 127c20a4b49dcc8460a5b2c6b261efda43e4aa34 Mon Sep 17 00:00:00 2001 From: Ligoml <39876205+Ligoml@users.noreply.github.com> Date: Wed, 3 Aug 2022 21:25:07 +0800 Subject: [PATCH 49/49] Update mse_loss_cn.rst --- docs/api/paddle/nn/functional/mse_loss_cn.rst | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/api/paddle/nn/functional/mse_loss_cn.rst b/docs/api/paddle/nn/functional/mse_loss_cn.rst index 85d6b614c67..b4123e93c96 100644 --- a/docs/api/paddle/nn/functional/mse_loss_cn.rst +++ b/docs/api/paddle/nn/functional/mse_loss_cn.rst @@ -30,9 +30,11 @@ mse_loss - **input** (Tensor) - 预测值，维度为 :math:`[N_1, N_2, ..., N_k]` 的多维Tensor。数据类型为float32或float64。 - **label** (Tensor) - 目标值，维度为 :math:`[N_1, N_2, ..., N_k]` 的多维Tensor。数据类型为float32或float64。 - **reduction** (string, optional) - 输出的归约方法可以是'none'、'mean'或'sum'。 - 如果 :attr:`reduction` 是 ``'mean'``，则返回减少的平均损失。 - 如果 :attr:`reduction` 是 ``'sum'``，则返回减少的总损失。 - 如果 :attr: `reduction` 为 `'none'`，返回未减少的损失。默认为 `'mean'`。 + + - 如果 :attr:`reduction` 是 ``'mean'``，则返回减少的平均损失。 + - 如果 :attr:`reduction` 是 ``'sum'``，则返回减少的总损失。 + - 如果 :attr: `reduction` 为 `'none'`，返回未减少的损失。默认为 `'mean'`。 + - **name** (str, optional) - 操作的名称（可选，默认为None）。 更多信息请参考:ref:`api_guide_Name`。 返回 @@ -42,4 +44,4 @@ mse_loss 代码示例 ::::::::: -COPY-FROM: paddle.nn.functional.mse_loss \ No newline at end of file +COPY-FROM: paddle.nn.functional.mse_loss