Closed
[Requirement|需求建议]: ForeachDivList 契约对齐:按社区问题单恢复 out shape size≥ 契约 #8030
wenqi_wuAdd on  19 days agoClosed at  17 days ago
wenqi_wu
wenqi_wu
19 days ago Create

Background(背景信息)

ForeachDivList 合入(PR#12531)后,测试方在个人仓提交 3 个契约类问题单:#37 out 约束被固化为"逐元素完全相等"而文档原始口径为"shape size 大于等于"(out 更大/同 numel 异 shape 被 161002 误拒);#35 列表长度失配报错固定打印 x1/x2 size、out 失配时显示相等值(可排障性缺陷);#36 文档错误码表 8 类 host 参数校验标注 561002 而实现返回 161002(文档-实现错位)。

Origin(信息来源)

社区问题单 wangyueting/changwei_jiaoyiming #35/#36/#37;验证方式:Host UT(op_api/arch22/arch35 tiling)+ ACLNN 真机探针(Ascend950PR)。

Benefit / Necessity (价值/作用)

  • out 约束按文档恢复"shape size >= x1":同 numel 异 shape(如 (2,3) vs (3,2)/(6,))与更大 out 均可正常执行,消除误拒;与公共 ForeachCommonTiling 及同族 ForeachAddcdivScalar(PR#13111) 口径统一
  • 错误码契约守护:host 参数校验统一 161002/ACLNN_ERR_PARAM_INVALID 并以 UT 锁定,防止文档/实现再次漂移
  • 报错可排障性:列表长度失配打印三方 size 并上报真实失配参数名(上游已具备,本需求补真机验证与看护用例)
  • 测试补强:本算子首次建立 op_api UT(8 例)与 op_api UT 构建挂载,arch35 tiling 补 out 更大/更小正负例

Design(设计方案)

  • op_api(aclnn_foreach_div_list.cpp):CheckShape 的 out 校验放宽为 out 元素数 >= x1(补 out rank<=8),越界以 EZ0015/161002 上报
  • arch35 tiling(foreach_div_list_tiling.cpp):y 与 x1 校验由"元素数相等"改为"y >= x1"(仅小于才拒)
  • 文档(aclnnForeachDivList.md):out 行恢复"shape size大于等于";错误码表 shape 行补注
  • 测试:新增 tests/ut/op_host/op_api/(CMakeLists + 8 例);父级 tests/ut/op_host/CMakeLists.txt 补 add_subdirectory 循环与 OP_API_UT 注册;arch35 tiling UT 补 out-shape 正负例

关联 PR:https://gitcode.com/cann/ops-nn/pull/13515

likedislike
wenqi_wuwenqi_wu
19 days ago Added label: requirement
wenqi_wu
wenqi_wu
19 days ago Comments:

/assign @wenqi_wu

likedislike
CANN-robotCANN-robotCollaborators
19 days ago Assign wenqi_wu as responsible person
CANN-robotCANN-robotCollaborators
17 days ago Close issue
CANN-robotCANN-robotCollaborators
17 days ago Added label: resolved