| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
docs: align bilingual example READMEs Co-authored-by: xun_zhuge<zhugexun@hisilicon.com> # message auto-generated for no-merge-commit merge: !4370 merge fix-examples-bilingual-readme-alignment into master docs: align bilingual example READMEs Created-by: xun_zhuge Commit-by: xun_zhuge Merged-by: cann-robot Description: ## 描述 本 PR 从 master 分支修复 examples 目录中中英文 README 不严格对应、同仓文档链接形式不统一及 Markdown 渲染结构错误的问题，确保两种语言描述同一份技术内容，并统一使用相对路径引用本仓 docs。不涉及样例实现逻辑。 主要变更： - 全量核对 388 组 README.md / README_en.md，中英文单边缺失均为 0。 - 补齐英文文档遗漏的场景图、理论分析公式、参数解释、产品差异、性能分析和 API 使用说明；重点补齐 10 张场景图及多处 MTE2/Cube 理论分析，并完整对齐 18 处 msOpProf 章节。 - 修正矩阵维度、shape、对齐值、性能倍率、带宽公式及百分点等技术数据，确保文档与中文原文及样例源码一致。 - 修复语义误译，包括逐元素比较值被误译为比较 tensor 尺寸、aic_mac_ratio 被误译为理论峰值性能，以及 UB Bank 冲突调优建议增译和漏译等问题。 - 将 70 个 README 中 420 条指向本仓 docs 的 GitCode HTTPS 链接改为相对路径，保留 28 个锚点，且转换前后均解析到同一文件或目录。 - 更新 Markdown 链接策略：允许 examples 使用相对路径引用 docs，并拒绝新增同仓 docs HTTPS 链接；其他跨区链接约束保持不变。 - 修复 3 处实际渲染结构问题：mmad_load3dv2 英文表格行缩进、simulator 英文子列表层级、load_data_2dv2_l12l0 中文代码块列表归属。 - 将 6 个中英文 README 中 12 处 C++ 代码块语言标识统一为 cpp，确保代码高亮标识一致。 - 对 17 个存在对齐问题的中英文对应目录树统一 // 注释列，修复 08_simulator 英文树层级缩进，并将 4 组目录树误用的 ASCII | 统一为 Unicode │。 - 为满足仓库中英文 README 成对修改拦截规则，对 PR 中 34 个原本单边改动的 counterpart 增加不影响 Markdown 渲染的空行，使全部改动 README 成对出现。 - 对齐标题层级、段落与列表、目录树、命令、代码注释、Markdown/HTML 表格、图片、公式、链接和锚点，并清理英文正文中的中文残留。 ## 关联的Issue 无。 ## 测试 已完成以下验证： - git diff --check origin/master...HEAD：通过。 - bash -n scripts/markdown_link_check.sh：通过。 - bash scripts/markdown_link_check.sh --full：通过，共检查 3953 个 Markdown 文件。 - README 配对检查：388 组，中文或英文单边缺失均为 0。 - 双语渲染结构检查：388 组的标题、表格、代码块、列表及嵌套关系差异均为 0。 - 全量 Markdown 格式检查：776 个 README、1770 个 Markdown 表格、4068 个 fenced code block；表格缩进、代码围栏闭合/缩进及非规范 C++ 语言标识问题均为 0。 - 目录树专项检查：278 个带注释的中英文对应目录树块；注释列不一致、短层级缩进和 ASCII 树线残留均为 0。 - 成对修改检查：186 个改动 README，组成 93 对；单边改动为 0；34 个补位 README 的渲染 HTML 变化为 0。 - 链接精确转换检查：70 个 README、420 条链接、28 个锚点，非链接正文改动为 0，目标错误为 0。 - examples 中同仓 docs HTTPS 链接残留检查：0 条。 - 链接策略红绿验证：同仓 HTTPS 链接会被拒绝并给出相对路径，原有 docs/api 与 docs/guide 跨区约束仍生效。 - 提交前检查：OAT Compliance Check 和 Markdown link check 均通过。 ## 文档更新 更新 examples 下 186 个 README 文件（93 个英文、93 个中文）及 scripts/markdown_link_check.sh，使双语文档严格对齐、翻译准确，统一同仓文档链接规范，并修复表格、代码块和列表的渲染格式。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4370 | 1 个月前 | |
docs: add English translations for examples README files Co-authored-by: DragonBornHD84<huangduo4@hisilicon.com> # message auto-generated for no-merge-commit merge: !3384 merge dev5 into master docs: add English translations for examples README files Created-by: DragonBornHD84 Commit-by: DragonBornHD84 Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> docs: add English translations for examples README files - Add 257 new README_en.md translations across examples/ - Update 2 existing translations with latest Chinese changes - Covers 01_simd_cpp_api, 02_simd_c_api, 03_simt_api, 04_aicpu - Excludes 00_introduction directories - Follows Google Developer Style Guide ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [ ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!3384 | 2 个月前 | |
docs: align bilingual example READMEs Co-authored-by: xun_zhuge<zhugexun@hisilicon.com> # message auto-generated for no-merge-commit merge: !4370 merge fix-examples-bilingual-readme-alignment into master docs: align bilingual example READMEs Created-by: xun_zhuge Commit-by: xun_zhuge Merged-by: cann-robot Description: ## 描述 本 PR 从 master 分支修复 examples 目录中中英文 README 不严格对应、同仓文档链接形式不统一及 Markdown 渲染结构错误的问题，确保两种语言描述同一份技术内容，并统一使用相对路径引用本仓 docs。不涉及样例实现逻辑。 主要变更： - 全量核对 388 组 README.md / README_en.md，中英文单边缺失均为 0。 - 补齐英文文档遗漏的场景图、理论分析公式、参数解释、产品差异、性能分析和 API 使用说明；重点补齐 10 张场景图及多处 MTE2/Cube 理论分析，并完整对齐 18 处 msOpProf 章节。 - 修正矩阵维度、shape、对齐值、性能倍率、带宽公式及百分点等技术数据，确保文档与中文原文及样例源码一致。 - 修复语义误译，包括逐元素比较值被误译为比较 tensor 尺寸、aic_mac_ratio 被误译为理论峰值性能，以及 UB Bank 冲突调优建议增译和漏译等问题。 - 将 70 个 README 中 420 条指向本仓 docs 的 GitCode HTTPS 链接改为相对路径，保留 28 个锚点，且转换前后均解析到同一文件或目录。 - 更新 Markdown 链接策略：允许 examples 使用相对路径引用 docs，并拒绝新增同仓 docs HTTPS 链接；其他跨区链接约束保持不变。 - 修复 3 处实际渲染结构问题：mmad_load3dv2 英文表格行缩进、simulator 英文子列表层级、load_data_2dv2_l12l0 中文代码块列表归属。 - 将 6 个中英文 README 中 12 处 C++ 代码块语言标识统一为 cpp，确保代码高亮标识一致。 - 对 17 个存在对齐问题的中英文对应目录树统一 // 注释列，修复 08_simulator 英文树层级缩进，并将 4 组目录树误用的 ASCII | 统一为 Unicode │。 - 为满足仓库中英文 README 成对修改拦截规则，对 PR 中 34 个原本单边改动的 counterpart 增加不影响 Markdown 渲染的空行，使全部改动 README 成对出现。 - 对齐标题层级、段落与列表、目录树、命令、代码注释、Markdown/HTML 表格、图片、公式、链接和锚点，并清理英文正文中的中文残留。 ## 关联的Issue 无。 ## 测试 已完成以下验证： - git diff --check origin/master...HEAD：通过。 - bash -n scripts/markdown_link_check.sh：通过。 - bash scripts/markdown_link_check.sh --full：通过，共检查 3953 个 Markdown 文件。 - README 配对检查：388 组，中文或英文单边缺失均为 0。 - 双语渲染结构检查：388 组的标题、表格、代码块、列表及嵌套关系差异均为 0。 - 全量 Markdown 格式检查：776 个 README、1770 个 Markdown 表格、4068 个 fenced code block；表格缩进、代码围栏闭合/缩进及非规范 C++ 语言标识问题均为 0。 - 目录树专项检查：278 个带注释的中英文对应目录树块；注释列不一致、短层级缩进和 ASCII 树线残留均为 0。 - 成对修改检查：186 个改动 README，组成 93 对；单边改动为 0；34 个补位 README 的渲染 HTML 变化为 0。 - 链接精确转换检查：70 个 README、420 条链接、28 个锚点，非链接正文改动为 0，目标错误为 0。 - examples 中同仓 docs HTTPS 链接残留检查：0 条。 - 链接策略红绿验证：同仓 HTTPS 链接会被拒绝并给出相对路径，原有 docs/api 与 docs/guide 跨区约束仍生效。 - 提交前检查：OAT Compliance Check 和 Markdown link check 均通过。 ## 文档更新 更新 examples 下 186 个 README 文件（93 个英文、93 个中文）及 scripts/markdown_link_check.sh，使双语文档严格对齐、翻译准确，统一同仓文档链接规范，并修复表格、代码块和列表的渲染格式。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4370 | 1 个月前 | |
add capi l0c2gm examples Co-authored-by: yhkz9211<huyulin4@huawei.com> # message auto-generated for no-merge-commit merge: !4406 merge examples into master add capi l0c2gm examples Created-by: yhkz9211 Commit-by: yhkz9211 Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 添加capi l0c2gm的样例 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> 关联Issue [#1264](https://gitcode.com/cann/asc-devkit/issues/1264) ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 本地验证通过 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> NA ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [x] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [ ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4406 | 1 个月前 | |
docs: align bilingual example READMEs Co-authored-by: xun_zhuge<zhugexun@hisilicon.com> # message auto-generated for no-merge-commit merge: !4370 merge fix-examples-bilingual-readme-alignment into master docs: align bilingual example READMEs Created-by: xun_zhuge Commit-by: xun_zhuge Merged-by: cann-robot Description: ## 描述 本 PR 从 master 分支修复 examples 目录中中英文 README 不严格对应、同仓文档链接形式不统一及 Markdown 渲染结构错误的问题，确保两种语言描述同一份技术内容，并统一使用相对路径引用本仓 docs。不涉及样例实现逻辑。 主要变更： - 全量核对 388 组 README.md / README_en.md，中英文单边缺失均为 0。 - 补齐英文文档遗漏的场景图、理论分析公式、参数解释、产品差异、性能分析和 API 使用说明；重点补齐 10 张场景图及多处 MTE2/Cube 理论分析，并完整对齐 18 处 msOpProf 章节。 - 修正矩阵维度、shape、对齐值、性能倍率、带宽公式及百分点等技术数据，确保文档与中文原文及样例源码一致。 - 修复语义误译，包括逐元素比较值被误译为比较 tensor 尺寸、aic_mac_ratio 被误译为理论峰值性能，以及 UB Bank 冲突调优建议增译和漏译等问题。 - 将 70 个 README 中 420 条指向本仓 docs 的 GitCode HTTPS 链接改为相对路径，保留 28 个锚点，且转换前后均解析到同一文件或目录。 - 更新 Markdown 链接策略：允许 examples 使用相对路径引用 docs，并拒绝新增同仓 docs HTTPS 链接；其他跨区链接约束保持不变。 - 修复 3 处实际渲染结构问题：mmad_load3dv2 英文表格行缩进、simulator 英文子列表层级、load_data_2dv2_l12l0 中文代码块列表归属。 - 将 6 个中英文 README 中 12 处 C++ 代码块语言标识统一为 cpp，确保代码高亮标识一致。 - 对 17 个存在对齐问题的中英文对应目录树统一 // 注释列，修复 08_simulator 英文树层级缩进，并将 4 组目录树误用的 ASCII | 统一为 Unicode │。 - 为满足仓库中英文 README 成对修改拦截规则，对 PR 中 34 个原本单边改动的 counterpart 增加不影响 Markdown 渲染的空行，使全部改动 README 成对出现。 - 对齐标题层级、段落与列表、目录树、命令、代码注释、Markdown/HTML 表格、图片、公式、链接和锚点，并清理英文正文中的中文残留。 ## 关联的Issue 无。 ## 测试 已完成以下验证： - git diff --check origin/master...HEAD：通过。 - bash -n scripts/markdown_link_check.sh：通过。 - bash scripts/markdown_link_check.sh --full：通过，共检查 3953 个 Markdown 文件。 - README 配对检查：388 组，中文或英文单边缺失均为 0。 - 双语渲染结构检查：388 组的标题、表格、代码块、列表及嵌套关系差异均为 0。 - 全量 Markdown 格式检查：776 个 README、1770 个 Markdown 表格、4068 个 fenced code block；表格缩进、代码围栏闭合/缩进及非规范 C++ 语言标识问题均为 0。 - 目录树专项检查：278 个带注释的中英文对应目录树块；注释列不一致、短层级缩进和 ASCII 树线残留均为 0。 - 成对修改检查：186 个改动 README，组成 93 对；单边改动为 0；34 个补位 README 的渲染 HTML 变化为 0。 - 链接精确转换检查：70 个 README、420 条链接、28 个锚点，非链接正文改动为 0，目标错误为 0。 - examples 中同仓 docs HTTPS 链接残留检查：0 条。 - 链接策略红绿验证：同仓 HTTPS 链接会被拒绝并给出相对路径，原有 docs/api 与 docs/guide 跨区约束仍生效。 - 提交前检查：OAT Compliance Check 和 Markdown link check 均通过。 ## 文档更新 更新 examples 下 186 个 README 文件（93 个英文、93 个中文）及 scripts/markdown_link_check.sh，使双语文档严格对齐、翻译准确，统一同仓文档链接规范，并修复表格、代码块和列表的渲染格式。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4370 | 1 个月前 | |
docs: align bilingual example READMEs Co-authored-by: xun_zhuge<zhugexun@hisilicon.com> # message auto-generated for no-merge-commit merge: !4370 merge fix-examples-bilingual-readme-alignment into master docs: align bilingual example READMEs Created-by: xun_zhuge Commit-by: xun_zhuge Merged-by: cann-robot Description: ## 描述 本 PR 从 master 分支修复 examples 目录中中英文 README 不严格对应、同仓文档链接形式不统一及 Markdown 渲染结构错误的问题，确保两种语言描述同一份技术内容，并统一使用相对路径引用本仓 docs。不涉及样例实现逻辑。 主要变更： - 全量核对 388 组 README.md / README_en.md，中英文单边缺失均为 0。 - 补齐英文文档遗漏的场景图、理论分析公式、参数解释、产品差异、性能分析和 API 使用说明；重点补齐 10 张场景图及多处 MTE2/Cube 理论分析，并完整对齐 18 处 msOpProf 章节。 - 修正矩阵维度、shape、对齐值、性能倍率、带宽公式及百分点等技术数据，确保文档与中文原文及样例源码一致。 - 修复语义误译，包括逐元素比较值被误译为比较 tensor 尺寸、aic_mac_ratio 被误译为理论峰值性能，以及 UB Bank 冲突调优建议增译和漏译等问题。 - 将 70 个 README 中 420 条指向本仓 docs 的 GitCode HTTPS 链接改为相对路径，保留 28 个锚点，且转换前后均解析到同一文件或目录。 - 更新 Markdown 链接策略：允许 examples 使用相对路径引用 docs，并拒绝新增同仓 docs HTTPS 链接；其他跨区链接约束保持不变。 - 修复 3 处实际渲染结构问题：mmad_load3dv2 英文表格行缩进、simulator 英文子列表层级、load_data_2dv2_l12l0 中文代码块列表归属。 - 将 6 个中英文 README 中 12 处 C++ 代码块语言标识统一为 cpp，确保代码高亮标识一致。 - 对 17 个存在对齐问题的中英文对应目录树统一 // 注释列，修复 08_simulator 英文树层级缩进，并将 4 组目录树误用的 ASCII | 统一为 Unicode │。 - 为满足仓库中英文 README 成对修改拦截规则，对 PR 中 34 个原本单边改动的 counterpart 增加不影响 Markdown 渲染的空行，使全部改动 README 成对出现。 - 对齐标题层级、段落与列表、目录树、命令、代码注释、Markdown/HTML 表格、图片、公式、链接和锚点，并清理英文正文中的中文残留。 ## 关联的Issue 无。 ## 测试 已完成以下验证： - git diff --check origin/master...HEAD：通过。 - bash -n scripts/markdown_link_check.sh：通过。 - bash scripts/markdown_link_check.sh --full：通过，共检查 3953 个 Markdown 文件。 - README 配对检查：388 组，中文或英文单边缺失均为 0。 - 双语渲染结构检查：388 组的标题、表格、代码块、列表及嵌套关系差异均为 0。 - 全量 Markdown 格式检查：776 个 README、1770 个 Markdown 表格、4068 个 fenced code block；表格缩进、代码围栏闭合/缩进及非规范 C++ 语言标识问题均为 0。 - 目录树专项检查：278 个带注释的中英文对应目录树块；注释列不一致、短层级缩进和 ASCII 树线残留均为 0。 - 成对修改检查：186 个改动 README，组成 93 对；单边改动为 0；34 个补位 README 的渲染 HTML 变化为 0。 - 链接精确转换检查：70 个 README、420 条链接、28 个锚点，非链接正文改动为 0，目标错误为 0。 - examples 中同仓 docs HTTPS 链接残留检查：0 条。 - 链接策略红绿验证：同仓 HTTPS 链接会被拒绝并给出相对路径，原有 docs/api 与 docs/guide 跨区约束仍生效。 - 提交前检查：OAT Compliance Check 和 Markdown link check 均通过。 ## 文档更新 更新 examples 下 186 个 README 文件（93 个英文、93 个中文）及 scripts/markdown_link_check.sh，使双语文档严格对齐、翻译准确，统一同仓文档链接规范，并修复表格、代码块和列表的渲染格式。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4370 | 1 个月前 |
样例列表
| 目录名称 | 功能描述 |
|---|---|
| 00_introduction | 基于Ascend C的简单的示例，通过Ascend C编程语言实现了自定义功能，分别给出对应的C_API实现 |
| 01_utilities | 基于Ascend C的简单样例，通过printf、assert、DumpTensor等API介绍上板打印、异常检测、CPU孪生调试等系统工具使用方法，适用于调试阶段 |
| 02_features | 基于Ascend C特性样例，介绍了Framework、C_API等特性编写样例的实现方法 |