Closed
[Documentation|文档反馈]: acts_ulq_input_grad README 声明了不存在的掩码取值 {0,1} 限制,与实现及 A2 权威口径不符(中英文双语) #8367
wangweidongAdd on  14 days agoClosed at  12 days ago
wangweidong
wangweidong
14 days ago Create

Document Link(文档链接)

Issues Section(问题文档片段)

README.md 参数表:

| clamp_min_mask | 输入 | 表示下界clamp掩码张量,对应公式中clamp_min_mask,取值 {0,1};数据类型为bool或与y_grad相同的浮点;shape需与y_grad一致。 | BOOL、FLOAT16、FLOAT | ND |
| clamp_max_mask | 输入 | 表示上界clamp掩码张量,对应公式中clamp_max_mask,取值 {0,1};数据类型必须与clamp_min_mask一致;shape需与y_grad一致。 | BOOL、FLOAT16、FLOAT | ND |

README.md 约束说明:

- clamp_min_mask与clamp_max_mask的语义值应为0或1;掩码取值为(0,1)区间的连续浮点时,按一般逐元素乘法语义计算(`x_grad = y_grad * mask_min * mask_max`)。

README_en.md 对应:参数表 with values {0,1}(:33-34)与 - The semantic values of clamp_min_mask and clamp_max_mask should be 0 or 1.

Existing Issues(存在的问题)

  • 声明了不存在的限制:算子 Host 层(InferShape / InferDataType / Verify / Tiling)拿不到数据内容,无掩码值域校验;kernel 按逐元素乘法 x_grad = y_grad * mask_min * mask_max 计算,掩码任意取值均按该语义参与计算。A2(canndev)proto/Verify/TBE kernel 亦均无掩码值域校验,本算子兼容同口径。
  • 误导风险:使用者会误以为非 0/1 掩码取值非法或行为未定义,而实际行为是确定的逐元素乘法语义。
  • 实测依据(关联 PR):交付包用例集 391 例上板验证(含次正规、溢出 inf、0×inf=nan、全跨度、ulp 边界),三方 cross_check 全 PASS。
  • 修正方式:中英文 README 同步移除参数表「取值 {0,1}」与约束说明整行;dtype 一致性、4 组合法组合、shape 一致等真约束保留不动。
  • 备注:PR 早期提交中的 InferDataType UT 补充已被 revert,不在本 PR 净内容内,本 Issue 仅覆盖文档缺陷。

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

likedislike
wangweidongwangweidong
14 days ago Added label: documentation
wangweidong
wangweidong
14 days ago Comments:
likedislike
CANN-robotCANN-robotCollaborators
14 days ago Assign gcw_YBIAEfqJ as responsible person
CANN-robotCANN-robotCollaborators
12 days ago Close issue
CANN-robotCANN-robotCollaborators
12 days ago changed custom state from 待办的 to 已完成
CANN-robotCANN-robotCollaborators
12 days ago Added label: resolved