cann-robotdocs: AddExample 两种示例原型注释误称仅支持 FLOAT32

文件	最后提交记录	最后更新时间
add_example	docs: AddExample 两种示例原型注释误称仅支持 FLOAT32 Co-authored-by: Ethan_Zou<tianjun.zou@foxmail.com> # message auto-generated for no-merge-commit merge: !6300 merge docs/b6-math-add-example-proto-integer-20261013 into master docs: AddExample 两种示例原型注释误称仅支持 FLOAT32 Created-by: Ethan_Zou Commit-by: Ethan_Zou Merged-by: cann-robot Description: ## 描述 AICore和AICPU AddExample三个Tensor说明均称只能FLOAT32，而两份同目录REG_OP实际支持FLOAT32与INT32；对应OpDef与示例实现也有整数路径。作为新算子开发模板，该复制注释会让贡献者遗漏已有整数接口能力。两种示例的输入/输出类型文字统一为float32或int32，同源模板问题合并一组，不修改注册和执行实现。 ## 关联的Issue Fixes #3544 https://gitcode.com/cann/ops-math/issues/3544 ## 测试依据同一源码基线的 REG_OP / OpDef / README 交叉核对文档参数、属性与计算语义；修复只改注释。最终 pre-commit 字节已复核：基线注释不满足注册契约，修复后一致；去除注释后的C++ token序列完全相同。具体注册片段、交叉引用行号和检查日志见 data/b6-math-add-example-proto-integer-contract-static.txt。以本 case 干净基线执行适用 pre-commit hooks 与 diff --check 通过。本地无 NPU；此修复只改文档注释，不宣称完成 GE 图构建或设备执行。 ## 文档更新本 PR 修正文档中的已复现问题，修改范围见当前 diff。 ## 类型标签 - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： ## AI 使用声明使用 AI 辅助核查和准备修复；由 Ethan_Zou 提交。每个 PR 保持一个提交。 ## AI 参与使用 OpenAI Codex（GPT-6 系列）审查代码与文档，在 Host 侧复现、核对已有报告并准备修复。提交者账号为 Ethan_Zou。 See merge request: cann/ops-math!6300	5 天前
add_example_aicpu	docs: AddExample 两种示例原型注释误称仅支持 FLOAT32 Co-authored-by: Ethan_Zou<tianjun.zou@foxmail.com> # message auto-generated for no-merge-commit merge: !6300 merge docs/b6-math-add-example-proto-integer-20261013 into master docs: AddExample 两种示例原型注释误称仅支持 FLOAT32 Created-by: Ethan_Zou Commit-by: Ethan_Zou Merged-by: cann-robot Description: ## 描述 AICore和AICPU AddExample三个Tensor说明均称只能FLOAT32，而两份同目录REG_OP实际支持FLOAT32与INT32；对应OpDef与示例实现也有整数路径。作为新算子开发模板，该复制注释会让贡献者遗漏已有整数接口能力。两种示例的输入/输出类型文字统一为float32或int32，同源模板问题合并一组，不修改注册和执行实现。 ## 关联的Issue Fixes #3544 https://gitcode.com/cann/ops-math/issues/3544 ## 测试依据同一源码基线的 REG_OP / OpDef / README 交叉核对文档参数、属性与计算语义；修复只改注释。最终 pre-commit 字节已复核：基线注释不满足注册契约，修复后一致；去除注释后的C++ token序列完全相同。具体注册片段、交叉引用行号和检查日志见 data/b6-math-add-example-proto-integer-contract-static.txt。以本 case 干净基线执行适用 pre-commit hooks 与 diff --check 通过。本地无 NPU；此修复只改文档注释，不宣称完成 GE 图构建或设备执行。 ## 文档更新本 PR 修正文档中的已复现问题，修改范围见当前 diff。 ## 类型标签 - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： ## AI 使用声明使用 AI 辅助核查和准备修复；由 Ethan_Zou 提交。每个 PR 保持一个提交。 ## AI 参与使用 OpenAI Codex（GPT-6 系列）审查代码与文档，在 Host 侧复现、核对已有报告并准备修复。提交者账号为 Ethan_Zou。 See merge request: cann/ops-math!6300	5 天前
add_example_c_api	产品名变更 Co-authored-by: gitcode-chenjiao<chenjiao31@huawei.com> # message auto-generated for no-merge-commit merge: !5912 merge master into master 产品名变更 Created-by: gitcode-chenjiao Commit-by: gitcode-chenjiao Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> AI处理器对应的产品型号名称更新 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> [#3258](https://gitcode.com/cann/ops-math/issues/3258) ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ok ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> *.md ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!5912	27 天前
add_example_pypto	support compile pypto-pro op in ops-math Co-authored-by: sunhaoxuan2024<sunhaoxuan3@h-partners.com> # message auto-generated for no-merge-commit merge: !5276 merge pr-pypto-math into master support compile pypto-pro op in ops-math Created-by: h9718w Commit-by: sunhaoxuan2024 Merged-by: cann-robot Description: 移植 PyPTO 支持到 ops-math，包括 cmake/func.cmake、cmake/gen_ops_info.cmake、scripts/util/ascendc_impl_build.py、scripts/util/pypto_codegen.py 及示例算子 examples/pypto_add_example See merge request: cann/ops-math!5276	1 个月前
fast_kernel_launch_example	link修改commerical为community Co-authored-by: gitcode-chenjiao<chenjiao31@huawei.com> # message auto-generated for no-merge-commit merge: !3874 merge master into master link修改commerical为community Created-by: gitcode-chenjiao Commit-by: gitcode-chenjiao Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 变更点： ① torch_npu名称合一TorchNPU ②《acl API》手册更名修改 ③ link修改commerical为community ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> [#2168](https://gitcode.com/cann/ops-math/issues/2168) ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ok ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 所有md ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!3874	3 个月前
CMakeLists.txt	【描述】解决_add_example_aicpu eager模式下头文件找不到 Co-authored-by: j00427146<jialimin1@huawei.com> # message auto-generated for no-merge-commit merge: !2396 merge issue_1332 into master 【描述】解决_add_example_aicpu eager模式下头文件找不到 Created-by: jialimin1 Commit-by: j00427146 Merged-by: cann-robot Description: ## 描述 1、解add_example_aicpu eager模式下头文件找不到问题 2、修改aclnnLeftShift、aclnnLeftShifts、aclnnTriangularSolve确定性计算说明 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue Issue##1332 <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> ## 测试修复前： ![image.png](https://raw.gitcode.com/user-images/assets/7649531/5a6c7b8b-6850-46e5-9a5c-a8432396b480/image.png 'image.png') 修复后： ![image.png](https://raw.gitcode.com/user-images/assets/7649531/5e847575-51d8-4e10-908a-ef1c4c74a924/image.png 'image.png') <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!2396	5 个月前
README.md	docs: 修复 issue #1618 反馈的三处文档不一致 Co-authored-by: chensi79@huawei.com<chensi79@huawei.com> # message auto-generated for no-merge-commit merge: !4024 merge fix/issue-1618-docs-fixes into master docs: 修复 issue #1618 反馈的三处文档不一致 Created-by: chensi79 Commit-by: chensi79@huawei.com Merged-by: cann-robot Description: ## 描述本 PR 修复 Issue #1618 反馈的三处文档不一致问题，全部为纯文档修改，不涉及代码逻辑： - `examples/README.md`：在"目录说明"的目录树中补全 `fast_kernel_launch_example` 子目录，使其与下方样例表格保持一致。 - `docs/zh/develop/aicpu_develop_guide.md`：修正第 140 行链接，URL 由 `add_example.json` 改为 `add_example_aicpu.cpp`，与链接文本保持一致（链接目标文件已在仓库中确认存在）。 - `docs/zh/install/quick_install.md`：将 `spack install` 命令中的 Spack 包名 `cann-ops` 改为 `cann-ops-math`，与 `spack/prepare_cann_env.sh` 中 `DEFAULT_PACKAGE_NAME="cann-ops-math@master +pkg"` 及同文件 `spack location -i cann-ops-math` 命令保持一致。涉及文件中由 pre-commit `trailing-whitespace` hook 自动清理了行尾空格，无功能性变更。 ## 关联的Issue https://gitcode.com/cann/ops-math/issues/1618 ## 测试纯文档修改，未涉及代码逻辑，无相关单元测试可运行；已通过以下方式人工核对： - 目录树新增行与 L44 表格描述对齐。 - `scripts/opgen/template/add_example_aicpu/op_kernel_aicpu/add_example_aicpu.cpp` 文件在仓库中确实存在。 - Spack 包名修改与 `spack/prepare_cann_env.sh` 中的 `DEFAULT_PACKAGE_NAME` 一致。 ## 文档更新 - `examples/README.md`：补全 `fast_kernel_launch_example` 子目录说明。 - `docs/zh/develop/aicpu_develop_guide.md`：修正 L140 链接 URL。 - `docs/zh/install/quick_install.md`：统一 Spack 包名。 ## 类型标签 - [x] 文档更新 See merge request: cann/ops-math!4024	3 个月前

