| docs: 修正文档并补充 CdistGrad、Lerp、Pow2 Host UT Co-authored-by: chensi79<chensi79@huawei.com> # message auto-generated for no-merge-commit merge: !7248 merge docs/issue-4535-rowspan-20261109-issue4535 into master docs: 修正文档并补充 CdistGrad、Lerp、Pow2 Host UT Created-by: chensi79 Commit-by: chensi79 Merged-by: cann-robot Description: ## 描述 错误码表中的 rowspan 大于对应错误码实际占用的表格行数,导致表格结构不匹配。按现有 tr 结构修正 44 个文档中的 46 处错误码分组、92 个单元格跨度,保留现有报错描述及列表内容。 同时修复 Lerps 标量接口的维度约束披露缺口:同步更新正式目录中英文及 experimental 中文文档,分别说明普通和原地接口的连续性条件与非连续路径 8 维上限,补充对应 161002 场景,并保持表格跨度与新增描述行一致。全部连续时仅说明第一段接口跳过此项上限检查,不承诺任意维度均可执行。 精简中英文广播规则3:说明广播轴不明确或对齐后维度不兼容时的报错条件,补充 (2,2,2) 与 (2,2) 的轴选择及 (2,3) 的不兼容示例。规则1、2及其余内容保持原文。 为 experimental/math/cdist_grad、lerp、pow2 补充 Host 形状推导 UT,共22个用例,覆盖正常及批量形状、空张量、动态维度、广播、维度不兼容和缺失输入。仅新增3个测试源文件,通过现有 CMake 自动收集,不修改门禁脚本或算子实现。 ## 关联的Issue Closes #4535 Closes #4580 Closes #3986 ## 测试 - 使用独立 HTMLParser 检查所改 44 个文档的 98 个错误码分组:修改前 92 个单元格跨度不符,修改后为 0。 - 按字节比较确认仅 rowspan 数值发生变化,保留原有换行及所有描述内容。 - git -c core.whitespace=cr-at-eol diff --check 通过(保留三个原有 CRLF 文档的换行格式)。 - 对照正式及 experimental 的 CheckShape、MAX_SUPPORT_DIMS_NUMS=8 和原地接口复用 CalculateResult(selfRef, end, weight, selfRef) 的调用,核对维度条件和 161002 返回路径。 - Lerps 三份资料共 12 个错误码分组通过 HTML 表格检查;函数原型和示例代码保持不变。此前 #4535 的 44 份资料保持不变。 - pre-commit 检查命令通过;OAT 钩子对含 & 的路径跳过扫描,不将其视为 Markdown 内容扫描覆盖。 - 原有文档内容不变,未运行设备 Kernel 数值测试。 - 新增22项 Host InferShape UT,使用真实算子推导源码、仓库 context helper/GTest 入口及 CANN 9.3.0 库定向编译运行,22/22通过;标准 CMake 的 math_op_infershape_ut_cases 目标编译通过,Check_Example 不再报告缺 UT。 - 完整 Host UT 构建在公共 opbase 依赖处因 DAV_5162/CANN 头文件版本不匹配中断;上述22项定向测试不依赖该 tiling 公共模块,不将定向通过描述为完整 Host 构建通过。 - 逐字核对确认广播文档仅规则3及其例子与修改前不同,规则1、2和其他内容一致;中英文两份文档通过 pre-commit(含 OAT)及 diff --check。 ## 文档更新 覆盖正式目录中英文及 experimental 文档;修正表格跨行布局,不将跨度差解释为 API 报错场景缺失。另补充 aclnnLerps/aclnnInplaceLerps 条件化维度约束及相应错误码说明,保留标量 weight、类型与广播约束。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他 See merge request: cann/ops-math!7248 | 7 days ago |
| fix(isin): aclnnIsInScalarTensor 支持Ascend950 Co-authored-by: hahaha22<wangrunze20@h-partners.com> # message auto-generated for no-merge-commit merge: !7139 merge fix/isin-scalar-tensor-promote into master fix(isin): aclnnIsInScalarTensor 支持Ascend950 Created-by: hahaha22 Commit-by: hahaha22 Merged-by: cann-robot Description: ## 描述 本 PR 让 aclnnIsInScalarTensor 的**输出结果与 GPU(torch CUDA)完全一致**,同时把 invert 的实现方式改为与 GPU 同构(省一个 kernel)。另含 Ascend 950 支持声明与 aclnn golden 注册。 ### 1. dtype 推导:统一为 PromoteType(testElements, element) 原 PromoteTypeScalar 有三条分支,其中「testElements 元素个数 < 10 且为浮点」时**直接把比较精度压到 testElements 自己的 dtype**。这条规则 torch 的 CPU 与 GPU 都没有(torch 最低使用默认浮点 f32/f64),导致 950 在 numel<10 + fp16/bf16 testElements 场景与 GPU 分叉: | 用例(testElements fp16 = 1.0009765625,element fp64 = 1.0009765626) | 修改前 NPU | GPU | |---|---|---| | n = 9(<10) | **True** | **False** | | n = 20(≥10) | False | False | torch 侧的语义是 at::native::result_type(elements, test_elements)(aten/src/ATen/native/TensorCompare.cpp 广播路 isin_default_kernel_cpu:333、CUDA 路 cuda/TensorCompare.cpp:15-16),等价于 PromoteType(testElements, element)。因此删除该精度压制分支,三条分支合并为一条,与 GPU 的 result_type 语义一致。 ### 2. invert:由 Equal + ReduceAny + LogicalNot 改为 NotEqual + ReduceAll GPU 广播路(cuda/TensorCompare.cpp:15-16)为: cpp invert ? elements.unsqueeze(-1).ne(test_elements.view(bc_shape)).all(-1) : elements.unsqueeze(-1).eq(test_elements.view(bc_shape)).any(-1) 即 invert 同时切换比较算子(eq→ne)与归约算子(any→all),不产生独立的取反 kernel。本 PR 将实现改为同构写法,去掉 l0op::LogicalNot,少一次 kernel 下发。数学等价:all(ne) = ¬any(eq)。 ### 3. 门控:仅 RegBase 生效 上述两处改动均以 IsRegBase() 门控: - dtype 推导:RegBase 走统一的 PromoteType(testElements, element);非 RegBase 保持原三分支(含 ELEMENTS_THRESHOLD 的精度压制)不变; - invert:RegBase 走 NotEqual + ReduceAll;非 RegBase 保持 Equal + ReduceAny + LogicalNot 不变。 因此非 RegBase 平台行为零变化。 ### 4. 行为影响面 - numel<10 且 testElements 为 fp16/bf16/fp32、element 精度更高 的场景:比较精度由 testElements dtype 提升为 PromoteType 结果(对齐 GPU)。 - numel≥10、testElements 为整型、空张量、element 为 NaN、invert、assumeUnique 等分支结果不变。 - 空 testElements / NaN element 仍走 Fill(out, invert) 短路,与 GPU 语义一致。 ### 5. 950 上板验证(Ascend950PR + A100,TTK aclnn 三方对比) 200 条用例(testElements 覆盖 int8/int16/int32/int64/uint8/fp16/bf16/fp32/fp64,numel 覆盖 0、1~11、100、1024、4096、65536、25 万、100 万、1000 万、1 亿): | 版本 | NPU vs GPU | NPU vs CPU golden | |---|---|---| | 修改前 | 200/200 一致 | 194 PASS / 6 FAIL | | **修改后** | **200/200 一致** | 194 PASS / 6 FAIL | - fp16 / bf16 舍入边界用例(此前与 GPU 分叉的两条)已修复为与 GPU 一致; - invert=True(含 assumeUnique=True、空张量)用例与 GPU 一致; - 仍与 CPU golden 有 6 条差异:int32/int64 + fp64 element + numel<10,原因是 torch **CPU** 在 numel<10 时走 f32 语义(isin_default_kernel_cpu 在 view 前取 result_type)、而 GPU 全程 f64;该差异属 torch 自身 CPU/CUDA 行为不同,不是本算子缺陷。 ## 关联的Issue Closes #4637 ## 测试 ### 用例资产(两类都补) | 层 | 文件 | 条数 | | --- | --- | --- | | **aclnn ST(ATK)** | tests/st/aclnnIsInScalarTensor/atk_aclnnIsInScalarTensor.json | 153 | | **TTK aclnn** | tests/st/arch35/ttk_aclnn_isin_scalar_tensor_st.csv | 153 | 覆盖:数据量 0/1/2/3/8/9/10/11/20/64/128/1000/4096/100000(阈值两侧);判别 dtype 组 int32×double、int64×double、float16×double、float32×double;普通组 bfloat16×float32、int8×int32、uint8×int64、float32×float16;assume_unique × invert 组合;空张量与精确命中边界(boundary 77 条)。 ### 实测结果(950,前置自编译修复库) | 比对基准 | 结果 | | --- | --- | | NPU vs **GPU**(TTK --dump xpu,与 torch CUDA 逐位比对) | **153/153 一致** | | NPU vs **CPU golden**(TTK 内置精度判定) | 139/153,14 条差异 | | torch 接口端到端(torch.isin → torch_npu → 本算子),修复库 | 153/153 | | 同上,官方 CANN 9.2.0 原库 | 139/153(14 条判别用例失败,即修复生效证据) | 说明: - 14 条差异全部是「float16/float32 张量 + double 标量 + numel<10」的判别用例:torch **CPU** 在 numel<10 走 f32 语义给 True,而 GPU/NPU 走 f64 给 False。**本 PR 的对齐目标是 GPU**,故 NPU 结果与 GPU 一致、与 CPU golden 不同,属预期行为(与 aclnn 全量 200 例中 6 条同源)。 - 本机无 ATK,ST json 尚未经 ATK 框架执行;上表结果按同一用例规格在 950 上等价执行(TTK aclnn + torch 接口)。api_type 取 function(对齐同族 aclnnEqScalar)。 - golden:tests/assets/golden.py 注册 aclnnIsInScalarTensor 数值金标准(标量声明 dtype 保真)。 - UT:本 PR 不新增 UT(按评审意见后续单独 PR 补齐判别性数值用例)。 See merge request: cann/ops-math!7139 | 4 days ago |
| fix: Modify the AIDD docs issue Co-authored-by: zwj223<zhangwenjing55@h-partners.com> # message auto-generated for no-merge-commit merge: !4332 merge master into master fix: Modify the AIDD docs issue Created-by: zwj223 Commit-by: zwj223 Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动,包括改动的原因和所采取的方法。--> 修改AIDD扫描的核心资料问题 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue,请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单,请在这里描述问题单单号。--> [#2415](https://gitcode.com/cann/ops-math/issues/2415) ## 文档更新 <!--如果这个PR包含文档的更新,请在这里指出。例如:更新了README.md文件。--> quick_op_invocation.md cross_platform_migration_guide.md op_list.md aicpu_develop_guide.md ... ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他,请描述: See merge request: cann/ops-math!4332 | 3 months ago |
| 修复 ops-math QUICKSTART.md 文档扫描问题(9处) Co-authored-by: liujing987913<liujing407@h-partners.com> # message auto-generated for no-merge-commit merge: !7366 merge docs/quickstart-fix into master 修复 ops-math QUICKSTART.md 文档扫描问题(9处) Created-by: liujing987913 Commit-by: liujing987913 Merged-by: cann-robot Description: ## 描述 - 背景:AIDD/文档质量扫描发现 ops-math 仓 docs/QUICKSTART.md 文档问题 9 处 - 修改分类:代码块语言标签 2(bash/text→output 回显块)、行内代码标记 1、标点风格 2(冒号半角→全角)、参数名/括号 1、术语大小写 2(Kernel/Tensor) - 涉及文件:docs/QUICKSTART.md(1 个文件,9 处) - 验证:git diff 确认为纯文本修改,无代码内容误改;已人工核对 ## 关联的Issue https://gitcode.com/cann/ops-math/issues/4715 ## 测试 ## 文档更新 本次 PR 更新 ops-math docs/QUICKSTART.md,修正代码块语言标签/标点/术语/行内代码格式问题 9 处,详见 diff。 ## 类型标签 - 文档更新 See merge request: cann/ops-math!7366 | 5 days ago |
| docs: 修复注释与文档不一致(文档目录与 aclnn 索引) Co-authored-by: tangpingchuan<tangpingchuan@huawei.com> # message auto-generated for no-merge-commit merge: !6475 merge docs/comment-cleanup-20261019-01 into master docs: 修复注释与文档不一致(文档目录与 aclnn 索引) Created-by: pingchuantang Commit-by: tangpingchuan Merged-by: cann-robot Description: ## 描述 修复文档目录与 aclnn 索引不一致。 ## 关联的Issue - https://gitcode.com/cann/ops-math/issues/3664 ## 测试 - pre-commit(含 OAT):通过 - Markdown 链接/图片检查:无新增失效项 - 全部 26 个分支合并验证:无冲突 ## 文档更新 - docs/README.md - docs/zh/menu_aclnn_api.md ## 类型标签 - [x] 文档更新 See merge request: cann/ops-math!6475 | 29 days ago |