Closed
[Documentation|文档反馈]: aclnnGroupNorm 资料未说明空 Tensor 时 out/meanOut/rstdOut 的取值(实测 rstdOut=NaN) #7363
liuhanwen8Add on 27 days agoClosed at 6 days ago
27 days ago Added label: documentation
yuning_chen
26 days ago Comments:
26 days ago Comments:
初步分析
感谢反馈,我们已开始核对这个问题。
现象理解:文档反馈;aclnnGroupNorm 资料未说明空 Tensor 时 out/meanOut/rstdOut 的取值(实测 rstdOut=NaN)。
当前判断:从描述看,这是资料/注释与实现口径不一致类文档反馈「aclnnGroupNorm 资料未说明空 Tensor 时 out/meanOut/rstdOut 的取值(实测 rstdOut=NaN)」。需要对照接口文档、头文件注释与实现/实测结果核对哪一侧需修正。以上为初步判断,待复现确认,不能当成已确认根因。
涉及范围:aclnnGroupNorm、aclnnGroupNormBackward、aclnn_group_norm
下一步:我们会先核对文档声明与实现/测试结果是否一致,再决定改资料还是改代码。


25 days ago Assign liujie12345678 as responsible person
yuning_chen
25 days ago Comments:
25 days ago Comments:
您好,问题已收到,当前 @liujie12345678 正在处理中。


25 days ago Assign gitee-duhuiping as responsible person
25 days ago Removed responsible person liujie12345678
11 days ago Associated pull request
6 days ago changed custom state from 进行中 to 已完成
6 days ago Close issue
3 days ago Assign chenjiayi_ as responsible person
chenjiayi_
3 days ago Comments:
3 days ago Comments:
补充说明本问题的后续处理:
已修复并随关联 PR 合入。
处理结果:
- !14221:fix issue,add md doc,add check shape
验证:
- 关联 PR(2026-11-13)已合入,变更可从 PR 记录追溯。
- 本次以 PR 记录与 issue 讨论核对为主,未重新执行复现或真机验证。
说明:合入分支与版本以 PR 记录为准;如仍有问题,请重新提 issue 并附版本、shape 与日志。
如果还有后续需要,请重新提 issue。


1 day ago Removed responsible person chenjiayi_
现象
aclnnGroupNorm的资料在参数表里 6 次声明「支持空Tensor」,但全文没有规定空输入时out/meanOut/rstdOut应该输出什么。实测(Atlas A2)三种空 Tensor 形态:[2,8,16]HxW=0,[2,8,0]C=0,[2,0,16]N=0,[0,8,16]关键点:
meanOut/rstdOut的形状只由(N, group)决定,与C、HxW无关。因此HxW=0与C=0时这两个出参非空,调用方能直接读到「均值 0 + 倒数标准差 NaN」这一组不自洽的值;而N=0时它们才是空张量。资料没有区分这三种情况。期望
资料应写明空 Tensor 时三个出参的取值。实现意图已写在源码注释里(
meanOut输出 0、rstdOut输出 NAN、out不写),资料应与之对齐,并区分N=0(三出参皆空)与HxW=0/C=0(meanOut/rstdOut非空、填 0/NaN)。或者反向对齐:与同仓 #7246(
aclnnGroupNormBackward的N=0空 tensor 缺陷)一致,明确N=0/C=0的契约(拒绝并返回 161002)——当前aclnnGroupNorm对这两种输入返回 0。环境
npu-smi26.1.1cann/ops-nn779c90413fe3(git fetch后的 master;代码norm/group_norm/op_host/op_api/aclnn_group_norm.cpp376-383 行与资料 6 处「支持空Tensor」声明均仍在)复现步骤
doc_assert_gn_empty.pycann/ops-nn仓根执行:python3 doc_assert_gn_empty.py --repo-root <ops-nn 仓根>[DEFECT] ...,退出码为 1复现脚本
#!/usr/bin/env python3 # -*- coding: utf-8 -*- """aclnnGroupNorm 资料:空 Tensor 出参取值契约的文本断言。 缺失 → [DEFECT] + 退出码 1;已写清 → [OK] + 0;无法判定 → 2。""" import argparse, os, re, sys def main(): ap = argparse.ArgumentParser() ap.add_argument("--repo-root", required=True) a = ap.parse_args() doc = os.path.join(a.repo_root, "norm/group_norm/docs/aclnnGroupNorm.md") if not os.path.isfile(doc): print("[UNKNOWN] 找不到 %s" % doc); return 2 text = open(doc, encoding="utf-8").read() claims = len(re.findall(r"支持空\s*Tensor", text, re.I)) print("资料路径: %s" % os.path.relpath(doc, a.repo_root)) print("「支持空Tensor」声明次数: %d" % claims) if claims < 1: print("[UNKNOWN] 资料未声明支持空 Tensor,本断言不适用"); return 2 # 契约段落:同一段同时出现 空Tensor + (meanOut|rstdOut) + (0|NaN) paras = re.split(r"\n\s*\n", text) spec = [p for p in paras if re.search(r"空\s*Tensor", p, re.I) and re.search(r"meanOut|rstdOut", p) and re.search(r"\bNAN\b|\bNaN\b|输出\s*0|填\s*0", p)] if spec: print("[OK] 已找到空 Tensor 取值契约: %s" % spec[0][:120].replace("\n", " ")) return 0 print("[DEFECT] 资料 6 处声明「支持空Tensor」,但未规定空 Tensor 时 " "out/meanOut/rstdOut 的取值;实测 HxW=0 / C=0 时 meanOut 全 0、rstdOut 全 NaN" "(两出参形状 (N,group) 非空)。") return 1 if __name__ == "__main__": sys.exit(main())实测输出:
板上实测(
HxW=0,self=fp32[2x8x0],group=4,eps=1e-5,输出缓冲预填哨兵 777.0):哨兵残留为 0,说明 0 与 NaN 是算子写入值,不是未初始化内存。
影响
NaN会被多数框架当异常值,0又会被误当「真实均值」消费;两者同时出现时无法判断哪个是「空输入」的约定值。aclnnGroupNormBackward的N=0空 tensor 已被当作缺陷(#7246),而正向接口对N=0/C=0直接返回 0 且给出 0/NaN 取值,资料未做区分。aclnnGroupNormSilu(A2 对N<=0/C<=0返回 161002)迁到aclnnGroupNorm时,空张量路径的契约完全不同,且无文档可依。建议
在
aclnnGroupNorm.md的「约束说明」或「功能说明」补一段空 Tensor 契约,至少覆盖三点:self.numel()==0,out不写(本身为空);meanOut输出 0、rstdOut输出 NaN(与源码注释一致),并说明这是约定值而非计算结果;N=0(三出参皆空)与HxW=0/C=0(meanOut/rstdOut形状(N,group)非空)。若维护者认为
N<=0/C<=0不应被接受,则改为返回161002,并与 #7246 的处理口径统一。