README.md

UpsampleLinear1d

产品支持情况

产品 是否支持
Ascend 950PR/Ascend 950DT ×
Atlas A3 训练系列产品/Atlas A3 推理系列产品
Atlas A2 训练系列产品/Atlas A2 推理系列产品
Atlas 200I/500 A2 推理产品 ×
Atlas 推理系列产品 ×
Atlas 训练系列产品 ×

功能说明

  • 算子功能:对由多个输入通道组成的输入信号应用线性插值算法进行上采样。如果输入shape为(N, C, L),则输出shape为(N, C, outputSize)。

  • 计算公式:

    • 核心算法逻辑:

      1. 将目标图像的每一个点映射回原图,得到一个带小数点的坐标。
      2. 根据这个浮点数坐标,计算前后相邻的原始图像的点。
      3. 分别计算相邻点到对应目标点的权重,按照权重相乘累加即可得到目标点值。
    • 具体计算逻辑: 缩放方式分为角对齐和边对齐,角对齐(alignCorners为true)表示按照原始图片左上角像素中心点对齐,边对齐(alignCorners为false)表示按照原始图片左上角顶点及两条边对齐,在计算缩放系数和坐标位置时存在差异。则有以下公式:

      scale={(self.dim[2]−1)/(outputSize[0]−1)alignCorners=true1/scalesalignCorners=false&scales>0self.dim[2]/outputSize[0]alignCorners=falsescale =\begin{cases} (self.dim[2]-1) / (outputSize[0]-1) & alignCorners=true \\ 1 / scales & alignCorners=false\&scales>0\\ self.dim[2] / outputSize[0] & alignCorners=false \end{cases}

      因此,对于output的某个方向上的点p(x),映射回原始图像中的点记为q(x'),则有关系:

      x′={x∗scale_halignCorners=trueMAX(0,(x+0.5)∗scale_h−0.5)alignCorners=falsex' =\begin{cases} x * scale\_h & alignCorners=true \\ MAX(0,{(x+0.5)*scale\_h-0.5}) & alignCorners=false \end{cases}

      • 记:

        x0=int(x′),x1=int(x′)+1,lambda0=x1−x′,lambda1=1−lambda0x_{0} =int(x'),x_{1} =int(x')+1, lambda_{0} = x_{1}-x', lambda_{1} = 1-lambda_{0}

      • 则有以下公式:

        V(px)=V(px0)∗lambda0+V(px1)∗lambda1{V(p_{x})} = {V(p_{x0})} * {lambda_{0}} + {V(p_{x1})} * {lambda_{1}}

参数说明

参数名 输入/输出/属性 描述 数据类型 数据格式
x 输入 表示进行上采样的输入张量,对应公式中的`self`。 FLOAT32、FLOAT16、BFLOAT16 ND
size 输入 指定输出空间大小,对应公式中的`outputSize`。size为1,且取值大于0。表示指定`y`在H和W维度上的空间大小。 INT32 -
align_corners 可选属性
  • 决定是否对齐角像素点,对应公式中的`alignCorners`。如果设置为true,则输入和输出张量按其角像素的中心点对齐,保留角像素处的值;如果设置为false,则输入和输出张量通过其角像素的角点对齐,并且插值使用边缘值填充用于外界边值。
  • 默认值为false。
BOOL -
scales 可选属性
  • 表示输出`y`的L维度乘数,对应公式中的`scales`。
  • 无默认值。
FLOAT32 -
y 输出 表示采样后的输出张量,对应公式描述中的`output`。数据类型、数据格式与入参`x`的数据类型、数据格式保持一致。 FLOAT32、FLOAT16、BFLOAT16 ND

约束说明

调用说明

调用方式 样例代码 说明
aclnn接口 test_aclnn_upsample_linear1d 通过aclnnUpsampleLinear1d接口方式调用UpsampleLinear1d算子。