Closed
[Documentation|文档反馈]: MaxPool3D Proto ceil_mode 宽度公式错误 #8566
KaranocaVeAdd on 11 days agoClosed at 8 days ago
11 days ago Associated pull request
11 days ago Modify description of issue
11 days ago Assign KaranocaVe as responsible person
8 days ago Close issue
8 days ago changed custom state from 待办的 to 已完成
8 days ago Added label: resolved
[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 代码示例,不改运行时代码。证据
(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。验证
ceil_mode=1宽度示例与 Host InferShape 不一致;非对称 padding 算例中原示例宽度为 7、修正版与 Host 均为 4,零 padding 对照中原示例为 7、修正版与 Host 均为 3;文档补丁应用检查通过,未运行构建或设备测试。关联 PR: https://gitcode.com/cann/ops-nn/merge_requests/14154