Closed
[Documentation|文档反馈]: transpose算子(aclnnPermute/aclnnChannelShuffle)文档调用方式、数据类型与格式规范问题 #4805
zhanw_codingAdd on 2 days agoClosed at 2 days ago
2 days ago Added label: documentation
zhanw_coding
2 days ago Comments:
2 days ago Comments:
/assign


2 days ago Assign zhanw_coding as responsible person
2 days ago Close issue
2 days ago changed custom state from 待办的 to 已完成
2 days ago Added label: resolved
一、文档链接 (必填)
二、问题文档片段 (必填)
1. aclnnPermute.md
conversion/transpose/examples/test_aclnn_permute.cpp不一致:函数括号风格、aclIntArray*写法、workspace 判空写法(> 0与static_cast<uint64_t>(0))、注释文字均不同。维度(shape)、非连续 Tensor。workspace_size,与函数原型中的workspaceSize不一致。workspaceSize、executor、workspace、stream的描述未使用规范固定话术(含多余中英文空格)。out的数据类型末尾多一个句号,且与self的排列顺序不一致,易被误读为两者存在差异。ACLNN_ERR_PARAM_INVALID场景:dims元素个数与self维度数不一致、dims存在重复元素、out的 shape 与按dims重排self后的 shape 不一致。self使用说明缺少空 Tensor 支持说明;dims使用说明缺少“元素个数等于self维度数”“元素不可重复”“负数表示从尾部计数”。Contiguous/ViewCopy等实现细节,且“支持非连续Tensor”“支持空Tensor”属于能力描述,已在参数说明中体现,不应作为约束重复。2. aclnnChannelShuffle.md
*位于通道维前,易被误解为第-3维为channel;实际通道维固定为第1维(下标从0开始)。self的数据类型列表缺少BFLOAT16,与out列表及代码DTYPE_SUPPORT_LIST不一致。Atlas训练系列产品不支持BFLOAT16。3. conversion/transpose/README.md
examples/test_geir_permute.cpp,且缺少 Transpose 算子自身的 GE IR 样例。DT_COMPLEX32、DT_QINT8等),与实际可调用的 NPU 接口不一致。perm、y的描述引用了self、dims,与实际参数名x、perm不符;perm取值范围缺少负索引、元素个数与唯一性约束。4. docs/zh/op_api_list.md
aclnnChannelShuffle的接口说明仍为旧表述“将(*, C, H, W)张量的channels分成g个组……随机重排”,与修正后的文档不一致。三、存在的问题与期望
self/out列表以及 README、op_api_list 中的描述与代码/IR定义不一致。关联PR:https://gitcode.com/cann/ops-math/pull/7492