# pypto.add
【免费下载链接】pyptoPyPTO（发音: pai p-t-o）：Parallel Tensor/Tile Operation编程范式。项目地址: https://gitcode.com/cann/pypto
产品支持情况
| 产品 | 是否支持 |
|---|---|
| Ascend 950PR/Ascend 950DT | √ |
| Atlas A3 训练系列产品/Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品/Atlas A2 推理系列产品 | √ |
功能说明
逐元素地将input与other值相加。计算公式如下：
$$ res_i = input_i + alpha \cdot other_i $$
函数原型
add(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仅支持1-4维；支持多维度广播到相同形状；Shape Size不大于2147483647（即INT32_MAX）。 |
| other | 输入 | 源操作数。 支持的类型为float以及Tensor类型。 Tensor支持的数据类型为：DT_FP16，DT_BF16，DT_INT16，DT_INT32，DT_FP32。 不支持空Tensor；Shape仅支持1-4维；支持多维度广播到相同形状；Shape Size不大于2147483647（即INT32_MAX）。 |
| alpha | 输入 | 缩放因子，用于对 other 进行缩放。 支持的类型为：int、float，默认值为1。 关键字参数，必须通过关键字传递。 |
返回值说明
返回输出Tensor，Tensor的数据类型和input、other相同，Shape为input和other广播后大小。
约束说明
- input 和 other 类型应该相同。
- other 为数字的时候，不支持隐式转化。
- other 不支持nan、inf等特殊值
调用示例
TileShape设置示例
调用该operation接口前，应通过set_vec_tile_shapes设置TileShape。
TileShape维度应和输出一致。
如非广播场景，输入input shape为[m, n]，other为[m, n]，输出为[m, n]，TileShape设置为[m1, n1], 则m1, n1分别用于切分m, n轴。
广播场景，输入input shape为[m, n]，other为[m, 1]，输出为[m, n]，TileShape设置为[m1, n1], 则m1, n1分别用于切分m, n轴。
pypto.set_vec_tile_shapes(4, 16)接口调用示例
a = pypto.tensor([1, 3], pypto.DT_FP32) b = pypto.tensor([1, 3], pypto.DT_FP32) out = pypto.add(a, b) a = pypto.tensor([1, 3], pypto.DT_FP32) b = pypto.tensor([1, 3], pypto.DT_FP32) out = pypto.add(a, b, alpha=2)结果示例如下：
输入数据a: [[1.0 2.0 3.0]] 输入数据b: [[2.0 3.0 4.0]] 输出数据out: [[3.0 5.0 7.0]] 输入数据a: [[1.0 2.0 3.0]] 输入数据b: [[2.0 3.0 4.0]] 输出数据out: [[5.0 8.0 11.0]]【免费下载链接】pyptoPyPTO（发音: pai p-t-o）：Parallel Tensor/Tile Operation编程范式。项目地址: https://gitcode.com/cann/pypto
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
