aclnnUpsampleNearest2dV2

产品支持情况

产品	是否支持
[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]	√

功能说明

• 算子功能：对由四个输入通道组成的输入信号应用最近邻精确插值算法进行上采样。如果输入shape为（N，C，H，W），则输出shape为（N，C，outputSize[0]，outputSize[1]）。

  本接口相较于undefined，增加入参scalesH、scalesW，请根据实际情况选择合适的接口。

• 计算公式：

  $$h_{src} = min(floor(h_{dst} * scalesH), H - 1)$$ $$w_{src} = min(floor(w_{dst} * scalesW), W - 1)$$ $$out(N, C, h_{dst}, w_{dst}) = self(N, C, h_{src}, w_{src})$$

函数原型

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

• aclnnStatus aclnnUpsampleNearest2dV2GetWorkspaceSize(const aclTensor *self, const aclIntArray *outputSize, float scalesH, float scalesW, aclTensor *out, uint64_t *workspaceSize, aclOpExecutor **executor)
• aclnnStatus aclnnUpsampleNearest2dV2(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)

aclnnUpsampleNearest2dV2GetWorkspaceSize

• 参数说明：

  • self（aclTensor*，计算输入）：公式中的self，Device侧的aclTensor。表示进行上采样的输入数据。支持undefined，支持空Tensor。undefined支持NCHW、NHWC。当数据类型为DOUBLE、UINT8时，self的H轴和W轴均要满足小于2^24；其他数据类型时，self的所有轴取值均要满足小于等于(2^31-1)。输入维度必须是4维。
    • [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]：数据类型支持FLOAT、BFLOAT16、FLOAT16、DOUBLE、UINT8。
    • [object Object]Atlas 推理系列产品[object Object]、[object Object]Atlas 训练系列产品[object Object]：数据类型支持FLOAT16、DOUBLE、UINT8。
  • outputSize（aclIntArray*,计算输入）：Host侧的aclIntArray，表示指定out在H和W维度上的空间大小。数据类型支持INT64。outputSize的维度必须为2，且各元素均不等于零。
  • scalesH（float，计算输入）：公式中的scalesH，Host侧的FLOAT型参数，指定空间大小纵轴的乘数。
  • scalesW（float，计算输入）：公式中的scalesW，Host侧的FLOAT型参数，指定空间大小横轴的乘数。
  • out（aclTensor*，计算输出）：公式中的out，Device侧的aclTensor。表示进行上采样的输出结果。支持undefined，支持空Tensor。undefined支持NCHW、NHWC，输出维度必须是4维。数据类型和数据格式需要与入参self的数据类型和数据格式保持一致。当数据类型为FLOAT、BFLOAT16、FLOAT16时，out的所有轴取值均要满足小于等于(2^31-1)。
    • [object Object]Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件[object Object]、[object Object]Atlas A3 训练系列产品/Atlas A3 推理系列产品[object Object]：数据类型支持FLOAT、BFLOAT16、FLOAT16、DOUBLE、UINT8。
    • [object Object]Atlas 推理系列产品[object Object]、[object Object]Atlas 训练系列产品[object Object]：数据类型支持FLOAT16、DOUBLE、UINT8。
  • workspaceSize（uint64_t*，出参）：返回需要在Device侧申请的workspace大小。
  • executor（aclOpExecutor**，出参）：返回op执行器，包含了算子计算流程。

• 返回值：

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

  [object Object]

aclnnUpsampleNearest2dV2

• 参数说明：

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

• 返回值：

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

约束说明

参数outputSize与参数scalesH、scalesW，在使用时二选一，即：

• 当入参scalesH或入参scalesW的值小于等于0时，使用入参outputSize的参数值。
• 当入参scalesH和入参scalesW的值都大于0时，使用入参scalesH和入参scalesW的参数值，且$outputSize=[floor(self\_H * scalesH)，floor(self\_W * scalesW)]$。

调用示例

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