pypto.sub#

产品支持情况#

产品

是否支持

Ascend 950PR/Ascend 950DT

√

Atlas A3 训练系列产品/Atlas A3 推理系列产品

√

Atlas A2 训练系列产品/Atlas A2 推理系列产品

√

功能说明#

逐元素从input中减去other值。计算公式如下：

\[ res_i = input_i - alpha \cdot other_i \]

函数原型#

sub(input: Tensor, other: Union[Tensor, float], *, alpha: Union[int, float] = 1) -> Tensor

参数说明#

参数名

输入/输出

说明

input

输入

源操作数。
支持的类型为：Tensor。
Tensor支持的数据类型为：DT_FP16，DT_BF16, DT_INT16，DT_INT32，DT_FP32。
不支持空Tensor；Shape仅支持2-4维；当数据类型为DT_FP32或DT_FP16时，支持多维度广播到相同形状，其他类型支持单个维度广播到相同形状；Shape Size不大于2147483647（即INT32_MAX）。

other

输入

源操作数。
支持的类型为float以及Tensor类型。
Tensor支持的数据类型为：DT_FP16，DT_BF16, DT_INT16，DT_INT32，DT_FP32。
不支持空Tensor；Shape仅支持2-4维；当数据类型为DT_FP32或DT_FP16时，支持多维度广播到相同形状，其他类型支持单个维度广播到相同形状；Shape Size不大于2147483647（即INT32_MAX）。

alpha

输入

缩放因子，用于对 other 进行缩放。
支持的类型为：int、float，默认值为1。
关键字参数，必须通过关键字传递。

返回值说明#

返回输出Tensor，Tensor的数据类型和input、other相同，Shape为input和other广播后大小。

约束说明#

  1. input 和 other 类型应该相同。

  2. other 为数字的时候，不支持隐式转化。

  3. other 不支持nan、inf等特殊值

调用示例#

TileShape设置示例#

说明：调用该operation接口前，应通过set_vec_tile_shapes设置TileShape。

TileShape维度应和输出一致。

示例1：非广播场景，输入intput shape为[m, n]，other为[m, n]，输出为[m, n]，TileShape设置为[m1, n1], 则m1, n1分别用于切分m, n轴。

pypto.set_vec_tile_shapes(4, 16)

示例2：广播场景，输入intput shape为[m, n]，other为[m, 1]，输出为[m, n]，TileShape设置为[m1, n1], 则m1, n1分别用于切分m, n轴。

pypto.set_vec_tile_shapes(4, 16)

接口调用示例#

x = pypto.tensor([2, 3], pypto.DT_FP32)
y = pypto.tensor([2, 3], pypto.DT_FP32)
z = pypto.sub(x, y)
# Using a scalar and alpha
c = pypto.sub(x, 2.0, alpha=3)

结果示例如下：

输入数据x: : [[9.0 9.0 9.0],
              [9.0 9.0 9.0]]
输入数据y:   [[1.0 2.0 3.0],
              [1.0 2.0 3.0]]
输出数据z:   [[8.0 7.0 6.0],
              [8.0 7.0 6.0]]
输出数据c:   [[3.0 3.0 3.0],
              [3.0 3.0 3.0]]