Star0

Star0

cann-robot【docs】更新多核tiling 算子实践

068351b4创建于 8月7日历史提交

文件	最后提交记录	最后更新时间
00_framework	fix(examples): correct build settings and fp16 validation Co-authored-by: zhangyujia77<zhangyujia37@huawei.com> # message auto-generated for no-merge-commit merge: !4349 merge fix-examples into master fix(examples): correct build settings and fp16 validation Created-by: zhangyujia77 Commit-by: zhangyujia77 Merged-by: cann-robot Description: ## 描述修复examples目录中的构建配置和FP16结果校验问题： 1. 删除8个样例中重复添加的`--npu-arch=${CMAKE_ASC_ARCHITECTURES}`，统一由ASC CMake模块注入，避免编译命令重复传参。 2. 精简`ge_torchair`和`triple_chevron_notation`的链接依赖。 3. 将`aclnn_invocation`的FP16结果校验从精确比特比较改为容差比较。 ## 关联的Issue 无。 ## 测试 - 对以下8个受影响样例分别执行CMake配置和完整构建，全部通过：`ge_torchair`、`pybind`、`torch_library`、`triple_chevron_notation`、`vector_tiling_strategy`、`00_basic_compile`、`03_static_library_compile`、`matmul_aot_compilation`。 ## 文档更新无。 ## 类型标签 - [x] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [ ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4349	3 个月前
02_tiling_selector	【docs】更新多核tiling 算子实践 Co-authored-by: ning_x<chenning54@huawei.com> # message auto-generated for no-merge-commit merge: !4157 merge docs-tiling into master 【docs】更新多核tiling 算子实践 Created-by: ning_x Commit-by: ning_x Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 优化算子实践参考中的多核Tiling切分相关内容 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4157	2 个月前
04_compile	【docs】调整资料目录层级 Co-authored-by: ning_x<chenning54@huawei.com> # message auto-generated for no-merge-commit merge: !4534 merge fix_dir_level into master 【docs】调整资料目录层级 Created-by: ning_x Commit-by: ning_x Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 资料存在不能超过5级目录的约束，需要调整多个基础api资料目录的层级，并同步修改引用链接 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。例如：关联Issue #xxx--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 1. 基础API/数据结构/LocalTensor和GlobalTensor定义/LocalTensor/ → 基础API/数据结构/LocalTensor/ 2. 基础API/数据结构/LocalTensor和GlobalTensor定义/GlobalTensor/ → 基础API/数据结构/GlobalTensor/ 3. 基础API/数据结构/辅助数据结构/ → 基础API/辅助数据结构/ 包括以下子目录整体移动： - Coordinate/ - Layout/ - TensorDesc/ - TensorTrait/ 4. 基础API/工具接口/数学计算/NumericLimits/ → 基础API/工具接口/数值边界/ 5. 基础API/工具接口/数学计算/CeilDivision.md → 基础API/标量计算/CeilDivision.md 同时删除了旧目录下的索引文件： 6. 基础API/数据结构/LocalTensor和GlobalTensor定义/LocalTensor和GlobalTensor定义.md - 基础API/工具接口/数学计算/数学计算.md 另外，docs/zh/api/README.md 及相关文档中的引用路径同步更新，以匹配新的目录结构。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4534	3 个月前
05_aclrtc	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	3 个月前
06_aot_compilation	fix(examples): correct build settings and fp16 validation Co-authored-by: zhangyujia77<zhangyujia37@huawei.com> # message auto-generated for no-merge-commit merge: !4349 merge fix-examples into master fix(examples): correct build settings and fp16 validation Created-by: zhangyujia77 Commit-by: zhangyujia77 Merged-by: cann-robot Description: ## 描述修复examples目录中的构建配置和FP16结果校验问题： 1. 删除8个样例中重复添加的`--npu-arch=${CMAKE_ASC_ARCHITECTURES}`，统一由ASC CMake模块注入，避免编译命令重复传参。 2. 精简`ge_torchair`和`triple_chevron_notation`的链接依赖。 3. 将`aclnn_invocation`的FP16结果校验从精确比特比较改为容差比较。 ## 关联的Issue 无。 ## 测试 - 对以下8个受影响样例分别执行CMake配置和完整构建，全部通过：`ge_torchair`、`pybind`、`torch_library`、`triple_chevron_notation`、`vector_tiling_strategy`、`00_basic_compile`、`03_static_library_compile`、`matmul_aot_compilation`。 ## 文档更新无。 ## 类型标签 - [x] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [ ] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4349	3 个月前
99_acl_based	docs: add aclnn design implementation docs Co-authored-by: zhangyujia77<zhangyujia37@huawei.com> # message auto-generated for no-merge-commit merge: !4252 merge aclnn-design-core-docs into master docs: add aclnn design implementation docs Created-by: zhangyujia77 Commit-by: zhangyujia77 Merged-by: cann-robot Description: ## 描述本PR重构Aclnn算子工程化开发中的“设计与实现”内容，围绕算子开发流程补充算子功能设计、原型定义、Host侧Tiling、Kernel侧实现和多分支策略等文档。主要内容包括： - 补充算子功能设计方法，说明如何从计算语义确定算子原型、Tiling参数和Kernel实现。 - 补充算子原型定义，介绍输入、输出、属性、dtype/format、Follow、shape/dtype推导、Tiling函数关联及AI处理器差异化配置。 - 补充Host侧Tiling基本流程，包括TilingData、numBlocks、workspace、TilingKey和Tiling函数注册。 - 介绍通过TilingData向Kernel传递算子属性的完整流程。 - 介绍使用Matmul等高阶API时配套的Host侧Tiling和Kernel实现。 - 补充Kernel入口、参数顺序、TilingData读取及动静态场景统一访问方式。 - 介绍输出shape依赖Kernel计算结果时的原型声明和shape信息写入方式。 - 介绍通过TilingKey和Kernel模板组织多分支实现的方法。 - 补充OpType、Kernel入口和aclnn接口等名称之间的转换规则。 - 由于 SetBlockDim 接口已废弃且后续将被删除，按照接口说明，将相关样例及文档统一迁移至 SetSimdNumBlocks。 ## 关联的Issue 无。 ## 测试 ## 文档更新新增以下文档： - `设计与实现/算子功能设计.md` - `设计与实现/算子原型定义.md` - `设计与实现/Host侧Tiling实现/基本流程.md` - `设计与实现/Host侧Tiling实现/通过TilingData传递属性信息.md` - `设计与实现/Host侧Tiling实现/使用高阶API时配套的Tiling实现.md` - `设计与实现/Kernel侧算子实现/基本流程.md` - `设计与实现/Kernel侧算子实现/输出shape依赖计算.md` - `设计与实现/多分支策略.md` - `附录/命名转换规则对照表.md` ## 类型标签 - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [x] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他 See merge request: cann/asc-devkit!4252	2 个月前
README.md	add feature introduce doc for AOT Co-authored-by: wangkai<wangkai86@huawei.com> # message auto-generated for no-merge-commit merge: !4088 merge master into master add feature introduce doc for AOT Created-by: kevin365 Commit-by: wangkai Merged-by: cann-robot Description: ## 描述样例的文档增加AOT样例的目录和链接 ## 关联的Issue NA ## 测试 NA ## 文档更新更新examples/01_simd_cpp_api/02_features目录 ## 类型标签 - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [X] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4088	3 个月前
README_en.md	add feature introduce doc for AOT Co-authored-by: wangkai<wangkai86@huawei.com> # message auto-generated for no-merge-commit merge: !4088 merge master into master add feature introduce doc for AOT Created-by: kevin365 Commit-by: wangkai Merged-by: cann-robot Description: ## 描述样例的文档增加AOT样例的目录和链接 ## 关联的Issue NA ## 测试 NA ## 文档更新更新examples/01_simd_cpp_api/02_features目录 ## 类型标签 - [ ] 🐛 fix: Bug 修复 - [ ] ✨ feat: 新功能 - [ ] ⚡ perf: 性能优化 - [ ] ♻️ refactor: 代码重构 - [ ] 🧪 test: 新增或修改测试 - [X] 📝 docs: 文档更新 - [ ] 🔧 ci: CI/CD 配置修改 - [ ] ↩️ revert: 回退 - [ ] 🧹 chore: 其他，请具体描述 See merge request: cann/asc-devkit!4088	3 个月前

Features样例介绍

概述

介绍 Ascend C SIMD 特性样例，覆盖编译工程、算子调用、框架接入等场景，用于展示不同特性的典型实现方式和编译运行流程。

样例列表

目录名称	功能描述
00_framework	本样例介绍了PyTorch、TensorFlow、ONNX、GE和ACLGraph场景的自定义算子实现方法
02_tiling_selector	展示SIMD矢量计算场景下多核Tiling切分策略和Tiling参数选择方式。
04_compile	展示SIMD编译相关的特性样例。
05_aclrtc	样例主要介绍使用Aclrtc（运行时编译）接口在Host侧编译字符串形式的Ascend C核函数，并完成编译结果的加载和执行的过程
06_aot_compilation	样例主要介绍基于AOT（Ahead-of-Time）编译的性能优化方法
99_acl_based	本样例介绍了自定义算子编译工程和Aclnn/Aclop算子调用的实现方法