简介

说明：

目前算子库中大部分算子运行在AI Core上，少部分算子运行在AI CPU上。默认情况下，项目中提到的算子指AI Core算子。

关于AI Core和AI CPU的介绍请参见《Ascend C算子开发》中“概念原理和术语 > 硬件架构与数据处理原理”。

本项目提供了AI Core算子和AI CPU算子的开发和调用样例，请开发者根据实际情况参考对应实现。

目录说明

├── examples
│   ├── add_example                # AI Core算子名
│   │   ├── CMakeLists.txt         # 算子编译配置文件，保留原文件即可
│   │   ├── examples               # 算子使用示例
│   │   ├── op_graph               # 算子构图相关目录
│   │   ├── op_host                # 算子信息库、Tiling、InferShape相关实现
│   │   └── op_kernel              # 算子kernel目录
│   ├── add_example_c_api          # AI Core C API算子名（使用C API/asc_simd开发kernel）
│   │   ├── CMakeLists.txt         # 算子编译配置文件，保留原文件即可
│   │   ├── examples               # 算子使用示例
│   │   ├── op_graph               # 算子构图相关目录
│   │   ├── op_host                # 算子信息库、Tiling、InferShape相关实现
│   │   └── op_kernel              # 算子kernel目录（C API风格）
│   ├── add_example_aicpu          # AI CPU算子名
│   │   ├── CMakeLists.txt         # 算子编译配置文件，保留原文件即可
│   │   ├── examples               # 算子使用示例
│   │   ├── op_graph               # 算子构图相关目录
│   │   ├── op_host                # 算子信息库、InferShape相关实现
│   │   └── op_kernel_aicpu        # 算子kernel目录
│   ├── fast_kernel_launch_example # PyTorch场景下快速端到端开发算子的样例
│   ├── CMakeLists.txt             # 算子编译配置文件，保留原文件即可
│   └── README.md                  # 算子说明文档

算子开发样例

样例目录	样例介绍	算子开发	算子调用
add_example	实现两个张量相加功能的算子。	算子端到端开发过程参见AI Core算子开发指南	调用参见README
add_example_c_api	实现两个张量相加功能的算子，kernel使用C API（asc_simd）开发方式。	算子端到端开发过程参见AI Core算子开发指南	调用参见README
add_example_aicpu	实现两个张量相加功能的算子。	算子端到端开发过程参见AI CPU算子开发指南	调用参见README
fast_kernel_launch_example	实现一种PyTorch场景下快速端到端开发算子的样例。	算子端到端开发过程参见PyTorch算子快速开发指南	调用参见README