Files	Last commit	Last update
01_simd_cpp_api	tensor api同步非对齐接口 Co-authored-by: treefei<lishufei2@huawei.com> # message auto-generated for no-merge-commit merge: !6667 merge master into master tensor api同步非对齐接口 Created-by: treefei Commit-by: treefei Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 在 Tensor API 中提供跨拍有状态的非对齐读写能力，提供unalign_load和unalign_store两个struct类， ureg、pre、post 封装在struct类中，不再直接暴露给 Tensor API 用户，并提供资料和样例。 ## 关联的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!6667	23 days ago
02_simd_c_api	chore(okf): sync okf-search skill to latest fixes Co-authored-by: flyingXLB<sz2516004@nuaa.edu.cn> # message auto-generated for no-merge-commit merge: !6619 merge okf-knowledge-user into master chore(okf): sync okf-search skill to latest fixes Created-by: flyingXLB Commit-by: flyingXLB Merged-by: cann-robot Description: ## 描述新增用户侧asc-search skill，将 API文档、头文件声明和现有asc 样例关联为可检索索引，支持按用途、数据类型、参数、CANN 版本及架构查找候选接口。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [x] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [ ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6619	24 days ago
03_simt_api	新增predicate优化样例 Co-authored-by: baixueyan<baixy2@mails.neu.edu.cn> # message auto-generated for no-merge-commit merge: !6127 merge dev1 into master 新增predicate优化样例 Created-by: gcw_1m54gGxh Commit-by: baixueyan Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 新增 SIMT 编程模式 Predicate（谓词）优化最佳实践样例，位于 examples/03_simt_api/03_best_practices/02_control_flow/predicate_optimization，通过 <<<>>> 直调方式介绍 SIMT 编程下 Warp 分支发散的谓词化调优思路。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> https://gitcode.com/cann/asc-devkit/issues/1860 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> - 环境：Ascend 950PR/950DT（dav-3510），CANN >= 9.1.0； - cmake -DCMAKE_ASC_ARCHITECTURES=dav-3510 .. 编译通过（npu 模式），-DCMAKE_ASC_RUN_MODE=sim 仿真模式编译通过； - 逐一运行全部 10 个用例（hlog10_case0/1，j0f_case2/3/4_{low,high,special,mixed}），每组用例在同一份输入上运行并逐元素一致性校验，基线与优化版本计算结果一致； - 使用 msopprof 采集 Task Duration / aiv_total_cycles / execute cycle，性能数据已录入 README。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> - 新增examples/03_simt_api/03_best_practices/02_control_flow/predicate_optimization/README.md， examples/03_simt_api/03_best_practices/02_control_flow/predicate_optimization/README_en.md - 新增examples/03_simt_api/03_best_practices/02_control_flow/predicate_optimization/CMakeLists.txt - 新增examples/03_simt_api/03_best_practices/02_control_flow/predicate_optimization/predicate_optimization.asc - 更新examples/03_simt_api/03_best_practices/02_control_flow/README.md，examples/03_simt_api/03_best_practices/02_control_flow/README_en.md - 新增docs/zh/guide/operator_practice/simt_operator_optimization/control_flow/branch_handing.md ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [x] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [ ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6127	29 days ago
04_aicpu	docs: 按产品名称映射表统一产品名称（样例） Co-authored-by: munanhw<munan@huawei.com> # message auto-generated for no-merge-commit merge: !6571 merge docs/product-name-examples into master docs: 按产品名称映射表统一产品名称（样例） Created-by: munanhw Commit-by: munanhw Merged-by: cann-robot Description: ## 描述从 #6524 拆分：examples/ 目录下全部样例文档（856 个文件，中英文 README 成对同步修改）整改规则（依据产品名称映射表）： - Ascend 950PR/Ascend 950DT 系列（含衍生/简写/带空格斜杠变体）统一为 Ascend 950PR&950DT系列产品（英文：Ascend 950PR&950DT products） - Atlas A2/A3 训练系列产品与推理系列产品合并为 Atlas A2系列产品 / Atlas A3系列产品（英文：Atlas A2/A3 products） - Atlas 200I/500 A2 推理产品、Atlas 推理/训练系列产品（含 AI Core / Vector Core 场景）去空格 - 同名并列对按合并语义收敛为单一规范名（如 Atlas A3 products/Atlas A3 products -> Atlas A3 products） ## 关联的Issue 无 ## 测试 - 全量改动已在 #6524 上通过完整 CI（compile 流水线 ci-pipeline-passed），本 PR 为其按目录拆分的等价子集 - 旧名称形式残留为 0、叠字残留为 0；图片路径与文件链接未做任何改动 ## 文档更新本 PR 为文档产品名称整改 ## 类型标签 - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6571	30 days ago
05_simd_simt_hybrid	feat:新增混合编程最佳实践样例 Co-authored-by: lizq15<3229180468@qq.com> # message auto-generated for no-merge-commit merge: !6346 merge master into master feat:新增混合编程最佳实践样例 Created-by: lizq15 Commit-by: lizq15 Merged-by: cann-robot Description: ## 描述新增 Ascend C simd_simt_hybrid 最佳实践样例，展示使用Warp原语优化性能的使用场景和使用方式。主要改动：在 examples/05_simd_simt_hybrid/02_best_practices 下新增 simd_simt_stream_compaction 样例。样例中使用四个 Case 实现 stream_compaction 算子的功能，对比其算子执行耗时并给出调优建议。 ## 关联的Issue 关联Issue https://gitcode.com/cann/asc-devkit/issues/1765 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新新增 simd_simt_stream_compaction/README.md 和 simd_simt_stream_compaction/README_en.md，并更新 02_best_practices 父级 README.md 和 README_en.md 以及 05_simd_simt_hybrid 下的 README.md 和 README_en.md ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [x] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6346	26 days ago
README.md	docs: 按产品名称映射表统一产品名称（样例） Co-authored-by: munanhw<munan@huawei.com> # message auto-generated for no-merge-commit merge: !6571 merge docs/product-name-examples into master docs: 按产品名称映射表统一产品名称（样例） Created-by: munanhw Commit-by: munanhw Merged-by: cann-robot Description: ## 描述从 #6524 拆分：examples/ 目录下全部样例文档（856 个文件，中英文 README 成对同步修改）整改规则（依据产品名称映射表）： - Ascend 950PR/Ascend 950DT 系列（含衍生/简写/带空格斜杠变体）统一为 Ascend 950PR&950DT系列产品（英文：Ascend 950PR&950DT products） - Atlas A2/A3 训练系列产品与推理系列产品合并为 Atlas A2系列产品 / Atlas A3系列产品（英文：Atlas A2/A3 products） - Atlas 200I/500 A2 推理产品、Atlas 推理/训练系列产品（含 AI Core / Vector Core 场景）去空格 - 同名并列对按合并语义收敛为单一规范名（如 Atlas A3 products/Atlas A3 products -> Atlas A3 products） ## 关联的Issue 无 ## 测试 - 全量改动已在 #6524 上通过完整 CI（compile 流水线 ci-pipeline-passed），本 PR 为其按目录拆分的等价子集 - 旧名称形式残留为 0、叠字残留为 0；图片路径与文件链接未做任何改动 ## 文档更新本 PR 为文档产品名称整改 ## 类型标签 - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6571	30 days ago
README_en.md	docs: 按产品名称映射表统一产品名称（样例） Co-authored-by: munanhw<munan@huawei.com> # message auto-generated for no-merge-commit merge: !6571 merge docs/product-name-examples into master docs: 按产品名称映射表统一产品名称（样例） Created-by: munanhw Commit-by: munanhw Merged-by: cann-robot Description: ## 描述从 #6524 拆分：examples/ 目录下全部样例文档（856 个文件，中英文 README 成对同步修改）整改规则（依据产品名称映射表）： - Ascend 950PR/Ascend 950DT 系列（含衍生/简写/带空格斜杠变体）统一为 Ascend 950PR&950DT系列产品（英文：Ascend 950PR&950DT products） - Atlas A2/A3 训练系列产品与推理系列产品合并为 Atlas A2系列产品 / Atlas A3系列产品（英文：Atlas A2/A3 products） - Atlas 200I/500 A2 推理产品、Atlas 推理/训练系列产品（含 AI Core / Vector Core 场景）去空格 - 同名并列对按合并语义收敛为单一规范名（如 Atlas A3 products/Atlas A3 products -> Atlas A3 products） ## 关联的Issue 无 ## 测试 - 全量改动已在 #6524 上通过完整 CI（compile 流水线 ci-pipeline-passed），本 PR 为其按目录拆分的等价子集 - 旧名称形式残留为 0、叠字残留为 0；图片路径与文件链接未做任何改动 ## 文档更新本 PR 为文档产品名称整改 ## 类型标签 - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!6571	30 days ago

Ascend C Examples

English | 简体中文

This directory provides usage examples for different Ascend C programming modes, covering basic invocation, debugging tools, features, API libraries, performance practices, and other content.

Example List

Directory Name	Description
01_simd_cpp_api	Ascend C C++ API examples, covering getting started, tools, features, API libraries, best practices, compatibility references, and Tensor API programming samples
02_simd_c_api	Ascend C C API examples, covering basic invocation, tool capabilities, and API features
03_simt_api	Ascend C SIMT programming examples, covering getting started, debugging tools, core features, and practice references
04_aicpu	Ascend C AICPU programming examples, covering getting started and features
05_simd_simt_hybrid	Ascend C SIMD and SIMT hybrid programming examples, covering getting started and high-performance optimization examples

npu-arch Build Option Description

Developers need to modify the --npu-arch build option in the CMakeLists.txt file under the specific example directory according to the actual execution environment. The correspondence between product models and npu-arch parameters is as follows.

Product Model	npu-arch Parameter
Ascend 950PR&950DT products	--npu-arch=dav-3510
Atlas A3 products Atlas A2 products	--npu-arch=dav-2201
Atlas Inference Series Products AI Core	--npu-arch=dav-2002