cann-robotfeat(cdist_grad): 补充 InferDataType RT2.0 推导并新增 UT 看护

Files	Last commit	Last update
docs	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	5 days ago
examples	CdistGrad示例改用C++ RAII资源管理，与IsFinite/IsInf示例风格对齐 Co-authored-by: zhouqilong<zhouqilong2@huawei.com> # message auto-generated for no-merge-commit merge: !4664 merge raii-cdist_grad into master CdistGrad示例改用C++ RAII资源管理，与IsFinite/IsInf示例风格对齐 Created-by: zhou-qilong Commit-by: zhouqilong Merged-by: cann-robot Description: ## 描述将 `math/cdist_grad/examples` 下的 aclnn 示例由手动资源管理改为 C++ RAII 管理，与同仓 `math/is_finite`、`math/is_inf` 示例风格保持一致。 ## 测试 - Start compile and run examples file: ../math/cdist_grad/examples/test_aclnn_cdist_backward.cpp pkg_mode:cust vendor_name:cdist_grad result[0] is: -4.500000 result[1] is: -4.500000 result[2] is: -4.500000 result[3] is: -4.500000 result[4] is: -4.500000 result[5] is: -4.500000 result[6] is: -4.500000 result[7] is: -4.500000 result[8] is: -4.500000 result[9] is: -4.500000 run test_aclnn_cdist_grad, execute samples success ## 文档更新无。 ## 类型标签 - [x] 其他，请描述：示例代码改造（C++ RAII资源管理） See merge request: cann/ops-math!4664	2 months ago
op_api	fix(e9): 5个算子EZ9999上报整改为注册错误码 Co-authored-by: zhouyuanhang30083383<zhouyuanhang4@h-partners.com> # message auto-generated for no-merge-commit merge: !7100 merge fix/e9-errcode-batch-math into master fix(e9): 5个算子EZ9999上报整改为注册错误码 Created-by: VoyageZhou Commit-by: zhouyuanhang30083383 Merged-by: cann-robot Description: ## 描述将 grouped_bias_add_grad、exp_segsum_grad、cdist_grad、is_finite、segsum 中面向非法使用/参数错误的泛化 EZ9999 上报整改为目标版本（CANN 9.3.0）已注册正式错误码： - dtype/rank/shape/shape size/attr 映射 EZ0019/EZ0011/EZ0012/EZ0013/EZ0015/EZ0008/EZ0024； - 必选输入缺失映射 EZ0004，Tiling/平台失败映射 EZ1008，InferShape 失败映射 EZ1014； - 下层已首报路径改为 OP_LOGE_WITHOUT_REPORT 仅日志透传，去除重复首错； - 删除 CREATE_EXECUTOR 后不可达的 null 检查。保留原有判定条件、返回值和公开 errno，不改变接口行为。 ## 关联的Issue [Issue 4585](https://gitcode.com/cann/ops-math/issues/4585) ## 测试 - ascend910b(arch22) / ascend950(arch35) 受影响 target 编译通过； - math_op_api_ut 75/75 PASSED，math_op_host_ut 20/20 PASSED； - 复扫与逐候选处置对账通过：160 个候选，96 FIXED / 61 RETAINED / 3 REMOVED，0 PENDING。 ## 文档更新无。 ## 类型标签 - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!7100	6 days ago
op_host	feat(cdist_grad): 补充 InferDataType RT2.0 推导并新增 UT 看护 Co-authored-by: VoyageZhou<zhouyuanhang4@h-partners.com> # message auto-generated for no-merge-commit merge: !7246 merge cdsit_grad_inferdatatype into master feat(cdist_grad): 补充 InferDataType RT2.0 推导并新增 UT 看护 Created-by: VoyageZhou Commit-by: VoyageZhou Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 参考 `math/abs/op_host/abs_infershape.cpp` 中 `InferDataType` 的 RT2.0 内联注册写法，为 `CdistGrad` 算子补充输出 dtype 推导。改动内容： - `math/cdist_grad/op_host/cdist_grad_infershape.cpp`：新增 `InferDataType4CdistGrad`，输出 `y` 的 dtype 透传输入 `grad` 的 dtype（grad/x1/x2/cdist 要求同 dtype），注册链调整为 `IMPL_OP_INFERSHAPE(CdistGrad).InferShape(InferShape4CdistGrad).InferDataType(InferDataType4CdistGrad)`。 - `math/cdist_grad/tests/ut/op_host/test_cdist_grad_infershape.cpp`：新增 4 例 InferDataType UT，覆盖 float32、float16、bfloat16，以及输入 dtype 不一致时输出仍取 grad 的场景。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> [Issue 4640](https://gitcode.com/cann/ops-math/issues/4640) ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 执行 op_host UT： `bash build.sh -u --ophost --soc=ascend910b --ops=cdist_grad --gtest_filter='CdistGradInfershape.*'` 结果：11/11 通过（7 例原 InferShape 用例 + 4 例新增 InferDataType 用例）。 ## 文档更新无 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!7246	3 days ago
op_kernel	fix: 修复cdist_grad边界场景中nan值的处理逻辑 Co-authored-by: VoyageZhou<zhouyuanhang4@h-partners.com> # message auto-generated for no-merge-commit merge: !6623 merge master into master fix: 修复cdist_grad边界场景中nan值的处理逻辑 Created-by: VoyageZhou Commit-by: VoyageZhou Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 修复cdist_grad边界场景中nan值的处理逻辑 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> [Issue 3677](https://gitcode.com/cann/ops-math/issues/3677) ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ST验证通过 ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> 不涉及 ## 类型标签 <!-- [x] 表示选中 --> - [x] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!6623	23 days ago
tests	feat(cdist_grad): 补充 InferDataType RT2.0 推导并新增 UT 看护 Co-authored-by: VoyageZhou<zhouyuanhang4@h-partners.com> # message auto-generated for no-merge-commit merge: !7246 merge cdsit_grad_inferdatatype into master feat(cdist_grad): 补充 InferDataType RT2.0 推导并新增 UT 看护 Created-by: VoyageZhou Commit-by: VoyageZhou Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> 参考 `math/abs/op_host/abs_infershape.cpp` 中 `InferDataType` 的 RT2.0 内联注册写法，为 `CdistGrad` 算子补充输出 dtype 推导。改动内容： - `math/cdist_grad/op_host/cdist_grad_infershape.cpp`：新增 `InferDataType4CdistGrad`，输出 `y` 的 dtype 透传输入 `grad` 的 dtype（grad/x1/x2/cdist 要求同 dtype），注册链调整为 `IMPL_OP_INFERSHAPE(CdistGrad).InferShape(InferShape4CdistGrad).InferDataType(InferDataType4CdistGrad)`。 - `math/cdist_grad/tests/ut/op_host/test_cdist_grad_infershape.cpp`：新增 4 例 InferDataType UT，覆盖 float32、float16、bfloat16，以及输入 dtype 不一致时输出仍取 grad 的场景。 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> [Issue 4640](https://gitcode.com/cann/ops-math/issues/4640) ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> 执行 op_host UT： `bash build.sh -u --ophost --soc=ascend910b --ops=cdist_grad --gtest_filter='CdistGradInfershape.*'` 结果：11/11 通过（7 例原 InferShape 用例 + 4 例新增 InferDataType 用例）。 ## 文档更新无 ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!7246	3 days ago
CMakeLists.txt	cdist_grad支持不同p分支 Co-authored-by: zhouyuanhang30083383<zhouyuanhang4@h-partners.com> # message auto-generated for no-merge-commit merge: !4812 merge master into master cdist_grad支持不同p分支 Created-by: VoyageZhou Commit-by: zhouyuanhang30083383 Merged-by: cann-robot Description: ## 描述 <!--在这里详细描述你的改动，包括改动的原因和所采取的方法。--> cdist_grad算子新增A2/A3上Ascend C实现，支持不同的p值分支 ## 关联的Issue <!-- 如果这个PR是为了解决特定的Issue，请在这里提供Issue链接。--> <!-- 如果这个PR是为了解决特定的问题单，请在这里描述问题单单号。--> [Issue 2622](https://gitcode.com/cann/ops-math/issues/2622) ## 测试 <!--描述进行了哪些测试来验证你的改动。包括但不限于二级冒烟、算子泛化等。--> ## 文档更新 <!--如果这个PR包含文档的更新，请在这里指出。例如：更新了README.md文件。--> ## 类型标签 <!-- [x] 表示选中 --> - [ ] Bug修复 - [x] 新特性 - [ ] 性能优化 - [ ] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!4812	2 months ago
README.md	产品名变更 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	1 month ago
README_en.md	docs: add English translations for markdown files Co-authored-by: jenny_xiang<jenny.xiang@huawei.com> # message auto-generated for no-merge-commit merge: !7113 merge docs/add-english-translations into master docs: add English translations for markdown files Created-by: jenny_xiang Commit-by: jenny_xiang Merged-by: cann-robot Description: ## 描述新增仓库Markdown文档英文译稿（第二批，共409个文件）：第一批（已合入）之外的其余全部译稿，覆盖conversion、examples、ge、math、random各类算子README译稿，以及CHANGELOG_en.md、.gitcode PR模板英文版等。本批内全部仓内链接均指向master已有文件（含第一批已合入的21+2篇译稿），合入后本仓432篇英文文档全部就位，链接完整生效。本批同时包含4篇基于最新源文档的增量更新（math/ada_cast、math/prod_force_se_a、math/sinkhorn、math/xlogy，对应上游近期文档变更）。 ## 关联的Issue 无 ## 测试文档类变更，无需算子测试；已通过链接有效性校验（本批全部相对链接仅指向master已有文件，无指向本PR外未提交文件的链接），并完成逐篇翻译规范自查与语义校对（含支持状态表、限定词、术语、数值符号核对）。 ## 文档更新新增409个英文译稿文件（*_en.md / .en-US.md），不修改任何现有文件。 ## 类型标签 - [ ] Bug修复 - [ ] 新特性 - [ ] 性能优化 - [x] 文档更新 - [ ] 其他，请描述： See merge request: cann/ops-math!7113	10 days ago

