cann-robotdocs(math): 统一 Abs、AbsGrad 和 Sum 文档说明

文件	最后提交记录	最后更新时间
op_graph	针对math仓部分算子存在错误日志问题进行统一修改 Co-authored-by: qq_52874943<gaomingyuan3@h-partners.com> # message auto-generated for no-merge-commit merge: !5114 merge master into master 针对math仓部分算子存在错误日志问题进行统一修改 Created-by: qq_52874943 Commit-by: qq_52874943 Merged-by: cann-robot Description: ## 描述本 PR 针对 math 仓部分算子（abs、abs_grad、complex_abs）存在的错误日志不规范问题（错误场景误用 INFO 级别日志）进行统一修改：将错误日志统一调整为 ERROR 级别，并改用统一的错误日志宏（如 OP_LOGE_FOR_INVALID_DTYPE、OP_LOGE_FOR_INVALID_SHAPES_WITH_REASON）输出带算子名与具体原因的报错信息；同时为 AbsGrad 补充了 shape 一致性校验、将 infershape 由广播语义改为逐元素语义，并更新了相关算子的 proto 注释说明。 ## 关联的Issue 关联Issue[#2853](https://gitcode.com/cann/ops-math/issues/2853) ## 测试本地已完成新精度对比与性能测试，通过静态检查、蓝区冒烟、算子ST以及算子二级冒烟。 ## 文档更新修正文档中算子命名不规范问题，打开Ascend950支持选项。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!5114	1 个月前
op_host	针对math仓部分算子存在错误日志问题进行统一修改 Co-authored-by: qq_52874943<gaomingyuan3@h-partners.com> # message auto-generated for no-merge-commit merge: !5114 merge master into master 针对math仓部分算子存在错误日志问题进行统一修改 Created-by: qq_52874943 Commit-by: qq_52874943 Merged-by: cann-robot Description: ## 描述本 PR 针对 math 仓部分算子（abs、abs_grad、complex_abs）存在的错误日志不规范问题（错误场景误用 INFO 级别日志）进行统一修改：将错误日志统一调整为 ERROR 级别，并改用统一的错误日志宏（如 OP_LOGE_FOR_INVALID_DTYPE、OP_LOGE_FOR_INVALID_SHAPES_WITH_REASON）输出带算子名与具体原因的报错信息；同时为 AbsGrad 补充了 shape 一致性校验、将 infershape 由广播语义改为逐元素语义，并更新了相关算子的 proto 注释说明。 ## 关联的Issue 关联Issue[#2853](https://gitcode.com/cann/ops-math/issues/2853) ## 测试本地已完成新精度对比与性能测试，通过静态检查、蓝区冒烟、算子ST以及算子二级冒烟。 ## 文档更新修正文档中算子命名不规范问题，打开Ascend950支持选项。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!5114	1 个月前
op_kernel	refactor: 将arch35算子kernel中MicroAPI接口统一迁移为Reg接口 Co-authored-by: tianqiguang<tianqiguang@huawei.com> # message auto-generated for no-merge-commit merge: !4187 merge master into master refactor: 将arch35算子kernel中MicroAPI接口统一迁移为Reg接口 Created-by: tianqiguang Commit-by: tianqiguang Merged-by: cann-robot Description: ## 描述将 math 模块下 80+ 算子的 arch35 kernel 实现从 MicroAPI 接口迁移为 Reg（寄存器）接口，统一编程范式。 ### 改动范围涉及算子: abs, abs_grad, add_n, adjacent_difference, arg_max_with_value, assign_add, assign_sub, atan2, bitwise_xor, cast, cdist, cdist_grad, ceil, complex_abs, cummin, cumsum, div, dot, exp, eye, floor, floor_div, floor_mod, fused_mul_add_n, grouped_bias_add_grad, inv, is_close, kth_value, lerp, lin_space, log, log1p, logical_or, mod, nan_to_num, neg, pow, power, reciprocal, reduce_all, reduce_any, reduce_log_sum_exp, reduce_nansum, reduce_prod, reduce_var, right_shift, rint, round, rsqrt, rsqrt_grad, sign, signbit, sinh, sort, sort_with_index, tanh, tanh_grad, tensor_equal, top_k_v2, trunc, truncate_div 等 ### 改动方式 - 将 MicroAPI 调用替换为等价 Reg API 调用 - 适配 arch35（ascend950）指令集特性 - 保持算子功能不变 ## 测试 - 涉及算子全量回归测试 ## 类型标签 - [x] 重构 ## 关联的Issue - #2295 See merge request: cann/ops-math!4187	2 个月前
tests	math仓补充算子golden Co-authored-by: qq_52874943<gaomingyuan3@h-partners.com> # message auto-generated for no-merge-commit merge: !5348 merge master into master math仓补充算子golden Created-by: qq_52874943 Commit-by: qq_52874943 Merged-by: cann-robot Description: ## 描述本 PR 旨在为 math 仓的算子补充 golden（参考实现）测试资产，通过在每个算子的 tests/assets/ 目录下新增 golden.py 脚本并利用 __golden__ 字典将算子内核名映射到对应的 golden 函数，供算子精度校验使用。本次改动共涉及 4 个文件、新增 88 行代码（无删除），其中已附补丁的包括 abs_grad 与 complex_abs 两个算子的 golden 实现，其余变更文件未提供补丁内容。 ## 关联的Issue 关联Issue[#3026](https://gitcode.com/cann/ops-math/issues/3026) ## 测试本地已完成新精度对比与性能测试，通过静态检查、蓝区冒烟、算子ST以及算子二级冒烟。 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!5348	24 天前
CMakeLists.txt	math仓新增abs_grad支持david Co-authored-by: qq_52874943<gaomingyuan3@h-partners.com> # message auto-generated for no-merge-commit merge: !3848 merge master into master math仓新增abs_grad支持david Created-by: qq_52874943 Commit-by: qq_52874943 Merged-by: cann-robot Description: ## 描述 math仓新增abs_grad支持david。 ## 关联的Issue 关联Issue[#2241](https://gitcode.com/cann/ops-math/issues/2241) ## 测试本地已完成新精度对比与性能测试，通过静态检查、蓝区冒烟、算子ST以及算子二级冒烟。 ## 文档更新修正文档中算子命名不规范问题，打开Ascend950支持选项。 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!3848	2 个月前
README.md	docs(math): 统一 Abs、AbsGrad 和 Sum 文档说明 Co-authored-by: chensi79<chensi79@huawei.com> # message auto-generated for no-merge-commit merge: !5603 merge fix/issues-3123-3130-api-docs-20260911T030827Z into master docs(math): 统一 Abs、AbsGrad 和 Sum 文档说明 Created-by: chensi79 Commit-by: chensi79 Merged-by: cann-robot Description: ## 描述 Abs 与 AbsGrad README 中的公式变量和参数表不一致，Abs README 遗漏了旧 Atlas 产品的复数类型限制，aclnnSum 文档缺少求和公式。本次统一参数符号、修正中文冒号和重复约束，并按现有广播规则补充求和公式。 ## 关联的Issue Closes #3123 Closes #3124 Closes #3125 Closes #3126 Closes #3128 Closes #3129 Closes #3130 ## 测试 - 对照 Issue 附图、固定基线源码及接口声明，静态确认七项文档问题。 - 检查修正后的公式与参数名、旧平台类型限制、HTML 表格及本地链接。 - `git diff --check` 通过。 - 仅修改 Markdown 文档，未执行算子构建或 NPU 测试。 ## 文档更新 - `math/abs/README.md`：公式统一使用 self/out，修正冒号，补齐旧 Atlas 产品不支持的复数类型。 - `math/abs_grad/README.md`：公式输出改为 z，参数表下标正确呈现，合并同类型约束。 - `math/accumulate_nv2/docs/aclnnSum.md`：补充逐元素广播求和公式及 tensors/out 映射。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!5603	17 天前

AbsGrad

产品支持情况

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

功能说明

算子功能：计算绝对值函数（Abs）的梯度。根据前向输入张量y和上游梯度dy，计算下游梯度z。
计算公式：

zi=dyi×sign(yi)z_i=dy_i \times sign(y_i)

参数说明

参数名	输入/输出/属性	描述	数据类型	数据格式
y	输入	原始Abs算子的输入，公式中的y_i。	BFLOAT16、FLOAT16、FLOAT	ND
dy	输入	Abs算子输出的上游梯度，公式中的dy_i。	BFLOAT16、FLOAT16、FLOAT	ND
z	输出	Abs算子输入的下游梯度，公式中的z_i。	BFLOAT16、FLOAT16、FLOAT	ND

Atlas 训练系列产品、Atlas 推理系列产品: 不支持BFLOAT16。

约束说明

y、dy和z的数据类型需相同。
所有输入和输出的shape不能包含0（不支持空tensor）。

第三方框架兼容性

与TensorFlow的AbsGrad算子兼容。

调用说明

调用方式	调用样例	说明
图模式调用	-	通过算子IR构图方式调用AbsGrad算子。