# MS-GameTutorial

**Repository Path**: zhangjunyi08/MS-GameTutorial

## Basic Information

- **Project Name**: MS-GameTutorial
- **Description**: MindSpore模型开发与迁移指导手册
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2022-12-01
- **Last Updated**: 2022-12-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# **MS-GameTutorial：昇思模型开发者实战全流程手册**

欢迎使用MindSpore（中文名：昇思）完成模型开发和迁移任务！本手册针对MindSpore普通网络模型与超大网络模型的开发迁移过程提供了详实的入门样例、多样化的调优工具使用方法和便于查找的问题清单，希望能帮到您。与官方提供的文档相比，本手册更侧重于工程实施过程中所遇到的实际问题，是对官方文档实现的细节补充。也正因为于此，非常欢迎您的加入与我们一同完善MindSpore模型开发与迁移流程。😊

## **普通网络模型部分**

### **1.昇腾软硬件全栈**

- [昇腾全栈介绍](https://zhuanlan.zhihu.com/p/571485917)
- [昇思框架介绍](https://app.huawei.com/eplus/smb/front/index.html#/informationDetailsZone?discoverId=1357&shareId=4b3727000aac4114b8ddebc7cb37988c&openSmbApp=0)
- [CANN架构介绍](https://www.bilibili.com/video/BV1LM4y1574x?share_source=copy_web)
- [快速上手案例](https://gitee.com/mindspore/omni-perception-pretrainer)

### **2.对象存储服务**

- [对象存储服务OBS简介](gm/存储服务/对象存储服务OBS简介.md)
- [OBS工具简介](gm/存储服务/OBS工具简介.md)
- [弹性文件服务SFS简介](gm/存储服务/弹性文件服务SFS简介.md)
- [快速上手](gm/存储服务/快速上手.md)
- [FAQ](gm/存储服务/FAQ.md)

### **3.ModelArts**

- [ModelArts 简介](https://gitee.com/xiaobai-666/MS-GameTutorial/tree/master/gm/modelarts/ma_intro.md)
- [新版训练作业使用说明](https://gitee.com/xiaobai-666/MS-GameTutorial/tree/master/gm/modelarts/ma_training_usage.md)
- [示例：使用 OBS 和 ModelArts 完成训练作业部署（LeNet+MNIST数据集）](https://gitee.com/xiaobai-666/MS-GameTutorial/tree/master/gm/modelarts/adapation_demo.md)
- [示例：从 0 到 1 制作自定义镜像并用于训练（MindSpore+Ascend）](https://support.huaweicloud.com/docker-modelarts/develop-modelarts-0106.html)
- [AICC Tools](https://aicc-tools-docs.obs.cn-southwest-228.cdzs.cn/instruction/aicc_tools_docs/build/html/aicc_tools_docs.html)
- 问题清单
  - 旧版训练自定义镜像方式启动长时作业，由于临时AKSK有效期为24小时，运行时间超过有效期后无法访问OBS的[规避方案](https://bbs.huaweicloud.com/blogs/296942)
- 注意事项
  - 旧版训练作业存在日志显示以及文件回传obs的问题，建议使用**新版训练作业**


### **4.PyTorch向MindSpore模型迁移**

- [模型迁移全流程指导](https://www.mindspore.cn/docs/zh-CN/r1.9/migration_guide/sample_code.html)
- 工具说明
    - [模块精度对比工具](gm/pytorch向mindspore模型迁移/精度对比工具介绍.md)
- 问题清单

### **5.模型性能调优**

- [昇思性能调优平台介绍](https://mindspore.cn/mindinsight/docs/zh-CN/r1.8/performance_tuning_guide.html)
- [ProFiler文件的生成与加载](https://gitee.com/xiaobai-666/MS-GameTutorial/blob/master/gm/mindinsight/Profiler%E4%B8%8EMindinsight.md#profiler%E7%9A%84%E7%94%9F%E6%88%90)
- [本地使用MindInsight](https://gitee.com/xiaobai-666/MS-GameTutorial/blob/master/gm/mindinsight/Profiler%E4%B8%8EMindinsight.md#%E6%9C%AC%E5%9C%B0%E4%BD%BF%E7%94%A8mindinsight)
- [ModelArts平台使用MindInsight](https://gitee.com/xiaobai-666/MS-GameTutorial/blob/master/gm/mindinsight/Profiler%E4%B8%8EMindinsight.md#modelarts%E5%B9%B3%E5%8F%B0%E4%BD%BF%E7%94%A8mindinsight)
- [MindInsight用户界面的使用](https://gitee.com/xiaobai-666/MS-GameTutorial/blob/master/gm/mindinsight/Profiler%E4%B8%8EMindinsight.md#mindinsight%E7%94%A8%E6%88%B7%E7%95%8C%E9%9D%A2%E7%9A%84%E4%BD%BF%E7%94%A8)
- [其他问题清单](https://gitee.com/xiaobai-666/MS-GameTutorial/blob/master/gm/mindinsight/Profiler%E4%B8%8EMindinsight.md#%E5%85%B6%E4%BB%96%E9%97%AE%E9%A2%98%E6%B8%85%E5%8D%95%E6%95%B4%E7%90%86)

### **6.模型精度调优**

- 精度异常的来源分析
- 精度调优定位的思路
- 精度调优的工具：Print、数值校验
- 官网相关材料
  - [精度调优指南](https://www.mindspore.cn/mindinsight/docs/zh-CN/r1.8/accuracy_problem_preliminary_location.html)
  - [精度调优资料分享](https://www.mindspore.cn/docs/zh-CN/r1.8/faq/precision_tuning.html)
- 问题清单

### **7.报错定位分析思路**

- 如何阅读报错、报错定界
- 官网相关材料
  - [功能调试指南](https://www.mindspore.cn/tutorials/experts/zh-CN/r1.8/debug/function_debug.html)
  - [报错分析案例](https://www.mindspore.cn/tutorials/experts/zh-CN/r1.8/debug/error_analyze.html)
  - [FAQ](https://www.mindspore.cn/docs/zh-CN/r1.8/faq/installation.html)
- 问题清单

## **超大网络模型部分**

### **1.大模型基础内容介绍**

- 大模型基本概念及综述介绍
- 基于昇腾软硬件的多模态大模型介绍

### **2.分布式并行策略与案例展示**

- 分布式并行介绍
- 应用案例
- 问题清单
- [分布式策略异常的典型报错](https://www.mindspore.cn/tutorials/experts/zh-CN/r1.8/debug/error_analyze.html#%E5%88%86%E5%B8%83%E5%BC%8F%E5%B9%B6%E8%A1%8C%E9%94%99%E8%AF%AF%E5%88%86%E6%9E%90)

## 贡献
找到的一些对MindSpore提供的宝贵意见

1.基于昇思MindSpore的训练框架[MindsporeTrainer](https://github.com/baudzhou/MindsporeTrainer)，让Mindspore的算法研究更容易一些。

## 说明

各部分中的问题清单收录了在MindSpore开发和迁移过程中可能遇到的报错和对应的解决方法。本文档的使用人也可对遇到的问题评估，认为是较为普遍的问题可以申请添加到对应清单中。