CdistGrad

English | 简体中文

Product Support Status

Product	Supported
Ascend 950PR&950DT products	√
Atlas A3 products	√
Atlas A2 products	√
Atlas 200I/500 A2 inference products	×
Atlas inference products	√
Atlas training products	√

Function Description

Operator function: performs the backpropagation of Cdist.
Computation formula:

$out=grad⋅y′=grad⋅(∑(x1−x2)pp)′=grad⋅1p×(∑(x1−x2)p)1p−1×p×(x1−x2)p−1=grad⋅(∑(x1−x2)p)−(p−1)p×(x1−x2)p−1=grad⋅(∑(x1−x2)p)1p×(−(p−1))×(x1−x2)p−1=grad⋅diffp−1cdistp−1=grad⋅diff×∣diff∣p−2cdistp−1\begin{aligned} out&=grad \cdot y' \\ &= grad \cdot \left( \sqrt[p]{\sum (x_1 - x_2)^p} \right)' \\ &= grad \cdot \frac{1}{p} \times \left( \sum (x_1 - x_2)^p \right)^{\frac{1}{p}-1} \times p \times (x_1 - x_2)^{p-1} \\ &= grad \cdot \left( \sum (x_1 - x_2)^p \right)^{\frac{-(p-1)}{p}} \times (x_1 - x_2)^{p-1} \\ &= grad \cdot \left( \sum (x_1 - x_2)^p \right)^{\frac{1}{p} \times (-(p-1))} \times (x_1 - x_2)^{p-1} \\ &= grad \cdot \frac{diff^{p-1}}{cdist^{p-1}} \\ &= grad \cdot \frac{diff \times |diff|^{p-2}}{cdist^{p-1}} \end{aligned}$
- $diff=x1−x2\mathrm{diff} = x_1 - x_2$ : variable difference
- $cdist=∑(x1−x2)pp\mathrm{cdist} = \sqrt[p]{\sum (x_1 - x_2)^p}$ : $p$ -norm distance

Parameter Description

Parameter Name	Input/Output/Attribute	Description	Data Type	Data Format
grad	Input	Input grad in the formula.	FLOAT16, FLOAT32	ND
x1	Input	Input x1 in the formula.	FLOAT16, FLOAT32	ND
x2	Input	Input x2 in the formula.	FLOAT16, FLOAT32	ND
cdist	Input	Input cdist in the formula.	FLOAT16, FLOAT32	ND
p	Attribute	Input p in the formula.	float	ND
out	Output	Output out in the formula.	FLOAT16, FLOAT32	ND

Constraint Description

None

Invocation Description

Invocation Method	Sample Code	Description
aclnn API	test_aclnn_cdist_backward	Invokes the CdistGrad operator through the aclnnCdistBackward API.