aclnnMaxUnpool2d

支持的产品型号

• Atlas 训练系列产品。
• Atlas A2训练系列产品。

接口原型

每个算子分为，必须先调用“aclnnMaxUnpool2dGetWorkspaceSize”接口获取计算所需workspace大小以及包含了算子计算流程的执行器，再调用“aclnnMaxUnpool2d”接口执行计算。

• aclnnStatus aclnnMaxUnpool2dGetWorkspaceSize(const aclTensor* self, const aclTensor* indices, const aclIntArray* outputSize, aclTensor* outRef, uint64_t* workspaceSize, aclOpExecutor** executor)
• aclnnStatus aclnnMaxUnpool2d(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)

功能描述

• 算子功能：MaxPool2d的逆运算，由outputSize决定outRef的H、W轴大小，并根据indices索引在outRef中填入self的元素值，其余位置都设置为0。

• 计算公式：

  $$outRef[n][c][indices[n][c][i]] = self[n][c][i]$$

  其中outRef、indices和self是最后两轴合为一轴，经过reshape得到的，i ∈ [0, H*W)。

aclnnMaxUnpool2dGetWorkspaceSize

• 参数说明：

  • self(const aclTensor *, 计算输入): 公式中的输入self, Device侧的aclTensor。数据类型支持FLOAT、FLOAT16、INT16、INT32、INT64、INT8、UINT8和DOUBLE,且数据类型与outRef的数据类型一致，shape与indices保持一致。支持,支持CHW和NCHW。
  • indices(const aclTensor *, 计算输入): 公式中的输入indices, Device侧的aclTensor。表示输入self的元素在输出结果中的索引位置。数据类型支持INT64,且shape与self保持一致。支持,支持CHW和NCHW。
  • outputSize(const aclIntArray *, 计算输入): host侧的aclIntArray, 数据类型支持INT32、INT64。size大小为2。表示输出结果在H和W维度上的空间大小。
  • outRef(aclTensor *, 计算输出):公式中的输出outRef, Device侧的aclTensor。数据类型支持FLOAT、FLOAT16、INT16、INT32、INT64、INT8、UINT8和DOUBLE,且数据类型与self的数据类型一致。支持,支持CHW和NCHW。
  • workspaceSize(uint64_t*, 出参): 返回用户需要在Device侧申请的workspace大小。
  • executor(aclOpExecutor**, 出参): 返回op执行器，包含了算子计算流程。

• 返回值：

  aclnnStatus: 返回状态码，具体参见。

aclnnMaxUnpool2d

• 参数说明：

  • workspace(void *, 入参): 在Device侧申请的workspace内存地址。
  • workspaceSize(uint64_t, 入参): 在Device侧申请的workspace大小，由第一段接口aclnnMaxUnpool2dGetWorkspaceSize获取。
  • executor(aclOpExecutor *, 入参): op执行器，包含了算子计算流程。
  • stream(const aclrtStream, 入参): 指定执行任务的 AscendCL Stream流。

• 返回值：

  aclnnStatus: 返回状态码，具体参见。

调用示例

示例代码如下，仅供参考，具体编译和执行过程请参考。