Closed
[Documentation|文档反馈]: MaxPool3D Proto ceil_mode 宽度公式错误 #8566
KaranocaVeAdd on  11 days agoClosed at  8 days ago
KaranocaVe
KaranocaVe
11 days ago Create

[Documentation|文档反馈]: MaxPool3D Proto ceil_mode 宽度公式错误

问题

固定源码 cann/ops-nn@ae873b119fb5499c41a6893f920171551fb0a197 的
pooling/max_pool3_d/op_graph/max_pool3_d_proto.h 在 padding=CALCULATED 且
ceil_mode=1 的代码示例中把 in_width 重复相加,并在末窗口裁剪条件中遗漏
pad_left。这与同一固定提交的 Host InferShape 合同不一致,会误导使用者推导
输出 shape;结论为 docs_defect。补丁只修改该 Doxygen 代码示例,不改运行时代码。

证据

  • Proto 当前宽度公式是 (in_width + in_width + pad_right - effective_kernel + stride_w - 1) / stride_w + 1,末窗口条件是 (out_width - 1) * stride_w >= in_width + in_width。
  • pooling/max_pool3_d/op_host/max_pool3_d_infershape.cpp 先用 in_width + pad_left + pad_right 计算候选窗口,再以 (out_width - 1) * stride_w >= in_width + pad_left 删除完全落在右侧 padding 的末窗口(固定提交约第 141-145 行)。
  • 重复 in_width 会在常见零 padding、对称 padding 和非对称 padding 下产生错误;该问题只影响文档示例,不改变运行时行为。

最小算例

输入宽度 7,ksize_w=3、stride_w=2、dilation_w=1、pad_left=1、pad_right=2、ceil_mode=1。Host 先得到 5 个候选窗口,再因最后窗口起点 8 >= in_width + pad_left = 8 裁成 4。原 Proto 公式得到 8 个候选窗口,错误条件比较 14 >= 14 后裁成 7;修正后的公式和条件与 Host 一致得到 4。零 padding 对照(in_width=7, pad_left=pad_right=0, ksize_w=3, stride_w=2)中,Host/修正版为 3,原 Proto 仍为 7。

验证

  • 结论:MaxPool3D Proto ceil_mode=1 宽度示例与 Host InferShape 不一致;非对称 padding 算例中原示例宽度为 7、修正版与 Host 均为 4,零 padding 对照中原示例为 7、修正版与 Host 均为 3;文档补丁应用检查通过,未运行构建或设备测试。

关联 PR: https://gitcode.com/cann/ops-nn/merge_requests/14154

likedislike
KaranocaVeKaranocaVe
11 days ago Associated pull request
KaranocaVeKaranocaVe
11 days ago Modify description of issue
yuning_chenyuning_chenCollaborators
11 days ago Assign KaranocaVe as responsible person
CANN-robotCANN-robotCollaborators
8 days ago Close issue
CANN-robotCANN-robotCollaborators
8 days ago changed custom state from 待办的 to 已完成
CANN-robotCANN-robotCollaborators
8 days ago Added label: resolved