Pull Request has been successfully merged by CANN-robot.
（Thank you for tangkaidi's contribution.）
变更摘要
本次改动仅涉及 conversion/chunk_cat 算子文档 aclnnChunkCat.md 的说明更新，聚焦于明确 aclnnChunkCat 接口的语义边界与输出形态约定。文档将原有的一句式功能描述改写为更精确的规则说明：当前仅支持 dim 为 0，即沿首维切分，并补充了切分块大小计算方式、尾部补 0 行为、输出为二维 tensor 的结论以及期望输出 shape 的计算公式；同时在输出参数说明与异常场景中同步了这一约定。
主要改动
- 功能说明重写: 明确当前仅支持
dim为 0，tensors中每个非空 tensor 沿首维切分为numChunks块，每块首维大小为ceil(原首维大小/numChunks)，不能被整除时在首维末尾补 0，各块展平后按输入顺序拼接同序号块形成二维输出。 - 新增输出 shape 公式: 给出以各输入首维大小
L_i与其余维度乘积R_i表示的输出形状[numChunks, sum_i(ceil(L_i / numChunks) * R_i)]，并说明一维输入时R_i为 1。 - 新增示例说明: 增加了多输入
[4, 3, 2]且numChunks为 2 时输出为[2, 24]的例子，以及一维输入[5]补 0 后输出[[1, 2, 3], [4, 5, 0]]的例子，明确首维大小无需被numChunks整除。 - 输出参数描述细化:
out的说明由“输出 tensor”改为“shape 为功能说明中的二维输出 shape”。 - 新增异常场景: 在参数校验失败情形中补充
out的 shape 与期望输出 shape 不一致时报错。
🧩 本次 Review 已使用自定义 Skill：
Thanks for your pull-request.
The full list of commands accepted by me can be found at here.
You can get sig-info at here.
You can self-configure the PR merge rules for this repository. For more details, please refer to Here.
For more, you also can visit HICANN.
PR Approval Progress
✅ Congratulations! All modules have met the lgtm and approve requirements.
Module Approval Details
| module | lgtm status | approve status |
|---|---|---|
| */*/docs/acl*.md | ✅ 蔡雯雯, 汤平川 (2/2) | ✅ 蔡雯雯 (1/1) |
💡 Tip:
- Committer can comment
/approveor/lgtm- Commenting
/approveimplies both code review (lgtm) and intent to merge (approve)
CLA Signature Pass
tangkaidi, thanks for your pull request. All authors of the commits have signed the CLA. 👍
CANN-robotCANN-robot| 🚀 CI 流水线已启动 |
|---|
| 📋 执行详情: 点击查看流水线 |
| 🚀 CI 流水线已启动 |
|---|
| 📋 执行详情: 点击查看流水线 |
/lgtm
/approve
The following users do not have permission to comment /lgtm or /approve on any module in this PR:
/approve: 汤平川
描述
修复issue问题，资料内功能说明处添加chunk_cat算子的out shape的说明。
关联的Issue
aclnnChunkCat 资料缺少 dtype 支持面，且「按 dim 后一维级联」与实现的输出形状公式不一致 #3951
测试
修改前：
修改后：
文档更新
conversion/chunk_cat/docs/aclnnChunkCat.md
类型标签