aclnnMaxUnpool3d

支持的产品型号

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

接口原型

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

  • aclnnStatus aclnnMaxUnpool3dGetWorkspaceSize(const aclTensor* self, const aclTensor* indices, const aclIntArray* outputSize, const aclIntArray* stride, const aclIntArray* padding, aclTensor* outRef, uint64_t* workspaceSize, aclOpExecutor** executor)
  • aclnnStatus aclnnMaxUnpool3d(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)

功能描述

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

• 计算公式：

  • 输入为NDHW格式时：

    $$outRef[N][indices[N][i]] = self[N][i]$$

  • 输入为NCDHW格式时：

    $$outRef[N][C][indices[N][C][i]] = self[N][C][i]$$

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

aclnnMaxUnpool3dGetWorkspaceSize

• 参数说明：

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

• 返回值：

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

  [object Object]

aclnnMaxUnpool3d

• 参数说明：

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

• 返回值：

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

约束与限制

无

调用示例

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