【飞桨体验评测任务第三期】

[sunzhongkai588]

一、背景介绍

2022年飞桨将重点开展开发者生态贡献机制，建立开发者与飞桨的多样化联动，共同打造优秀的开源生态。在今年3月，我们开展了第二次评估，重点放在了API文档与目录大纲评测以及安装文档与报错评测，共收集到反馈 210+条，为相关产品的优化提供了重要的信息输入。为了进一步提升飞桨框架的使用体验，我们诚挚的邀请你参与到第三期体验评估中，这次主要是飞桨分布式文档评估与硬件接入的评估，并且和我们一起共建飞桨框架，后续会陆续安排其他产品模块的体验评测，希望大家持续关注。

二、参与流程

三、具体任务：

1、Paddle分布式文档—全流程打卡任务

• 任务名称：飞桨分布式文档快速开始评测任务（负责人微信昵称：Tina侨、Suen.ZK）

• 任务难度：高等

• 任务一描述：

  • 干什么：我们提供了【单机转多机多卡数据并行】说明文档：数据并行 和 若干个单机示例（见下方），您需要根据【数据并行】说明文档，将以下【单机示例】转写成【多机/多卡】示例，并产出一份全流程评估报告。
    • 【CV】基于图片相似度的图片搜索：https://www.paddlepaddle.org.cn/documentation/docs/zh/practices/cv/image_search.html
    • 【CV】点云处理：实现PointNet点云分类：https://www.paddlepaddle.org.cn/documentation/docs/zh/practices/cv/pointnet.html
    • 【NLP】用N-Gram模型在莎士比亚文集中训练word embedding：https://www.paddlepaddle.org.cn/documentation/docs/zh/practices/nlp/n_gram_model.html
    • 【NLP】IMDB 数据集使用BOW网络的文本分类：https://www.paddlepaddle.org.cn/documentation/docs/zh/practices/nlp/imdb_bow_classification.html
  • 如何干：您需要根据【数据并行】文档内容（包含链接所指向的外部资源或页面），【任选上面一份示例 + 自己的任务】完成打卡任务中的核心步骤，并记录每一步遇到的问题、解决方法以及对文档清晰度的评价。提交模板为：数据并行评测点模板

• 任务二描述：

  • 干什么：我们提供了【单机转分布式Parameter Sever并行】说明文档：Parameter Sever训练 和 若干个单机示例（见下方），您需要根据【Parameter Sever训练】说明文档，将【单机示例】转写成多机/多卡示例，并产出一份全流程评估报告。
    • CTR-DNN https://github.com/PaddlePaddle/FleetX/tree/develop/eval/rec/dnn_single_static
    • DSSM文本匹配模型 https://github.com/PaddlePaddle/FleetX/tree/develop/eval/rec/dssm_single_static
    • Wide&Deep模型 https://github.com/PaddlePaddle/FleetX/tree/develop/eval/rec/wide_and_deep_single_static
  • 如何干：您需要根据【Parameter Sever训练】文档内容（包含链接所指向的外部资源或页面），【任选上面两份示例】完成打卡任务中的核心步骤，并记录每一步遇到的问题、解决方法以及对文档清晰度的评价。提交模板为：Parameter Server训练评测点模板

• 任务分配：为了降低bias，两组任务会分别预留10、15名同学来做交叉评测，可根据自己的开发经验和兴趣点选择一项任务完成打卡评测工作。请在 数据并行任务表 或 Parameter Sever训练任务表 中任意认领任务。（注意：填写完名字即代表认领成功，各项任务先到先得）

• 任务认领与提交：你需要完成以下操作和步骤

  • （1）请在任务表中选择想要认领的任务，写昵称占坑。
  • （2）参照github 上提供的issue提交模板，选取对应模板：数据并行评测点模板 or Parameter Server训练评测点模板，并结合打卡任务记录的内容，直接填写issue模板并提交（注意，Title填写“微信昵称+Paddle分布式训练文档体验评估”）。
  • （3）在任务表 Excel 中更新文档评估状态和提交的issue链接。
  • （4）评测群中 @tina侨 完成评估。

• 其他说明：

  • 如果您没有多机/多卡环境，可以使用飞桨的AIStudio平台提供的多机/多卡环境，来跑通您的项目脚本，具体使用教程可以参考AIStudio使用方法。
  • 如果您想了解更多单机转多机/多卡的原理和经验，可参考飞桨FleetX文档。
  • 我们鼓励大家使用自己的硬件环境完成测评；如遇到AIStudio算力卡问题，可以联系@tina侨

2、硬件接入文档评测任务

