cann-robotdocs: 重写Log1p/Rsqrt/Sin/MaskedScale/RsqrtGrad算子README为算子级文档，去除与aclnn API文档重复内容；修正RsqrtGrad复制自SqrtGrad未改名问题，fix #3606

67426260创建于 2 天前历史提交

文件	最后提交记录	最后更新时间
docs	根据markdownlint规范修正md写作问题和link失效 Co-authored-by: gitcode-chenjiao<chenjiao31@huawei.com> # message auto-generated for no-merge-commit merge: !6398 merge master into master 根据markdownlint规范修正md写作问题和link失效 Created-by: gitcode-chenjiao Commit-by: gitcode-chenjiao Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 根据markdownlint规范修正md写作问题和link失效 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> [#2272](https://gitcode.com/cann/ops-math/issues/2272) ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ok ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 所有md ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6398	3 天前
examples	Sin示例改用C++ RAII资源管理，与IsFinite/IsInf示例风格对齐 Co-authored-by: chendunyang<chendunyang1@huawei.com> # message auto-generated for no-merge-commit merge: !4868 merge codex/replay-pr-4752-raii-sin into master Sin示例改用C++ RAII资源管理，与IsFinite/IsInf示例风格对齐 Created-by: qq_37913898 Commit-by: chendunyang Merged-by: cann-robot Description: ## 描述将 `math/sin/examples` 下的 aclnn 示例由手动资源管理改为 C++ RAII 管理，与同仓 `math/is_finite`、`math/is_inf` 示例风格保持一致。 ## 测试未在 Ascend 环境实际编译运行；改动结构与已合并的 `is_inf`（PR #4531）一致。 ## 文档更新无。 ## 类型标签 - [x] 其他，请描述：示例代码改造（C++ RAII资源管理） See merge request: cann/ops-math!4868	1 个月前
framework	迁移开源TF插件--math Co-authored-by: yaochen<yaochen15@huawei.com> # message auto-generated for no-merge-commit merge: !4308 merge transfer-math into master 迁移开源TF插件--math Created-by: nextyale Commit-by: yaochen Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：迁移TF插件 See merge request: cann/ops-math!4308	2 个月前
op_api	refactor: 完成公共头文件迁移并修复关联验证问题 Co-authored-by: clinglai0517<laichangling@huawei.com> # message auto-generated for no-merge-commit merge: !6400 merge refactor/math-prefix-common-headers-1015 into master refactor: 完成公共头文件迁移并修复关联验证问题 Created-by: clinglai0517 Commit-by: clinglai0517 Merged-by: cann-robot Description: ## 描述完成 ops-math 剩余公共头文件引用迁移，清理会与其他算子仓同名的兼容转发头。迁移同时触发此前暂缓算子的构建和冒烟，因此一并修复已复现的 UT 状态污染、SDK 类型冲突及示例 executor 生命周期问题。 - 将 Sin 的引用改为 `op_api/level2_base_math.h`，将 experimental Atan2、Tile、Polar 的引用改为 `op_api/op_api_def_math.h`。 - 全仓审计确认 `level2_base.h`、`level2_base_caculation.h`、`op_api_def.h` 的引用均为 0，删除这三个兼容转发头；清理 `classify_rule.yaml` 中两条失效路径，保留现有 canonical 头文件分类。分类配置不作为包过滤规则。 - Sin、Atan2 的每个 UT 用例保存并恢复平台 stub 的原始 SoC 和架构覆盖字段，避免负向 BF16 用例污染后续测试；保留全部原有用例和预期。 - Tile 删除与新版 SDK 冲突的全局 `complex64 = uint64_t` 别名，在 kernel 入口为 complex64 输入局部选择 `uint64_t`，保持原有按 64 位原始数据复制的行为。 - Polar 的两个示例在重复调用前显式启用 executor 复用，结束后销毁 executor；检查同步和结果拷贝错误，将精度失败和用例失败传递为非零退出码。保留原有五组形状、warmup 次数、计时次数和精度阈值。共 14 个文件，+192/-201。所改文件包含 pre-commit 要求的 clang-format 18.1.8 调整，其中 `tile.h` 的 171 行 diff 主要为格式变化；已与格式化后的基线逐项比较，该头文件的逻辑改动仅删除五行旧类型别名块。 ## 关联的Issue Issue [#3243](https://gitcode.com/cann/ops-math/issues/3243)。 ## 测试验证环境：CANN 9.0.0，aarch64 / Ascend910B3。 - 全部 11 个修改的现有文件通过容器 pre-commit 和显式 OAT；`git diff --check`、旧头文件零引用审计通过。 - Sin：32/32 focused UT；sin/sub/tan/tanh_grad 组合正常顺序和随机顺序（seed 17）均 116/116 通过。未修复的干净基线可复现相同 5 个 BF16 失败。 - Atan2：21/21 focused UT；atan/atan2/cross 组合正常顺序和随机顺序（seed 17）均 51/51 通过。 - 当前完整 diff 经仓库 CI 生成器选择的以下命令全部通过： `bash bash build.sh -u -j16 --experimental --ops=atan2,polar,tile --opapi --soc=ascend910b bash build.sh -u -j16 --experimental --ops=tile --opkernel --soc=ascend910b bash build.sh --pkg -j16 --experimental --vendor_name=experimental --ops=atan2,polar,tile` - 上述 op_api UT 为 23/23（Atan2 21 个、Repeat 2 个；Polar 无 op_api UT）；Tile kernel UT 为 3/3，三组比较均 `max_diff=0.0`。 - 三算子实验包构建及只读完整性校验 `--check --noexec` 通过。检查实际包内容：含公开 API 头、`libcust_opapi.so`、3 个 Atan2 / 1 个 Polar / 24 个 Tile kernel 对象，不含三个旧公共头。实际 Polar 对象依赖 canonical 头文件。 - Tile 在 NPU 1 上完成 float32 和三组 complex64 实机检查，输出逐位一致，覆盖负零、NaN、无穷及次正规数。 - Polar 两个示例各 5/5 实机用例通过，所有元素错误计数为 0；原始 REF 示例在相同自定义库下用 GDB 复现 `malloc_consolidate(): unaligned fastbin chunk detected` / SIGABRT。两个示例均按 CI 的 `-lcust_opapi` 方式链接，不将 REF 文件名视为系统库对照。 - 实机 Polar 验证副本仅将设备常量从 0 改为 1，以避开 NPU 0 已有进程数限制；仓内示例仍使用设备 0。验证后源码 SHA256 和容器 vendor 配置均未改变，使用包的 staging 目录，无需安装到 SDK。验证边界：以上为 CANN 9.0.0 本地容器结果，CANN 9.3 双架构 CI 和 A2 PreSmoke 待线上验证。全量常规 `--pkg` 构建仍被未修改的 `conversion/concat_d/op_graph/fusion_pass/concat_to_concatd_fusion_pass.cpp` 与 CANN 9.0 GE `SubgraphRewriter::Replace` 参数不匹配阻塞；干净基线翻译单元使用相同参数可复现，三算子实验包已通过。 ## 文档更新无仓内文档变更；变更范围、历史问题、验证结果及限制已汇总于本 MR 描述。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：公共头文件引用迁移与兼容转发头清理 See merge request: cann/ops-math!6400	2 天前
op_graph	select、selectv2、sin、log1p算子支持下一代实现 Co-authored-by: Huang-Peng<huangpeng98@huawei.com> # message auto-generated for no-merge-commit merge: !490 merge master into master select、selectv2、sin、log1p算子支持下一代实现 Created-by: Huang-Peng Commit-by: Huang-Peng Merged-by: cann-robot Description: ## 描述 select、selectv2、sin、log1p算子支持下一代实现 ## 关联的Issue 不涉及 ## 测试已通过编译测试、二级冒烟测试 ## 文档更新不涉及 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!490	9 个月前
op_host	适配350 Co-authored-by: zhouliang<zhouliang88@huawei.com> # message auto-generated for no-merge-commit merge: !5328 merge master into master 适配350 Created-by: zhou-liang1027 Commit-by: zhouliang Merged-by: cann-robot Description: ## 描述 cos等算子在350平台适配 ## 关联的Issue https://gitcode.com/cann/ops-math/issues/3064 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!5328	1 个月前
op_kernel	批量算子使用elewise16B接口 Co-authored-by: ligen<ligen75@h-partners.com> # message auto-generated for no-merge-commit merge: !4390 merge master into master 批量算子使用elewise16B接口 Created-by: ligen75 Commit-by: ligen Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> elewise算子使用elewise16B接口 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> https://gitcode.com/cann/ops-math/issues/2493 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 自验通过 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!4390	2 个月前
tests	refactor: 完成公共头文件迁移并修复关联验证问题 Co-authored-by: clinglai0517<laichangling@huawei.com> # message auto-generated for no-merge-commit merge: !6400 merge refactor/math-prefix-common-headers-1015 into master refactor: 完成公共头文件迁移并修复关联验证问题 Created-by: clinglai0517 Commit-by: clinglai0517 Merged-by: cann-robot Description: ## 描述完成 ops-math 剩余公共头文件引用迁移，清理会与其他算子仓同名的兼容转发头。迁移同时触发此前暂缓算子的构建和冒烟，因此一并修复已复现的 UT 状态污染、SDK 类型冲突及示例 executor 生命周期问题。 - 将 Sin 的引用改为 `op_api/level2_base_math.h`，将 experimental Atan2、Tile、Polar 的引用改为 `op_api/op_api_def_math.h`。 - 全仓审计确认 `level2_base.h`、`level2_base_caculation.h`、`op_api_def.h` 的引用均为 0，删除这三个兼容转发头；清理 `classify_rule.yaml` 中两条失效路径，保留现有 canonical 头文件分类。分类配置不作为包过滤规则。 - Sin、Atan2 的每个 UT 用例保存并恢复平台 stub 的原始 SoC 和架构覆盖字段，避免负向 BF16 用例污染后续测试；保留全部原有用例和预期。 - Tile 删除与新版 SDK 冲突的全局 `complex64 = uint64_t` 别名，在 kernel 入口为 complex64 输入局部选择 `uint64_t`，保持原有按 64 位原始数据复制的行为。 - Polar 的两个示例在重复调用前显式启用 executor 复用，结束后销毁 executor；检查同步和结果拷贝错误，将精度失败和用例失败传递为非零退出码。保留原有五组形状、warmup 次数、计时次数和精度阈值。共 14 个文件，+192/-201。所改文件包含 pre-commit 要求的 clang-format 18.1.8 调整，其中 `tile.h` 的 171 行 diff 主要为格式变化；已与格式化后的基线逐项比较，该头文件的逻辑改动仅删除五行旧类型别名块。 ## 关联的Issue Issue [#3243](https://gitcode.com/cann/ops-math/issues/3243)。 ## 测试验证环境：CANN 9.0.0，aarch64 / Ascend910B3。 - 全部 11 个修改的现有文件通过容器 pre-commit 和显式 OAT；`git diff --check`、旧头文件零引用审计通过。 - Sin：32/32 focused UT；sin/sub/tan/tanh_grad 组合正常顺序和随机顺序（seed 17）均 116/116 通过。未修复的干净基线可复现相同 5 个 BF16 失败。 - Atan2：21/21 focused UT；atan/atan2/cross 组合正常顺序和随机顺序（seed 17）均 51/51 通过。 - 当前完整 diff 经仓库 CI 生成器选择的以下命令全部通过： `bash bash build.sh -u -j16 --experimental --ops=atan2,polar,tile --opapi --soc=ascend910b bash build.sh -u -j16 --experimental --ops=tile --opkernel --soc=ascend910b bash build.sh --pkg -j16 --experimental --vendor_name=experimental --ops=atan2,polar,tile` - 上述 op_api UT 为 23/23（Atan2 21 个、Repeat 2 个；Polar 无 op_api UT）；Tile kernel UT 为 3/3，三组比较均 `max_diff=0.0`。 - 三算子实验包构建及只读完整性校验 `--check --noexec` 通过。检查实际包内容：含公开 API 头、`libcust_opapi.so`、3 个 Atan2 / 1 个 Polar / 24 个 Tile kernel 对象，不含三个旧公共头。实际 Polar 对象依赖 canonical 头文件。 - Tile 在 NPU 1 上完成 float32 和三组 complex64 实机检查，输出逐位一致，覆盖负零、NaN、无穷及次正规数。 - Polar 两个示例各 5/5 实机用例通过，所有元素错误计数为 0；原始 REF 示例在相同自定义库下用 GDB 复现 `malloc_consolidate(): unaligned fastbin chunk detected` / SIGABRT。两个示例均按 CI 的 `-lcust_opapi` 方式链接，不将 REF 文件名视为系统库对照。 - 实机 Polar 验证副本仅将设备常量从 0 改为 1，以避开 NPU 0 已有进程数限制；仓内示例仍使用设备 0。验证后源码 SHA256 和容器 vendor 配置均未改变，使用包的 staging 目录，无需安装到 SDK。验证边界：以上为 CANN 9.0.0 本地容器结果，CANN 9.3 双架构 CI 和 A2 PreSmoke 待线上验证。全量常规 `--pkg` 构建仍被未修改的 `conversion/concat_d/op_graph/fusion_pass/concat_to_concatd_fusion_pass.cpp` 与 CANN 9.0 GE `SubgraphRewriter::Replace` 参数不匹配阻塞；干净基线翻译单元使用相同参数可复现，三算子实验包已通过。 ## 文档更新无仓内文档变更；变更范围、历史问题、验证结果及限制已汇总于本 MR 描述。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [x] 其他，请描述：公共头文件引用迁移与兼容转发头清理 See merge request: cann/ops-math!6400	2 天前
CMakeLists.txt	适配350 Co-authored-by: zhouliang<zhouliang88@huawei.com> # message auto-generated for no-merge-commit merge: !5328 merge master into master 适配350 Created-by: zhou-liang1027 Commit-by: zhouliang Merged-by: cann-robot Description: ## 描述 cos等算子在350平台适配 ## 关联的Issue https://gitcode.com/cann/ops-math/issues/3064 ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!5328	1 个月前
README.md	docs: 重写Log1p/Rsqrt/Sin/MaskedScale/RsqrtGrad算子README为算子级文档，去除与aclnn API文档重复内容；修正RsqrtGrad复制自SqrtGrad未改名问题，fix#3606 Co-authored-by: ywx1080114<yuanbin22@huawei.com> # message auto-generated for no-merge-commit merge: !6402 merge doc-readme-dedup-fix into master docs: 重写Log1p/Rsqrt/Sin/MaskedScale/RsqrtGrad算子README为算子级文档，去除与aclnn API文档重复内容；修正RsqrtGrad复制自SqrtGrad未改名问题，fix#3606 Created-by: yuanbin_22 Commit-by: ywx1080114 Merged-by: cann-robot Description: ## 描述将 5 个算子的 README 重写为算子级文档（功能说明/参数说明/约束说明/调用说明），去除与 docs/ 下 aclnn API 文档重复的函数原型、两段式接口参数说明、返回值与错误码内容（fix #3606）；并修正 RsqrtGrad README 复制自 SqrtGrad 未改名的问题。 ### 1. README 重写为算子级文档（去除与 aclnn API 文档重复内容） - math/log1p/README.md（+44 -85）：标题 `aclnnLog1p&aclnnInplaceLog1p` → `Log1p`；删除函数原型与 aclnnLog1p/aclnnInplaceLog1p 两段式接口详细说明；新增参数说明表（x/y：FLOAT、FLOAT16、BFLOAT16，与 log1p_def.cpp 一致）；调用说明指向 examples 与 docs/aclnnLog1p&aclnnInplaceLog1p.md。 - math/rsqrt/README.md（+43 -85）：同上模式重写，计算公式 `y = 1/√x`，参数 x/y：FLOAT、FLOAT16、BFLOAT16。 - math/sin/README.md（+4 -75）：参数名规范化（`self`→`x`、`out`→`y`）；删除 aclnnSin/aclnnInplaceSin 两段式接口详细说明；保留 BFLOAT16 支持范围备注。 - math/masked_scale/README.md（+56 -50）：新增参数说明表（x/y：FLOAT16、BFLOAT16、FLOAT；mask：INT8、UINT8、FLOAT16、FLOAT；scale 属性：FLOAT）；公式变量名与参数表对齐（`self`→`x`、`out`→`y`）。 - math/rsqrt_grad/README.md（+15 -13）：重写为算子级文档并修正复制错误（见下）。 ### 2. 修正 RsqrtGrad 复制自 SqrtGrad 未改名问题 - README.md： - 标题 `SqrtGrad` → `RsqrtGrad`；算子功能「完成梯度平方根计算」→「Rsqrt算子的反向梯度计算」 - 计算公式 `z = dy * 0.5 / y` → `z = -0.5 × dy × y³`（y 为 Rsqrt 前向输出） - 参数数据类型由 SqrtGrad 的 DT_FLOAT/DT_FLOAT_16/DT_COMPLEX128/DT_COMPLEX64/DT_DOUBLE 修正为 BFLOAT16、FLOAT16、FLOAT、INT8、INT32（与 rsqrt_grad_def.cpp 的 DataType 声明一致） - 产品支持修正为 Ascend 950PR&950DT `√` / Atlas A3 `×` / Atlas A2 `×`（rsqrt_grad_def.cpp 仅 AddConfig ascend950/ascend350） - 算子 IR 链接由 `../sqrt_grad/op_graph/sqrt_grad_proto.h` 修正为 `../op_graph/rsqrt_grad_proto.h` - examples/test_geir_sqrt_grad.cpp → test_geir_rsqrt_grad.cpp（重命名，R095）：include 的 proto 头文件、宏内变量名 `sqrtGrad`→`rsqrtGrad` 等同步修正。 ## 关联的Issue - #3606 ## 测试 - 纯文档与示例代码改名变更，无算子逻辑修改，不涉及编译与功能测试 - 已核对 log1p_def.cpp / rsqrt_grad_def.cpp 的 DataType 与 AICore AddConfig 声明，确认 README 中数据类型与产品支持情况与代码一致 ## 文档更新 - math/log1p/README.md - math/rsqrt/README.md - math/sin/README.md - math/masked_scale/README.md - math/rsqrt_grad/README.md - math/rsqrt_grad/examples/test_geir_sqrt_grad.cpp → test_geir_rsqrt_grad.cpp（重命名） ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6402	2 天前

