Closed
[Documentation|文档反馈]: aclnnReplicationPad2dBackward 参数表把 padding 的「数值」写成「前/后两维度」,与同族 1d/3d 不一致 #3942
liuhanwen8Add on 23 days agoClosed at 20 days ago
23 days ago Added label: documentation
陈思
22 days ago Comments:
22 days ago Comments:
您好,感谢反馈!已核对提交 584b2ea6,2d 反向参数表确实将 padding 的数组元素写成了“前两维度/后两维度”。该参数长度为 4,依次表示左、右、上、下的填充量;这里应使用“前两个元素(数值)/后两个元素(数值)”。同族 1d、3d 使用“数值”的表述可作措辞对照,正向 2d 参数表也存在同样用词。
修订时建议把元素顺序写清,并一并核对原句的数值约束。反向实现确认数组长度为 4、索引 0/1 对应最后一维、2/3 对应倒数第二维;但“小于对应 self 维度”的显式检查仅在 mode == "reflect" 时执行,而本接口传入的是复制模式。因此,不宜仅照抄同族原句就认定复制模式也具有该上限,完整边界仍需结合对应类型和实现确认。后续将继续跟踪本接口的措辞修订与约束核对,并检查正向同句的一致性。


22 days ago Assign chensi79 as responsible person
22 days ago Added label: pending-confirmation
22 days ago Assign chen_0715 as responsible person
22 days ago Removed responsible person chensi79
22 days ago Removed label: pending-confirmation
21 days ago Assign Anthony0331 as responsible person
21 days ago Removed responsible person chen_0715
20 days ago Associated pull request
20 days ago Close issue
20 days ago Added label: resolved
现象
aclnnReplicationPad2dBackward的资料参数表把padding的使用说明写成**「维度」**:padding是长度为 4 的一维aclIntArray(左右上下四个数),并不存在「前两维度 / 后两维度」。同族资料写的是「数值」,可对照:
padding的两个数值都需小于self最后一维度的数值。padding前两个数值需小于self最后一维度的数值,中间两个数值…,后两个数值…期望
改为与 1d / 3d 一致的「数值」写法:
影响
「前两维度的数值」会被读成「padding 的前两个维度」,而
padding没有维度概念,读者需要额外推断「其实是数组下标 0/1」。这类措辞在 pad 族里是唯一一处,
与 1d/3d 不一致也说明是笔误;不影响实现,但会拖慢接入与 review。
同一句在正向资料
conversion/pad_v3/docs/aclnnReplicationPad2d.md(L104)也一样,可一并修。按「一个接口一条 issue」的约定,本条只针对
aclnnReplicationPad2dBackward。建议
把 L108 的「前两维度的数值 / 后两维度的数值」改为「前两个数值 / 后两个数值」,与同族 1d、3d 反向一致;正向
aclnnReplicationPad2d.mdL104 同一句可一并修。环境
cann/ops-math@584b2ea6(master,2026-10-24 fetch)conversion/pad_v3_grad_replicate/docs/aclnnReplicationPad2dBackward.md复现步骤
repro_replpad2db_wording.pypython3 repro_replpad2db_wording.py --repo-root <ops-math clone>rc=1且输出含[DEFECT];修复后应rc=0复现脚本
import argparse, io, os, re, sys DOC = "conversion/pad_v3_grad_replicate/docs/aclnnReplicationPad2dBackward.md" PEER = "conversion/pad_v3_grad_replication/docs/aclnnReplicationPad3dBackward.md" BAD = re.compile(r"padding\s*前两维度|padding\s*后两维度|前两维度的数值|后两维度的数值") GOOD = re.compile(r"padding\s*前两个数值|padding的两个数值") # 对照组 CTRL:同族正确写法 ap = argparse.ArgumentParser() ap.add_argument("--repo-root", default=".") a = ap.parse_args() path = os.path.join(a.repo_root, DOC) if not os.path.isfile(path): print("[INCONCLUSIVE] 找不到资料:%s" % path) sys.exit(2) text = io.open(path, encoding="utf-8", errors="replace").read() lines = text.splitlines() bad = [(i + 1, ln.strip()) for i, ln in enumerate(lines) if BAD.search(ln)] good = [(i + 1, ln.strip()) for i, ln in enumerate(lines) if GOOD.search(ln)] peer = os.path.join(a.repo_root, PEER) peer_ok = os.path.isfile(peer) and bool(re.search(r"padding\s*前两个数值", io.open(peer, encoding="utf-8", errors="replace").read())) print("对照(ctrl):本文件「前两个数值」写法 %d 处;同族 3d 反向写法正确=%s" % (len(good), peer_ok)) if bad: print("[DEFECT] 使用「padding 前/后两维度」的措辞 %d 处:" % len(bad)) # 缺陷组 DEFECT for ln, txt in bad: print(" L%d %s" % (ln, txt[:160])) print("[DEFECT] 期望:改为「padding 前两个数值…后两个数值…」(padding 是长度 4 的一维数组)") sys.exit(1) print("[OK] 未发现「两维度」措辞")实测输出:
对照(ctrl):本文件「前两个数值」写法 0 处;同族 3d 反向写法正确=True;[DEFECT] 使用「padding 前/后两维度」的措辞 1 处:L108 padding前两维度的数值都需小于self最后一维度的数值…;rc=1。