From 299e50179564b82f1183e9feba82c442bf98d2d5 Mon Sep 17 00:00:00 2001 From: Infinity_lee Date: Tue, 1 Nov 2022 19:29:25 +0800 Subject: [PATCH 1/8] fix some word errors (#5383) fix some word errors --- docs/guides/beginner/tensor_cn.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/guides/beginner/tensor_cn.md b/docs/guides/beginner/tensor_cn.md index 0971ad53e6e..00b3a0f931b 100644 --- a/docs/guides/beginner/tensor_cn.md +++ b/docs/guides/beginner/tensor_cn.md @@ -331,7 +331,7 @@ Tensor flattened to Vector: [1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 1 > * [paddle.squeeze](../../../api/paddle/squeeze_cn.html)，可实现 Tensor 的降维操作，即把 Tensor 中尺寸为 1 的维度删除。 > * [paddle.unsqueeze](../../../api/paddle/unsqueeze_cn.html)，可实现 Tensor 的升维操作，即向 Tensor 中某个位置插入尺寸为 1 的维度。 > * [paddle.flatten](../../../api/paddle/flatten_cn.html)，将 Tensor 的数据在指定的连续维度上展平。 -> * [transpose](../../../api/paddle/transpose_cn.html)，对 Tensor 的数据进行重排。 +> * [paddle.transpose](../../../api/paddle/transpose_cn.html)，对 Tensor 的数据进行重排。 **（3）原位（Inplace）操作和非原位操作的区别** @@ -545,7 +545,7 @@ Tensor(shape=[4], dtype=int64, place=Place(gpu:0), stop_gradient=True, #### 4.1.2 修改 Tensor -与访问 Tensor 类似，修改 Tensor 可以在单个或多个维度上通过索引或切片操作。同时，支持将多种类型的数据赋值给该 Tensor，当前支持的数据类型有：`int`，`float`，`numpy.ndarray`，`omplex`，`Tensor`。 +与访问 Tensor 类似，修改 Tensor 可以在单个或多个维度上通过索引或切片操作。同时，支持将多种类型的数据赋值给该 Tensor，当前支持的数据类型有：`int`，`float`，`numpy.ndarray`，`complex`，`Tensor`。 > **注意：** > > 请慎重通过索引或切片修改 Tensor，该操作会**原地**修改该 Tensor 的数值，且原值不会被保存。如果被修改的 Tensor 参与梯度计算，仅会使用修改后的数值，这可能会给梯度计算引入风险。飞桨框架会自动检测不当的原位（inplace）使用并报错。 @@ -673,7 +673,7 @@ x.matmul(y) #矩阵乘法 飞桨框架提供的一些 API 支持广播（broadcasting）机制，允许在一些运算时使用不同形状的 Tensor。 飞桨 Tensor 的广播机制主要遵循如下规则（参考 [Numpy 广播机制](https://numpy.org/doc/stable/user/basics.broadcasting.html#module-numpy.doc.broadcasting)）： -* 每个 Tensor 至少为一维 Tensor +* 每个 Tensor 至少为一维 Tensor。 * 从最后一个维度向前开始比较两个 Tensor 的形状，需要满足如下条件才能进行广播：两个 Tensor 的维度大小相等；或者其中一个 Tensor 的维度等于 1；或者其中一个 Tensor 的维度不存在。 举例如下： From 799128b48134cd038c8312f8202779c64f3cd1c9 Mon Sep 17 00:00:00 2001 From: Infinity_lee Date: Tue, 1 Nov 2022 19:26:41 +0800 Subject: [PATCH 2/8] Update case_analysis_cn.md (#5210) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit fix __call__ and 控制流转写的links Co-authored-by: zachary sun <70642955+sunzhongkai588@users.noreply.github.com> --- docs/guides/jit/case_analysis_cn.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/guides/jit/case_analysis_cn.md b/docs/guides/jit/case_analysis_cn.md index fb152db33a8..8d6e44382cc 100644 --- a/docs/guides/jit/case_analysis_cn.md +++ b/docs/guides/jit/case_analysis_cn.md @@ -41,7 +41,7 @@ + 建议模型搭建时，尽量考虑将预测主逻辑放到 ``forward`` 函数中 + 将训练独有的逻辑放到 子函数 中，通过 ``if self.training`` 来控制 - + 最大程度抽离 训练和预测 的逻辑为 **公共子函数** + + 最大程度抽离 **训练和预测** 的逻辑为 **公共子函数** ## 二、何时指定 InputSpec? @@ -129,7 +129,7 @@ def forward(self, x): ## 四、to_tensor() 的使用 -``paddle.to_tensor()`` 接口是动态图模型代码中使用比较频繁的一个接口。 ``to_tensor`` 功能强大，将可以将一个 ``scalar`` ， ``list`` ，``tuple`` ， ``numpy.ndarray`` 转为 ``paddle.Tensor`` 类型。 +``paddle.to_tensor()`` 接口是动态图模型代码中使用比较频繁的一个接口。 ``to_tensor`` 功能强大，可以将一个 ``scalar`` ， ``list`` ，``tuple`` ， ``numpy.ndarray`` 转为 ``paddle.Tensor`` 类型。 此接口是动态图独有的接口，在动转静时，会转换为 ``assign`` 接口： @@ -191,7 +191,7 @@ class SimpleNet(paddle.nn.Layer): ## 五、 建议都继承 nn.Layer -动态图模型常常包含很多嵌套的子网络，建议各个自定义的子网络 ``sublayer`` **无论是否包含了参数，都继承 ``nn.Layer`` .** +动态图模型常常包含很多嵌套的子网络，建议各个自定义的子网络 ``sublayer`` **无论是否包含了参数，都继承 ``nn.Layer`` **。 从 **Parameters 和 Buffers** 章节可知，有些 ``paddle.to_tensor`` 接口转来的 ``Tensor`` 也可能参与预测逻辑分支的计算，即模型导出时，也需要作为参数序列化保存到 ``.pdiparams`` 文件中。 From 8274b83c0e50b9bbaba6be821b8fdd07d6308b5e Mon Sep 17 00:00:00 2001 From: Infinity_lee Date: Mon, 31 Oct 2022 11:15:37 +0800 Subject: [PATCH 3/8] fix error add links (#5386) fix error add links --- docs/guides/advanced/autograd_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/advanced/autograd_cn.rst b/docs/guides/advanced/autograd_cn.rst index 01326d4e6e0..f02a71d2f10 100644 --- a/docs/guides/advanced/autograd_cn.rst +++ b/docs/guides/advanced/autograd_cn.rst @@ -38,7 +38,7 @@ PaddlePaddle 的神经网络核心是自动微分，本篇文章主要为你介 2.2.0 -本案例首先定义网络。因为本示例着重展示如何使用飞桨进行自动微分，故组网部分不过多展开，直接使用高层 API 中封装好的模型\ ``vgg11``\ 。 +本案例首先定义网络。因为本示例着重展示如何使用飞桨进行自动微分，故组网部分不过多展开，直接使用高层 API 中封装好的模型 :ref:`paddle.vision.models ` 。 然后随机初始化一个输入\ ``x``\ ，和对应标签\ ``label``\ 。 From 9c1df064a043a192951ffbd114a9c92334e69516 Mon Sep 17 00:00:00 2001 From: Nyakku Shigure Date: Mon, 24 Oct 2022 11:41:59 +0800 Subject: [PATCH 4/8] fix method parameters in guidelines (#5284) --- .../api_contributing_guides/api_docs_guidelines_cn.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/dev_guides/api_contributing_guides/api_docs_guidelines_cn.md b/docs/dev_guides/api_contributing_guides/api_docs_guidelines_cn.md index 46a0a4c30b3..d8d98e82f1e 100644 --- a/docs/dev_guides/api_contributing_guides/api_docs_guidelines_cn.md +++ b/docs/dev_guides/api_contributing_guides/api_docs_guidelines_cn.md @@ -311,6 +311,7 @@ API 的属性用来描述 API 所包含的属性。如果 API 有属性，每个 程序中随机运算符的默认随机种子。0 意味着随机生成随机种子。 **返回** + int64，返回该 Program 中当前正在使用的 random seed。 **代码示例** @@ -335,12 +336,15 @@ API 的方法用来描述 API 所包含的方法，一些类的 API 会有这个 '''''''''''' .. py:function:: paddle.Program.parse_from_string(binary_str_type) + 通过对 protobuf 的反序列化，转换成 ``Program`` **参数** - binary_str_type (**str**) – protobuf 二进制字符串 + + - **binary_str_type** (str) – protobuf 二进制字符串 **返回** + ``Program``，反序列化后的 ``Program`` **代码示例** From 438efe204cede149ce72446f0469694bc1ff152b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=B6=85=E7=BA=A7=E7=A0=81=E7=89=9B?= <54444805+SuperCodebull@users.noreply.github.com> Date: Tue, 1 Nov 2022 15:25:02 +0800 Subject: [PATCH 5/8] fix paddle.dist,paddle.roll,paddle.nonzero (#5365) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Update dist_cn.rst 把参数从：改成正确的- * Update dist_cn.rst * Update roll_cn.rst * Update nonzero_cn.rst * fix paddle.meshgrid文档评估 #4417内的标点问题 * Update meshgrid_cn.rst * Update docs/api/paddle/dist_cn.rst Co-authored-by: 张春乔 <83450930+Liyulingyue@users.noreply.github.com> * Update docs/api/paddle/nonzero_cn.rst Co-authored-by: 张春乔 <83450930+Liyulingyue@users.noreply.github.com> * help * Update nonzero_cn.rst * Update matmul_cn.rst Co-authored-by: Ligoml <39876205+Ligoml@users.noreply.github.com> Co-authored-by: 张春乔 <83450930+Liyulingyue@users.noreply.github.com> --- docs/api/paddle/dist_cn.rst | 9 ++++++--- docs/api/paddle/matmul_cn.rst | 8 ++++---- docs/api/paddle/meshgrid_cn.rst | 6 ++++-- docs/api/paddle/nonzero_cn.rst | 8 ++++++-- docs/api/paddle/roll_cn.rst | 4 +++- 5 files changed, 23 insertions(+), 12 deletions(-) diff --git a/docs/api/paddle/dist_cn.rst b/docs/api/paddle/dist_cn.rst index ae09e3cb863..1d9b09115d9 100644 --- a/docs/api/paddle/dist_cn.rst +++ b/docs/api/paddle/dist_cn.rst @@ -20,6 +20,7 @@ x (4-D Tensor): 8 x 1 x 6 x 1 y (4-D Tensor): 1 x 7 x 1 x 5 + (2) 确定输出 `z` 每一维度的大小：从两个输入的维度中选取最大值。 z (4-D Tensor): 8 x 7 x 6 x 5 @@ -49,9 +50,11 @@ z (4-D Tensor): 8 x 7 x 6 x 5 参数 :::::::::::: - - **x** (Tensor): 1-D 到 6-D Tensor，数据类型为 float32 或 float64。 - - **y** (Tensor): 1-D 到 6-D Tensor，数据类型为 float32 或 float64。 - - **p** (float，optional)：用于设置需要计算的范数，数据类型为 float32 或 float64。默认值为 2。 + - **x** (Tensor) - 1-D 到 6-D Tensor，数据类型为 float32 或 float64。 + - **y** (Tensor) - 1-D 到 6-D Tensor，数据类型为 float32 或 float64。 + - **p** (float，可选) - 用于设置需要计算的范数，数据类型为 float32 或 float64。默认值为 2。 + + 返回 :::::::::::: diff --git a/docs/api/paddle/matmul_cn.rst b/docs/api/paddle/matmul_cn.rst index 970b871e5c5..7eedfb7803d 100644 --- a/docs/api/paddle/matmul_cn.rst +++ b/docs/api/paddle/matmul_cn.rst @@ -26,10 +26,10 @@ matmul 参数 ::::::::: - - **x** (Tensor)：输入变量，类型为 Tensor，数据类型为 float32， float64。 - - **y** (Tensor)：输入变量，类型为 Tensor，数据类型为 float32， float64。 - - **transpose_x** (bool，可选)：相乘前是否转置 x，默认值为 False。 - - **transpose_y** (bool，可选)：相乘前是否转置 y，默认值为 False。 + - **x** (Tensor) - 输入变量，类型为 Tensor，数据类型为 float32， float64。 + - **y** (Tensor) - 输入变量，类型为 Tensor，数据类型为 float32， float64。 + - **transpose_x** (bool，可选) - 相乘前是否转置 x，默认值为 False。 + - **transpose_y** (bool，可选) - 相乘前是否转置 y，默认值为 False。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 返回 diff --git a/docs/api/paddle/meshgrid_cn.rst b/docs/api/paddle/meshgrid_cn.rst index b510cbfe9d8..628c124476b 100644 --- a/docs/api/paddle/meshgrid_cn.rst +++ b/docs/api/paddle/meshgrid_cn.rst @@ -8,14 +8,16 @@ meshgrid -对每个张量做扩充操作。输入是张量或者包含张量的列表，包含 k 个一维张量，输出 k 个 k 维张量。 +对每个 Tensor 做扩充操作。输入是 Tensor 或者包含 Tensor 的列表，包含 k 个一维 Tensor，输出 k 个 k 维 Tensor。 参数 :::::::::::: - - \* **args** （Tensor|Tensor 数组）- 输入变量为 k 个一维张量，形状分别为(N1,), (N2,), ..., (Nk, )。支持数据类型为 float32，float64，int32，int64。 + - \* **args** （Tensor|Tensor 数组）- 输入变量为 k 个一维 Tensor，形状分别为(N1,), (N2,), ..., (Nk, )。支持数据类型为 float32、float64、int32 和 int64。 - ** **kargs** （可选）- 目前只接受 name 参数（str），具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 + + 返回 :::::::::::: diff --git a/docs/api/paddle/nonzero_cn.rst b/docs/api/paddle/nonzero_cn.rst index 479207eedf6..6fe88580760 100644 --- a/docs/api/paddle/nonzero_cn.rst +++ b/docs/api/paddle/nonzero_cn.rst @@ -15,13 +15,17 @@ nonzero 参数 ::::::::: - - **x** （Tensor）– 输入张量。 - - **as_tuple** (bool, optinal) - 返回格式。是否以 ``1-D Tensor`` 构成的元组格式返回。 + - **x** （Tensor）– 输入的 Tensor。 + - **as_tuple** (bool，可选) - 返回格式。是否以 ``1-D Tensor`` 构成的元组格式返回。 + + 返回 ::::::::: - **Tensor or tuple(1-D Tensor)**，数据类型为 **INT64** 。 + + 代码示例 ::::::::: diff --git a/docs/api/paddle/roll_cn.rst b/docs/api/paddle/roll_cn.rst index 84057c557e8..971499a2147 100644 --- a/docs/api/paddle/roll_cn.rst +++ b/docs/api/paddle/roll_cn.rst @@ -15,9 +15,11 @@ roll - **x** （Tensor）– 输入的 Tensor。 - **shifts** (int|list|tuple) - 滚动位移。如果 ``shifts`` 是一个元组或者列表，则 ``axis`` 必须是相同大小的元组或者列表，输入张量将依次沿着每个维度滚动相应的数值。 - - **axis** (int|list|tuple, optinal) – 滚动轴。默认值为 None。 + - **axis** (int|list|tuple，可选) – 滚动轴。默认值为 None。 - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。 + + 返回 ::::::::: From 7ddb947fec09805a65bea6416a26618975d5f25d Mon Sep 17 00:00:00 2001 From: Amberain Date: Tue, 1 Nov 2022 11:10:17 +0800 Subject: [PATCH 6/8] xpu update (#5372) --- .../xpu_docs/paddle_2.0_xpu2_cn.md | 84 ++++++++++++++----- 1 file changed, 61 insertions(+), 23 deletions(-) diff --git a/docs/guides/hardware_support/xpu_docs/paddle_2.0_xpu2_cn.md b/docs/guides/hardware_support/xpu_docs/paddle_2.0_xpu2_cn.md index 8ffb3b5a91a..18e8b2bbccd 100644 --- a/docs/guides/hardware_support/xpu_docs/paddle_2.0_xpu2_cn.md +++ b/docs/guides/hardware_support/xpu_docs/paddle_2.0_xpu2_cn.md @@ -1,26 +1,66 @@ -# 飞桨对昆仑 2 代芯片的支持 +# 飞桨对昆仑芯 2 代芯片的支持 -飞桨自 2.3rc 版本起支持在昆仑 2 代芯片上（R200，R300）运行，经验证的模型训练的支持情况如下： +飞桨自 2.4rc 版本起支持在昆仑芯 2 代芯片上（R200，R300，R200-8F，R200-8FS，RG800）运行，经验证的模型训练的支持情况如下： ## 训练支持 可进行单机单卡/单机多卡训练的模型，如下所示： -| 模型 | 领域 | 编程范式 | 可用的 CPU 类型 | 单机单卡支持 | 单机多卡支持 | -| ------------------ | -------- |------------- | ----------------------- | -------------- | -------------- | -| ResNet50 | 图像分类 | 动态图 | X86（Intel） | 支持 |- | -| MobileNet_v3 | 图像分类 | 动态图 | X86（Intel） | 支持 |- | -| UNet | 图像分割 | 动态图 | X86（Intel） | 支持 |- | -| Yolov3-DarkNet53 | 目标检测 | 动态图 | X86（Intel） | 支持 |- | -| SSD-ResNet34 | 目标检测 | 动态图 | X86（Intel） | 支持 |支持 | -| OCR-DB | 文字检测 | 动态图 | X86（Intel） | 支持 |- | -| Bert-Base | NLP | 静态图 | X86（Intel） | 支持 |支持 | -| Transformer | NLP | 静态图 | X86（Intel） | 支持 |支持 | -| GPT-2 | NLP | 动态图 | X86（Intel） | 支持 |- | -| DeepFM | 推荐 | 动态图 | X86（Intel） | 支持 |- | -| Wide&Deep | 推荐 | 动态图 | X86（Intel） | 支持 |- | - - +| 模型 | 领域 | 编程范式 | 可用的 CPU 类型 | 单机单卡支持 | 单机多卡支持 | +| --- | --- | --- | --- | --- | --- | +| ResNet50 | 图像分类 | 动态图 | X86（Intel） | 支持 | - | +| ResNet101 | 图像分类 | 动态图 | X86（Intel） | 支持 | - | +| MobileNet_v3 | 图像分类 | 动态图 | X86（Intel） | 支持 | - | +| MobileNetV2 | 图像分类 | 动态图 | X86（Intel） | 支持 | - | +| VGG19 | 图像分类 | 动态图 | X86（Intel） | 支持 | - | +| VGG16 | 图像分类 | 动态图 | X86（Intel） | 支持 | - | +| PP-LCNet | 图像分类 | 动态图 | X86（Intel） | 支持 | - | +| PP-HGNet | 图像分类 | 动态图 | X86（Intel） | 支持 | - | +| InceptionV4 | 图像分类 | 动态图 | X86（Intel） | 支持 | - | +| UNet | 图像分割 | 动态图 | X86（Intel） | 支持 | - | +| deeplabv3 | 图像分割 | 动态图 | X86（Intel） | 支持 | - | +| HRNet | 图像分割 | 动态图 | X86（Intel） | 支持 | - | +| PP-LiteSeq | 图像分割 | 动态图 | X86（Intel） | 支持 | - | +| PP-humansegv2 | 图像分割 | 动态图 | X86（Intel） | 支持 | - | +| PP-mating | 图像分割 | 动态图 | X86（Intel） | 支持 | - | +| MaskRcnn | 目标检测 | 动态图 | X86（Intel） | 支持 | - | +| FasterRcnn | 目标检测 | 动态图 | X86（Intel） | 支持 | - | +| fairmot | 目标检测 | 动态图 | X86（Intel） | 支持 | - | +| Yolov3-DarkNet53 | 目标检测 | 动态图 | X86（Intel） | 支持 | - | +| SSD-ResNet34 | 目标检测 | 动态图 | X86（Intel） | 支持 | 支持 | +| Yolov3-mobileNetv1 | 目标检测 | 动态图 | X86（Intel） | 支持 | - | +| PPYoloE | 目标检测 | 动态图 | X86（Intel） | 支持 | - | +| deepsort | 目标检测 | 动态图 | X86（Intel） | 支持 | - | +| ssd-mv1 | 目标检测 | 动态图 | X86（Intel） | 支持 | - | +| ssd-vgg16 | 目标检测 | 动态图 | X86（Intel） | 支持 | - | +| PP-picoDet | 目标检测 | 动态图 | X86（Intel） | 支持 | - | +| PPYolov2 | 目标检测 | 动态图 | X86（Intel） | 支持 | - | +| OCR-DB | 文字检测 | 动态图 | X86（Intel） | 支持 | - | +| OCR-crnn | 文字检测 | 动态图 | X86（Intel） | 支持 | - | +| PPOCR-v2 | 文字检测 | 动态图 | X86（Intel） | 支持 | - | +| PPOCR-v3 | 文字检测 | 动态图 | X86（Intel） | 支持 | - | +| Bert-Base | NLP | 静态图 | X86（Intel） | 支持 | 支持 | +| Transformer | NLP | 静态图 | X86（Intel） | 支持 | 支持 | +| GPT-2 | NLP | 动态图 | X86（Intel） | 支持 | - | +| ernie-base | NLP | 动态图 | X86（Intel） | 支持 | - | +| ernie 3.0 medium | NLP | 动态图 | X86（Intel） | 支持 | - | +| lstm | NLP | 动态图 | X86（Intel） | 支持 | - | +| seq2seq | NLP | 动态图 | X86（Intel） | 支持 | - | +| DeepFM | 推荐 | 动态图 | X86（Intel） | 支持 | - | +| Wide&Deep | 推荐 | 动态图 | X86（Intel） | 支持 | - | +| dlrm | 推荐 | 动态图 | X86（Intel） | 支持 | - | +| deepspeech2 | 语音识别 | 动态图 | X86（Intel） | 支持 | - | +| speedyspeech | 语音合成 | 动态图 | X86（Intel） | 支持 | - | +| dqn | 强化学习 | 动态图 | X86（Intel） | 支持 | - | +| ppo | 强化学习 | 动态图 | X86（Intel） | 支持 | - | +| ddpg | 强化学习 | 动态图 | X86（Intel） | 支持 | - | +| A2C | 强化学习 | 动态图 | X86（Intel） | 支持 | - | +| TD3 | 强化学习 | 动态图 | X86（Intel） | 支持 | - | +| SAC | 强化学习 | 动态图 | X86（Intel） | 支持 | - | +| MADDPG | 强化学习 | 动态图 | X86（Intel） | 支持 | - | +| CQL | 强化学习 | 动态图 | X86（Intel） | 支持 | - | +| ES | 强化学习 | 动态图 | X86（Intel） | 支持 | - | +| pp-tsm | 视频分类 | 动态图 | X86（Intel） | 支持 | - | 模型放置在飞桨模型套件中，作为 github.com/PaddlePaddle 下的独立 repo 存在，git clone 下载即可获取所需的模型文件： @@ -28,9 +68,7 @@ | -------- | --------------- | ----------- | | 图像分类 | [PaddleClas](https://github.com/PaddlePaddle/PaddleClas) | [develop](https://github.com/PaddlePaddle/PaddleClas/tree/develop) | | 目标检测 | [PaddleDetection](https://github.com/PaddlePaddle/PaddleDetection) | [develop](https://github.com/PaddlePaddle/PaddleDetection/tree/develop) | -| 图像分割 | [PaddleSeg](https://github.com/PaddlePaddle/PaddleSeg) | [develop](https://github.com/PaddlePaddle/PaddleSeg/tree/develop) | -| NLP | [PaddleNLP](https://github.com/PaddlePaddle/PaddleNLP) | [develop](https://github.com/PaddlePaddle/PaddleNLP/tree/develop) | -| OCR | [PaddleOCR](https://github.com/PaddlePaddle/PaddleOCR) | [dygraph](https://github.com/PaddlePaddle/PaddleOCR/tree/dygraph) | -| 推荐 | [PaddleREC](https://github.com/PaddlePaddle/PaddleRec) | [master](https://github.com/PaddlePaddle/PaddleRec/tree/master) | - -* 注：支持基于 Kermel Primitive 算子的昆仑 2 代芯片支持，[点击这里](https://www.paddlepaddle.org.cn/documentation/docs/zh/guides/07_new_op/kernel_primitive_api/index_cn.html)。 +| 图像分割 | [PaddleSeg](https://github.com/PaddlePaddle/PaddleSeg) | [develop](https://github.com/PaddlePaddle/PaddleSeg/tree/develop) | +| NLP | [PaddleNLP](https://github.com/PaddlePaddle/PaddleNLP) | [develop](https://github.com/PaddlePaddle/PaddleNLP/tree/develop) | +| OCR | [PaddleOCR](https://github.com/PaddlePaddle/PaddleOCR) | [dygraph](https://github.com/PaddlePaddle/PaddleOCR/tree/dygraph) | +| 推荐 | [PaddleREC](https://github.com/PaddlePaddle/PaddleRec) | [master](https://github.com/PaddlePaddle/PaddleRec/tree/master) | From 89b788b3bc07c01895df3df22359ca48cef57323 Mon Sep 17 00:00:00 2001 From: gouzil <66515297+gouzil@users.noreply.github.com> Date: Sun, 9 Oct 2022 16:07:38 +0800 Subject: [PATCH 7/8] [docs] fix paddle.CUDAPlace Parameter error (#5261) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * rm unnecessary pronouns * Update basic_usage_cn.md * rm Macos GPU docker * Update macos-docker_en.md * Update macos-docker.md * rm unnecessary pronouns * Update grammar_list_cn.md * fix format * Update case_analysis_cn.md * add GPU architecture comparison table link * Update windows-pip.md * Update windows-pip_en.md * Update linux-pip.md * Update linux-pip_en.md * fix format docs * fix url lose * [docs] fix paddle.CUDAPlace Parameter error * Update CUDAPlace_cn.rst * [docs] fix Synchronous English documentation * Update take_along_axis_cn.rst * [dosc] Supplementary index description: * ipu_shard_guard_cn.rst * set_ipu_shard_cn.rst Modify note Format: * mlu_places_cn.rst * [docs] fix note、returns format * fix put_along_axis_cn.rst returns format * fix ipu_shard_guard_cn.rst note format * fix mlu_places_cn.rst note format * fix set_ipu_shard_cn.rst note format --- docs/api/paddle/CUDAPlace_cn.rst | 2 +- docs/api/paddle/put_along_axis_cn.rst | 2 +- docs/api/paddle/static/ipu_shard_guard_cn.rst | 9 ++++----- docs/api/paddle/static/mlu_places_cn.rst | 12 ++++++------ docs/api/paddle/static/set_ipu_shard_cn.rst | 11 +++++------ docs/api/paddle/take_along_axis_cn.rst | 2 +- 6 files changed, 18 insertions(+), 20 deletions(-) diff --git a/docs/api/paddle/CUDAPlace_cn.rst b/docs/api/paddle/CUDAPlace_cn.rst index 077a4f1a24d..d140de5e6a9 100644 --- a/docs/api/paddle/CUDAPlace_cn.rst +++ b/docs/api/paddle/CUDAPlace_cn.rst @@ -19,7 +19,7 @@ CUDAPlace 参数 :::::::::::: - - **id** (int，可选) - GPU 的设备 ID。如果为 ``None``，则默认会使用 id 为 0 的设备。默认值为 ``None``。 + - **id** (int) - GPU 的设备 ID。 代码示例 :::::::::::: diff --git a/docs/api/paddle/put_along_axis_cn.rst b/docs/api/paddle/put_along_axis_cn.rst index 3004da5beb8..d7df131c8b8 100644 --- a/docs/api/paddle/put_along_axis_cn.rst +++ b/docs/api/paddle/put_along_axis_cn.rst @@ -18,7 +18,7 @@ put_along_axis 返回 ::::::::: -- **out** (Tensor) - 输出 Tensor，indeces 矩阵选定的下标会被插入 value，与 ``arr`` 数据类型相同。 +输出 Tensor，indeces 矩阵选定的下标会被插入 value，与 ``arr`` 数据类型相同。 代码示例 ::::::::: diff --git a/docs/api/paddle/static/ipu_shard_guard_cn.rst b/docs/api/paddle/static/ipu_shard_guard_cn.rst index 94a90546bfe..0351c9f9719 100644 --- a/docs/api/paddle/static/ipu_shard_guard_cn.rst +++ b/docs/api/paddle/static/ipu_shard_guard_cn.rst @@ -9,15 +9,14 @@ ipu_shard_guard 对模型进行切分。用于指定 Op 在哪个 ipu 上进行计算以及模型被切分之后的计算顺序。 .. note:: - - 仅支持当 enable_manual_shard=True，index 设置才有效。请参阅 :ref:`cn_api_fluid_IpuStrategy` 。 - 仅支持当 enable_pipelining=True，stage 设置才有效。请参阅 :ref:`cn_api_fluid_IpuStrategy` 。 + 仅支持当 enable_manual_shard=True，才能将 index 设置为非-1 的值。请参阅 :ref:`cn_api_fluid_IpuStrategy` 。 + 仅支持当 enable_pipelining=True，才能将 stage 设置为非-1 的值。请参阅 :ref:`cn_api_fluid_IpuStrategy` 。 一个 index 支持对应 None stage 或一个 stage，一个 stage 仅支持对应一个新的 index 或者一个重复的 index。 参数 ::::::::: - - **index** (int，可选) - 指定 Op 在哪个 ipu 上计算，（如‘0, 1, 2, 3’），默认值-1，表示 Op 没有指定 ipu。 - - **stage** (int，可选) – 指定被切分的模型的计算顺序，（如‘0, 1, 2, 3’），按照数值大小顺序对被切分的模型进行计算，默认值-1，表示没有数据流水计算顺序并按照计算图顺序计算 Op。 + - **index** (int，可选) - 指定 Op 在哪个 ipu 上计算，（如‘0, 1, 2, 3’），默认值-1，表示 Op 仅在 ipu 0 上运行。 + - **stage** (int，可选) - 指定被切分的模型的计算顺序，（如‘0, 1, 2, 3’），按照数值大小顺序对被切分的模型进行计算，默认值-1，表示没有数据流水计算顺序并按照计算图顺序计算 Op。 返回 ::::::::: diff --git a/docs/api/paddle/static/mlu_places_cn.rst b/docs/api/paddle/static/mlu_places_cn.rst index eb7d4a4487f..789af734130 100644 --- a/docs/api/paddle/static/mlu_places_cn.rst +++ b/docs/api/paddle/static/mlu_places_cn.rst @@ -5,19 +5,19 @@ mlu_places .. py:function:: paddle.static.mlu_places(device_ids=None) - -.. note:: - 多卡任务请先使用 FLAGS_selected_mlus 环境变量设置可见的 MLU 设备。 - 该接口根据 ``device_ids`` 创建一个或多个 ``paddle.device.MLUPlace`` 对象，并返回所创建的对象列表。 -如果 ``device_ids`` 为 ``None``，则首先检查 ``FLAGS_selected_mlus`` 标志。 +如果 ``device_ids`` 为 ``None``，则首先检查 ``FLAGS_selected_mlus`` 环境变量。 例如：``FLAGS_selected_mlus=0,1,2``，则返回的列表将为 ``[paddle.device.MLUPlace(0), paddle.device.MLUPlace(1), paddle.device.MLUPlace(2)]``。 -如果未设置标志 ``FLAGS_selected_mlus``，则返回所有可见的 MLU places。 + +如果未设置环境变量 ``FLAGS_selected_mlus``，则返回所有可见的 MLU 位置。 如果 ``device_ids`` 不是 ``None``，它应该是使用的 MLU 设备 ID 的列表或元组。 例如：``device_id=[0,1,2]``，返回的列表将是 ``[paddle.device.MLUPlace(0), paddle.device.MLUPlace(1), paddle.device.MLUPlace(2)]``。 +.. note:: + 多卡任务请先使用 FLAGS_selected_mlus 环境变量设置可见的 MLU 设备。 + 参数 ::::::::: - **device_ids** (list(int)|tuple(int)，可选) - MLU 的设备 ID 列表或元组。默认值为 ``None``。 diff --git a/docs/api/paddle/static/set_ipu_shard_cn.rst b/docs/api/paddle/static/set_ipu_shard_cn.rst index 404a9c313a7..c18d5f07fde 100644 --- a/docs/api/paddle/static/set_ipu_shard_cn.rst +++ b/docs/api/paddle/static/set_ipu_shard_cn.rst @@ -9,20 +9,19 @@ set_ipu_shard 通过设置输入的函数或计算层内每个算子的流水线属性实现对模型的切分。 .. note:: - - 仅支持当 enable_manual_shard=True，index 设置才有效。请参阅 :ref:`cn_api_fluid_IpuStrategy` 。 - 仅支持当 enable_pipelining=True，stage 设置才有效。请参阅 :ref:`cn_api_fluid_IpuStrategy` 。 + 仅支持当 enable_manual_shard=True，才能将 index 设置为非-1 的值。请参阅 :ref:`cn_api_fluid_IpuStrategy` 。 + 仅支持当 enable_pipelining=True，才能将 stage 设置为非-1 的值。请参阅 :ref:`cn_api_fluid_IpuStrategy` 。 一个 index 支持对应 None stage 或一个 stage，一个 stage 仅支持对应一个新的 index 或者一个重复的 index。 参数 ::::::::: - **call_func** (Layer|function) - 静态图下的函数或者计算层。 - - **index** (int，可选) - 指定 Op 在哪个 ipu 上计算，（如‘0, 1, 2, 3’），默认值-1，表示不指定 ipu。 - - **stage** (int，可选) – 指定被切分的模型的计算顺序，（如‘0, 1, 2, 3’），按照数值大小顺序对被切分的模型进行计算，默认值-1，表示没有数据流水计算顺序并按照计算图顺序计算 Op。 + - **index** (int，可选) - 指定 Op 在哪个 ipu 上计算，（如‘0, 1, 2, 3’），默认值-1，表示 Op 仅在 ipu 0 上运行。 + - **stage** (int，可选) - 指定被切分的模型的计算顺序，（如‘0, 1, 2, 3’），按照数值大小顺序对被切分的模型进行计算，默认值-1，表示没有数据流水计算顺序并按照计算图顺序计算 Op。 返回 ::::::::: - 无。 + 包装后的调用函数。 代码示例 :::::::::: diff --git a/docs/api/paddle/take_along_axis_cn.rst b/docs/api/paddle/take_along_axis_cn.rst index 1095c3fc789..7ec44e9fcbc 100644 --- a/docs/api/paddle/take_along_axis_cn.rst +++ b/docs/api/paddle/take_along_axis_cn.rst @@ -16,7 +16,7 @@ take_along_axis 返回 ::::::::: -- **out** (Tensor) - 输出 Tensor，包含 indeces 矩阵选定的元素，与 ``arr`` 数据类型相同。 +输出 Tensor，包含 indeces 矩阵选定的元素，与 ``arr`` 数据类型相同。 代码示例 ::::::::: From e516f78610f1261b5f3acd943a7d8ad519ab0995 Mon Sep 17 00:00:00 2001 From: PuQing Date: Mon, 24 Oct 2022 11:02:55 +0800 Subject: [PATCH 8/8] fix url change (#5347) --- docs/design/phi/design_cn.md | 4 ++-- docs/design/phi/design_en.md | 2 +- docs/dev_guides/api_contributing_guides/new_python_api_cn.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/design/phi/design_cn.md b/docs/design/phi/design_cn.md index 91e3ab416f1..bc5043e07ed 100644 --- a/docs/design/phi/design_cn.md +++ b/docs/design/phi/design_cn.md @@ -582,7 +582,7 @@ Tensor scale(const Tensor& x, C++ API 的自动生成是通过解析 YAML 配置文件来进行生成的，YAML 配置文件分为： - - 前向 API 配置文件(`paddle/phi/api/yaml/api.yaml`，解析后生成代码文件为`paddle/phi/api/include/api.h`和`paddle/phi/api/lib/api.cc`) + - 前向 API 配置文件(`paddle/phi/api/yaml/ops.yaml`，解析后生成代码文件为`paddle/phi/api/include/api.h`和`paddle/phi/api/lib/api.cc`) - 反向 API 配置文件(`paddle/phi/api/yaml/backward.yaml`，解析后生成的代码文件为`paddle/phi/api/backward/backward_api.h`和`paddle/phi/api/lib/backward_api.cc`)。 C++ API 生成的关键在于 YAML 文件的配置，以 matmul 为例，其前向和反向的配置文件如下： @@ -1642,7 +1642,7 @@ PHI 期望的 Op 开发方式：**“完形填空”式算子描述实现 + “ 需要写的内容如下： ``` -## 配置文件 api.yaml +## 配置文件 ops.yaml - api : add args : (const Tensor& x, const Tensor& y) output : Tensor diff --git a/docs/design/phi/design_en.md b/docs/design/phi/design_en.md index b8c36769142..9d6cd489481 100644 --- a/docs/design/phi/design_en.md +++ b/docs/design/phi/design_en.md @@ -582,7 +582,7 @@ Described as follows: The automatic generation of the C++ API is generated by parsing the YAML configuration file. The YAML configuration file is divided into: -- Forward API configuration file(`paddle/phi/api/yaml/api.yaml`. After parsing, the generated code file is `paddle/phi/api/include/api.h` and `paddle/phi/api/lib/api.cc`) +- Forward API configuration file(`paddle/phi/api/yaml/ops.yaml`. After parsing, the generated code file is `paddle/phi/api/include/api.h` and `paddle/phi/api/lib/api.cc`) - Backward API configuration file(`paddle/phi/api/yaml/backward.yaml`. After parsing, the generated code file is `paddle/phi/api/backward/backward_api.h` and `paddle/phi/api/lib/backward_api.cc`) The key to C++ API generation lies in the configuration of the YAML file. Taking `matmul` as an example, the forward and backward configuration are as follows: diff --git a/docs/dev_guides/api_contributing_guides/new_python_api_cn.md b/docs/dev_guides/api_contributing_guides/new_python_api_cn.md index 5d1250af881..3e694201de6 100644 --- a/docs/dev_guides/api_contributing_guides/new_python_api_cn.md +++ b/docs/dev_guides/api_contributing_guides/new_python_api_cn.md @@ -122,7 +122,7 @@ def trace(x, offset=0, axis1=0, axis2=1, name=None): - `_C_ops` 是 [python/paddle/_C_ops.py](https://github.com/PaddlePaddle/Paddle/blob/develop/python/paddle/_C_ops.py)，其实现了从 Paddle 编译得到的二进制文件中 import C++ 算子对应的 Python C 函数。 - `trace` 是算子的 Python C 函数名。Python C 函数的命名直接采用算子名。 - - 参数 `( x, offset, axis1, axis2 )`需按照 [YAML 配置文件](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/phi/api/yaml/api.yaml#L185) 中定义的输入参数顺序传入，C++ 算子的输入、输出和属性等描述是通过 YAML 配置文件定义的，具体可参见 [开发 C++ 算子](new_cpp_op_cn.html) 章节介绍。 + - 参数 `( x, offset, axis1, axis2 )`需按照 [YAML 配置文件](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/phi/api/yaml/ops.yaml#L185) 中定义的输入参数顺序传入，C++ 算子的输入、输出和属性等描述是通过 YAML 配置文件定义的，具体可参见 [开发 C++ 算子](new_cpp_op_cn.html) 章节介绍。 > 注意：由于目前飞桨动态图正处在重构升级阶段，所以现有算子的代码会分别有新旧动态图两个代码分支，其中 `in_dygraph_mode()` 表示新动态图分支（默认），`_in_legacy_dygraph()`为旧动态图分支，**在新增算子时无需添加旧动态图分支代码**。