aclnnUpsampleBilinear2dAA

支持的产品型号

• Atlas A2训练系列产品/Atlas 800I A2推理产品。

接口原型

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

• aclnnStatus aclnnUpsampleBilinear2dAAGetWorkspaceSize(const aclTensor *input, const aclIntArray *outputSize, bool alignCorners, double scalesH, double scalesW, aclTensor *out, uint64_t *workspaceSize, aclOpExecutor **executor)
• aclnnStatus aclnnUpsampleBilinear2dAA(void *workspace, uint64_t workspaceSize, aclOpExecutor *executor, aclrtStream stream)

功能描述

• 算子功能：对由多个输入通道组成的输入信号应用2D双线性抗锯齿采样。
• 计算公式：对于一个二维插值点$(N, C, H, W)$, 插值$I(N, C, H, W)$可以表示为：$${I(N, C, H, W)} = \sum_{i=0}^{kW}\sum_{j=0}^{kH}{w(i) * w(j)} * {f(h_i, w_j)}/\sum_{i=0}^{kW}w(i)/\sum_{j=0}^{kH}w(j)$$ $$scaleH =\begin{cases} (x.dim(2)-1 / outputSize[0]-1) & alignCorners=true \\ 1 / scalesH & alignCorners=false\&scalesH>0\\ x.dim(2) / outputSize[0] & otherwise \end{cases}$$ $$scaleW =\begin{cases} (x.dim(3)-1 / outputSize[1]-1) & alignCorners=true \\ 1 / scalesW & alignCorners=false\&scalesW>0\\ x.dim(3) / outputSize[1] & otherwise \end{cases}$$ 其中：
  • $kW$、$kH$分别表示W方向和H方向影响插入点大小的点的数量
  • 如果$scaleH >= 1$， 则$kH = floor(scaleH) * 2 + 1$，否则$kH = 3$
  • 如果$scaleW >= 1$， 则$kW = floor(scaleW) * 2 + 1$，否则$kW = 3$
  • $f(h_i, w_j)$是原图像在$(h_i, w_j)$的像素值
  • $w(i)$、$w(j)$是双线性抗锯齿插值的W方向和H方向权重，计算公式为：$$w(i) = \begin{cases} 1 - |h_i - h| & |h_i -h| < 1 \\ 0 & otherwise \end{cases}$$ $$w(j) = \begin{cases} 1 - |w_j - w| & |w_i -w| < 1 \\ 0 & otherwise \end{cases}$$

aclnnUpsampleBilinear2dAAGetWorkspaceSize

• 参数说明：

  • input（aclTensor*，计算输入）：Device侧的aclTensor，数据类型支持FLOAT、FLOAT16、BFLOAT16。支持undefined，undefined支持NCHW。shape维度仅支持4维的Tensor。数据类型与出参out一致。
  • outputSize（aclIntArray*，计算输入）：Host侧的aclIntArray，输出空间大小，要求是二维数组，数据类型支持INT64，取值与出参out的H、W维度一样。
  • alignCorners（bool，计算输入）：Host侧bool类型参数，指定是否是角对齐。如果设置为true，则输入和输出张量按其角像素的中心点对齐，保留角像素处的值。如果设置为false，则输入和输出张量通过其角像素的角点对齐，并使用边缘值对边界外的值进行填充。
  • scalesH（double，计算输入）: Host侧double类型参数，空间大小的height维度乘数。
  • scalesW（double，计算输入）: Host侧double类型参数，空间大小的width维度乘数。
  • out（aclTensor*，计算输出）: Device侧的aclTensor，数据类型支持FLOAT、FLOAT16、BFLOAT16。支持undefined，undefined支持NCHW。shape维度仅支持4维的Tensor。数据类型与入参input的数据类型一致。
  • workspaceSize（uint64_t*，出参）：返回用户需要在Device侧申请的workspace大小。
  • executor（aclOpExecutor**，出参）：返回op执行器，包含了算子计算流程。

• 返回值：

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

aclnnUpsampleBilinear2dAA

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

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

约束与限制

无。

调用示例

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