• 任务名称：飞桨硬件接入文档评测任务（负责人微信昵称：王凯）
• 任务难度：中等
• 任务一描述：
  • 干什么：我们提供了【Paddle2ONNX】文档，您需要根据【Paddle2ONNX】将2个飞桨模型转换成ONNX模型，并产出2份全流程评估报告。
    • Paddle2ONNX文档：https://github.com/PaddlePaddle/Paddle2ONNX/blob/develop/README.md，
  • 如何干：您需要根据【Paddle2ONNX】文档内容，从这个目录 （ https://github.com/PaddlePaddle/Paddle2ONNX/tree/model_zoo/model_zoo ）中选择2个不同场景的模型，在AIStudio将这2个飞桨模型转换成ONNX模型，填写评估表格，按照以下转换步骤完成打卡，并反馈每个步骤的问题和卡点；完成转换任务的使用体验和感受。完成表格。提交模板为：https://shimo.im/docs/aBAYVL4oDJHrOB3j/ 《硬件接入评测部分-任务一打卡评测报告（模板）》
  • NOTE-1: model选择：https://github.com/PaddlePaddle/Paddle2ONNX/tree/model_zoo/model_zoo 中选择两个模型，要求不同场景（例如，ocr+classification）
  • NOTE-2: 如何验证转换是否正确？model zoo中提供了代码，例如：https://github.com/PaddlePaddle/Paddle2ONNX/tree/model_zoo/model_zoo/ocr
• 任务二描述：
  • 干什么：我们提供了【飞桨硬件支持】文档，请对照【文档评估表】逐项打分。
    • 飞桨框架昆仑芯片安装说明 
    • 飞桨框架昆仑1代芯片训练示例 
    • 飞桨预测库昆仑1代芯片安装及使用 
    • 飞桨框架昆仑2代芯片训练示例 
    • 飞桨框架昇腾NPU版安装说明
    • 飞桨框架昇腾NPU版训练示例
  • 如何干：您需要基于【文档评估表】，对文档内容进行打分，完成表格。提交模板为：https://shimo.im/sheets/erAdPLZay1tlXxAG/7K4Oy/ 《文档评估表-单个topic.xlsx》
• 任务三描述：
  • 干什么：我们提供了【飞桨硬件支持】文档，请对照【文档评估表】逐项打分。
    • 飞桨框架ROCm版安装说明
    • 飞桨框架ROCm版训练示例
    • 飞桨框架ROCm版预测示例
    • 飞桨框架IPU版安装说明
    • 飞桨框架IPU版训练示例
    • 飞桨框架IPU版预测示例
  • 如何干：您需要基于【文档评估表】，对文档内容进行打分，完成表格。提交模板为：https://shimo.im/sheets/erAdPLZay1tlXxAG/7K4Oy/ 《文档评估表-单个topic.xlsx》
• 任务四描述：
  • 干什么：我们提供了【飞桨硬件支持】文档，请对照【文档评估表】逐项打分。
    • 自定义Runtime 
    • 数据类型
    • Device接口
    • Memory接口
    • Stream接口 
    • Event接口 
    • 新硬件接入示例
  • 如何干：您需要基于【文档评估表】，对文档内容进行打分，完成表格。提交模板为：https://shimo.im/sheets/erAdPLZay1tlXxAG/7K4Oy/ 《文档评估表-单个topic.xlsx》
• 任务五描述：
  • 干什么：我们提供了【飞桨硬件支持】文档，请对照【文档评估表】逐项打分。
    • 自定义Kernel 
    • Kernel函数声明 
    • Kernel实现接口
    • Context API : 介绍设备上下文相关C++ API。
    • Tensor API : 介绍Tensor相关C++ API。
    • Exception API : 介绍异常处理相关C++ API。
    • Kernel注册接口
  • 如何干：您需要基于【文档评估表】，对文档内容进行打分，完成表格。提交模板为：https://shimo.im/sheets/erAdPLZay1tlXxAG/7K4Oy/ 《文档评估表-单个topic.xlsx》
• 任务分配：同学可以在任务一至五中选择一项任务完成评测工作。每项任务会分别预留10名同学来完成，可根据自己的开发经验和兴趣点选择一项任务完成评测工作。请在 硬件接入任务表 中任意认领任务。（注意：填写完名字即代表认领成功，各项任务先到先得）
• 任务认领与提交：你需要完成以下操作和步骤
  • （1）请在任务表中选择想要认领的任务，写昵称占坑。
  • （2）根据任务说明，下载相应报告模版，完成任务后将评估表/报告打包成一个zip文件并在硬件接入任务提交文件夹提交（注意，Title填写“微信昵称+Paddle硬件接入文档体验评估”）。
  • （3）在任务表 Excel 中更新文档评估状态和提交的文件链接。
  • （4）评测群中 @王凯 完成评估。

四、答疑

在评估过程中，有任何问题，都可以在群中或此ISSUE下进行提问，我们会尽快解答你的问题~

五、最后

再一次感谢你参与飞桨框架体验评估任务，我们会认真参考你的评分与建议，打造最好用的深度学习框架！
如果您对产品体验评测任务感兴趣，可以直接联系18614069622（微信） 或 扫码加入我们（5月30日前有效）。