Pull Request has been successfully merged by CANN-robot.
(Thank you for cai-chengchao's contribution.)变更摘要
本 PR 将 clip_by_value_v2、addcdiv、floor_div、lerp、maximum、minimum 六个算子的测试标杆(golden)由原先的 __golden__ 字典函数映射重构为 TTK TestSpec 形式的 __spec__ 类映射,使 kernel/GEIR、aclnn 各接口以及 e2e(torch.*)流程统一由类承载 golden 与 third_party 三方比对实现。同时补齐了 inplace 接口、TensorList 归约接口以及 floor_div 全新的标杆文件,并集中规范化了精度提升与输出 dtype 回写逻辑。
主要改动
- 注册方式改为
__spec__+ TestSpec 类:各算子文件用__spec__将算子名(含aclnnClamp*、aclnnAddcdiv、aclnnFloorDivides、aclnnLerps、aclnnMaxN、aclnnMinN等变体与torch.*e2e 入口)映射到对应的*TestSpec类,替代原__golden__的kernel/aclnn分节函数表。 - kernel/GEIR 流程统一为 numpy 转 torch 再转回 numpy:
ClipByValueV2TestSpec、AddcdivTestSpec、FloorDivTestSpec、LerpTestSpec、MaximumTestSpec、MinimumTestSpec的golden改为借助ttk.utilities的numpy_to_torch_tensor、torch_to_numpy_tensor完成转换,替代原先直接使用numpy/np.maximum的实现。 - 新增共用三方标杆
ThirdPartyImpl:每个算子文件提供ThirdPartyImpl与_third_party_inputs等辅助函数,按位置优先、kwargs兜底的方式提取输入张量(兼容self/selfRef/selfT等命名),缺失输入时抛出TypeError,供所有模式共用。 - 精度提升与输出 dtype 回写规范化:引入
_FP_REDUCE、_to_fp32、_cast_to_out等辅助函数,对float16/bfloat16抬升 fp32 计算后回写;clip_by_value_v2额外实现_clamp_scalar/_clamp_tensor配合_promote、_scalar_default、_combine_categories复刻 ACLNN 的标量/张量 promote 规则,floor_div对bool输入按 promote 规则转 float32 计算。 - 新增
floor_div标杆并扩展归约类接口:新增math/floor_div/tests/assets/golden.py,覆盖aclnnFloorDivide/aclnnFloorDivides及其 inplace 版本与torch.floor_divide;maximum/minimum增加AclnnMaxNTestSpec/AclnnMinNTestSpec,对aclTensorList逐元素累积归约。
🧩 本次 Review 已使用自定义 Skill:


代码审查
审查结论
发现的问题(按优先级)
| # | 优先级 | 文件:行 | 问题 |
|---|---|---|---|
| 1 | P1 | conversion/clip_by_value_v2/tests/assets/golden.py:133-143 | 三方标杆用 or 判断 Tensor 真值,多元素张量直接抛 RuntimeError |
| 2 | P2 | conversion/clip_by_value_v2/tests/assets/golden.py:146-149 | 单界位置回退把下界当成上界,clampMin 类用例参考值反向 |
| 3 | P2 | math/lerp/tests/assets/golden.py:32-37 | 删掉了 fp16/bf16 抬 fp32 中间精度,与旧标杆及自身 docstring 不符 |
| 4 | P2 | math/maximum/tests/assets/golden.py:95-105 | aclnnMaxN 的 TensorList 入参被交给二元 ThirdPartyImpl,cross_check 抛 TypeError |
| 5 | P2 | math/minimum/tests/assets/golden.py:95-105 | 同上(aclnnMinN) |
| 6 | P3 | conversion/clip_by_value_v2/tests/assets/golden.py:273-275 | e2e torch.clamp 标量 min/max 走了张量提升路径,输出 dtype 变化 |
| 7 | P3 | math/addcdiv/tests/assets/golden.py:86-89 | 三方标杆忽略位置传入的 value,非 1.0 系数用例参考值出错 |
统计:P0 = 0,P1 = 1,P2 = 4,P3 = 2。
逐文件审查确认
conversion/clip_by_value_v2/tests/assets/golden.py:已审查,3 个问题(#1、#2、#6)。math/addcdiv/tests/assets/golden.py:已审查,1 个问题(#7)。math/floor_div/tests/assets/golden.py(新增):已审查,no issues。(_floor_divide的 bool 抬 fp32 分支与 inplace 未回写 dtype 两处疑点,因缺少 kernel 类型支持/混合整型用例的直接证据,按误报控制未上报。)math/lerp/tests/assets/golden.py:已审查,1 个问题(#3)。math/maximum/tests/assets/golden.py:已审查,1 个问题(#4)。math/minimum/tests/assets/golden.py:已审查,1 个问题(#5)。
总体风险判断
本次改动是测试标杆(golden)从 __golden__ 迁移到 __spec__ + TestSpec 类的批量重构,不触及产品运行时路径,产品侧风险低。但 golden 本身的正确性直接决定 ST/UT 的可信度:clip 的三方标杆会在绝大多数用例上直接崩溃(P1),lerp 丢失 fp32 中间精度会引入误差放大,MaxN/MinN 的 cross_check 无法执行 —— 这些问题会造成用例失败,或更糟地放宽阈值后掩盖真实 kernel 缺陷。建议至少修复 P1 与两处 P2 语义错误后再合入。
| 类型 | 数量 |
|---|---|
| 🔴 阻塞 | 1 |
| 🟡 建议 | 5 |
⛔ 需要修改
🧩 本次 Review 已使用自定义 Skill:


Thanks for your pull-request.
The full list of commands accepted by me can be found at here.
You can get sig-info at here.
You can self-configure the PR merge rules for this repository. For more details, please refer to Here.
For more, you also can visit HICANN.
PR Approval Progress
✅ Congratulations! All modules have met the lgtm and approve requirements.
Module Approval Details
| module | lgtm status | approve status |
|---|---|---|
| conversion/clip_by_value_v2 | ✅ 汤平川, 张磊 (2/2) | ✅ 汤平川, 张磊 (2/1) |
| math/addcdiv | ✅ 汤平川, 张磊 (2/2) | ✅ 张磊, 汤平川 (2/1) |
| math/floor_div | ✅ 汤平川, 张磊 (2/2) | ✅ 汤平川, 张磊 (2/1) |
| math/lerp | ✅ 汤平川, 张磊 (2/2) | ✅ 汤平川, 张磊 (2/1) |
| math/maximum | ✅ 汤平川, 张磊 (2/2) | ✅ 汤平川, 张磊 (2/1) |
| math/minimum | ✅ 汤平川, 张磊 (2/2) | ✅ 汤平川, 张磊 (2/1) |
💡 Tip:
- Committer can comment
/approveor/lgtm- Commenting
/approveimplies both code review (lgtm) and intent to merge (approve)
CLA Signature Pass
cai-chengchao, thanks for your pull request. All authors of the commits have signed the CLA. 👍


描述
本次改动将 ops-math 仓库中部分算子的测试 golden 脚本从旧的函数式 golden 注册方式重构为 TTK TestSpec 规范(类 + spec 注册表 + third_party 三方标杆),并新增 floor_div 算子的 golden 基准。
改动原因
改动方法
关联的Issue
测试
文档更新
类型标签