aclnnPermute
产品支持情况
| 产品 | 是否支持 |
|---|---|
| [object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object] | √ |
| [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object] | √ |
| [object Object]Atlas 200I/500 A2 推理产品[object Object] | × |
| [object Object]Atlas 推理系列产品 [object Object] | × |
| [object Object]Atlas 训练系列产品[object Object] | √ |
功能说明
算子功能：对tensor的任意维度进行调换。如输入self是shape为[2, 3, 5]的tensor，dims为(2, 0, 1)，则输出是shape为[5, 2, 3]的tensor。
函数原型
每个算子分为undefined，必须先调用“aclnnPermuteGetWorkspaceSize”接口获取计算所需workspace大小以及包含了算子计算流程的执行器，再调用“aclnnPermute”接口执行计算。
aclnnStatus aclnnPermuteGetWorkspaceSize(const aclTensor* self, const aclIntArray* dims, aclTensor* out,uint64_t* workspaceSize, aclOpExecutor** executor)aclnnStatus aclnnPermute(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, const aclrtStream stream)
aclnnPermuteGetWorkspaceSize
参数说明：
self(aclTensor*,计算输入)：输入的tensor，支持undefined，undefined支持ND，维度最大不超过8维，dtype需要与out一致。
- [object Object]Atlas 训练系列产品[object Object]：数据类型支持FLOAT、FLOAT16、DOUBLE、UINT64、INT64、UINT32、INT32、UINT16、INT16、UINT8、INT8、BOOL、COMPLEX64、COMPLEX128。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]：数据类型支持FLOAT、FLOAT16、DOUBLE、UINT64、INT64、UINT32、INT32、UINT16、INT16、UINT8、INT8、BOOL、COMPLEX64、COMPLEX128、BFLOAT16。
dims(aclIntArray*,计算输入)：整型数组，代表原来tensor的维度，指定新的轴顺序。取值需在[-self的维度数量，self的维度数量-1]范围内。
out(aclTensor*，计算输出)：输出的tensor，支持undefined，undefined支持ND，维度最大不超过8维，shape由dims和原self的shape共同决定，dtype需要与self一致。
- [object Object]Atlas 训练系列产品[object Object]：数据类型支持FLOAT、FLOAT16、DOUBLE、UINT64、INT64、UINT32、INT32、UINT16、INT16、UINT8、INT8、BOOL、COMPLEX64、COMPLEX128。
- [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]：数据类型支持FLOAT、FLOAT16、DOUBLE、UINT64、INT64、UINT32、INT32、UINT16、INT16、UINT8、INT8、BOOL、COMPLEX64、COMPLEX128、BFLOAT16。
workspaceSize(uint64_t*，出参)：返回需要在Device侧申请的workspace大小。
executor(aclOpExecutor**，出参)：返回op执行器，包含了算子计算流程。
返回值：
aclnnStatus：返回状态码，具体参见undefined。
aclnnPermute
参数说明：
workspace(void*，入参)：在Device侧申请的workspace内存地址。
workspaceSize(uint64_t，入参)：在Device侧申请的workspace大小，由第一段接口aclnnPermuteGetWorkspaceSize获取。
executor(aclOpExecutor*，入参)：op执行器，包含了算子计算流程。
stream(aclrtStream，入参)：指定执行任务的Stream。
返回值：
aclnnStatus：返回状态码，具体参见undefined。
约束说明
无。
调用示例
示例代码如下，仅供参考，具体编译和执行过程请参考undefined。