Closed
[Documentation|文档反馈]: depthwise_conv2d A5资料错误声明INT4/INT8与offset_w支持 #9074
XianyongWangAdd on  4 days agoClosed at  3 days ago
XianyongWang
XianyongWangCollaborators
4 days ago Create

Document Link(文档链接)

https://gitcode.com/cann/ops-nn/blob/master/conv/depthwise_conv2d/README.md

Issues Section(问题文档片段)

  • 参数表:x/filter 声明 FLOAT16、FLOAT、INT8、INT4、BFLOAT16、HIFLOAT8,bias/y 含 INT32;
  • 约束组合表:包含 INT8 | INT8 | INT32 | INT8 | INT32 行,且 offset_w 作为可选输入单独成列;
  • 约束说明:包含“INT8、INT4 输入时输出为 INT32”及“INT16 输入(x=INT16、filter=INT8)例外”。

Existing Issues(存在的问题)

  1. Ascend 950PR&950DT 上 DepthwiseConv2D 无独立 kernel,经 DepthwiseToConv2dFusionPass 分解为 Conv2D、再经 Conv2dToConv2DV2FusionPass 转为 Conv2DV2;Conv2DV2 A5 信息库仅支持 FLOAT16/BFLOAT16/FLOAT/HIFLOAT8,INT4/INT8 无法执行(编译期报 data type not supported)。
  2. offset_w 为历史预留输入:融合 pass 不转发,Conv2D infershape 显式拒绝非空 offset_w,Conv2DV2 构造时传 nullptr 且 kernel 不使用;图模式下传入非空 offset_w 会在 DepthwiseToConv2dFusionPass 报 E20007。
  3. INT16 混合精度场景在 proto/信息库/Conv2DV2 均无支持。

修复 PR:!14737

likedislike
XianyongWangXianyongWangCollaborators
4 days ago Added label: documentation
yuning_chen
yuning_chenCollaborators
4 days ago Comments:

问题成立,而且这类「资料声明了实现根本不支持的 dtype」比「文档写错字」严重得多:用户会照着 README 写出 INT8/INT4 的调用,然后在编译期撞上 data type not supported,或者更糟——图模式下静默退化。

三点建议:

  1. 资料要以「信息库实际支持」为准,但请在 README 里显式写清 A5 上的实现路径:950PR/950DT 无独立 kernel → DepthwiseToConv2dFusionPass → Conv2dToConv2DV2FusionPass → Conv2DV2,因此 dtype 支持范围 = Conv2DV2 A5 信息库(FLOAT16/BFLOAT16/FLOAT/HIFLOAT8)。这段话比单纯删掉几行表格有用得多,因为用户下次遇到「为什么 depthwise 只支持这几种」时能自己查到原因。
  2. offset_w 建议直接标注「历史预留、当前无效」并从参数表里移除或加删除线,同时说明「图模式传非空 offset_w 会报 E20007」。否则用户看到「可选输入」四个字一定会尝试传。
  3. INT16 混合精度这条同样需要在 README 明确写「不支持」,并说明为什么(proto/信息库/Conv2DV2 均无路径)。
  4. 建议加一条 CI 检查:对比 README 的 dtype 表与算子信息库(proto/infershape)实际声明,不一致就告警。本仓最近文档类 issue 不少(#9048、#8996、#8994、#8989、#9034 的 C 上限),这类「文档 vs 实现」偏离已经成族,靠人工核不可持续。
  5. 修复 PR !14737 建议在描述里附「改前/改后 README 片段对照」,方便评审确认没漏行。
likedislike
yuning_chenyuning_chenCollaborators
4 days ago Assign XianyongWang as responsible person
yuning_chen
yuning_chenCollaborators
4 days ago Comments:

您好,问题已收到,当前 @XianyongWang 正在处理中。

likedislike
CANN-robotCANN-robotCollaborators
3 days ago Close issue
CANN-robotCANN-robotCollaborators
3 days ago changed custom state from 待办的 to 已完成
CANN-robotCANN-robotCollaborators
2 days ago Added label: resolved