Sin

产品支持情况

产品	是否支持
Ascend 950PR&950DT系列产品	√
Atlas A3系列产品	√
Atlas A2系列产品	√
Atlas 200I/500 A2推理产品	√
Atlas推理系列产品	√
Atlas训练系列产品	√

功能说明

算子功能：对输入矩阵的每个元素进行正弦操作后输出。
计算公式：

out_{i}=sin(input_{i})

参数说明

参数名	输入/输出/属性	描述	数据类型	数据格式
x	输入	待进行sin计算的入参，公式中的input_i。	FLOAT、FLOAT16、BFLOAT16	ND
y	输出	待进行sin计算的出参，公式中的out_i。	FLOAT、FLOAT16、BFLOAT16	ND

Atlas 200I/500 A2推理产品、Atlas推理系列产品、Atlas训练系列产品：不支持BFLOAT16。

约束说明

Atlas A2系列产品、Atlas A3系列产品：FLOAT、FLOAT16、BFLOAT16数据类型的输入数据范围为[-10^7, 10^7]时满足精度要求，超过数值范围无法保证，请使用CPU进行计算。
Atlas推理系列产品：FLOAT、FLOAT16数据类型的输入数据范围为[-65504, 65504]时满足精度要求，超过数值范围无法保证，请使用CPU进行计算。

调用说明

调用方式	调用样例	说明
aclnn调用	test_aclnn_sin	通过aclnnSin接口方式调用Sin算子。