CANN/pypto pow函数API文档

# pypto.pow

【免费下载链接】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 推理系列产品	√

功能说明

计算输入 Tensor中每个元素的 other 次幂，逐元素运算，返回与输入形状相同的Tensor。

函数原型

pow(input: Tensor, other: Union[Tensor, int, float], precision_type: PowAlgorithm = PowAlgorithm.HIGH_PRECISION) -> Tensor

参数说明

参数名	输入/输出	说明
input	输入	源操作数。 支持的类型为：Tensor。 Tensor支持的数据类型为：DT_FP16、DT_BF16、DT_FP32、DT_INT32。 不支持空Tensor；Shape仅支持1-4维；支持按照单个维度广播到相同形状；Shape Size不大于2147483647（即INT32_MAX）。
other	输入	指数。 支持的类型为Tensor、int或float。 Tensor支持的数据类型为：DT_FP16、DT_BF16、DT_FP32、DT_INT32。 不支持空Tensor；Shape仅支持1-4维；支持按照单个维度广播到相同形状；Shape Size不大于2147483647（即INT32_MAX）。
precision_type	输入	精度模式枚举类型，用以控制指数计算的精度模式，具体定义为：PowAlgorithm 。 默认为 HIGH_PRECISION（高精度模式）。

返回值说明

返回一个与输入形状相同的Tensor，其元素为输入Tensor对应元素的other次幂。

当other为int时，返回的Tensor的数据类型与输入相同。

当other为float时，若输入Tensor类型为DT_INT32则返回DT_FP32，否则返回的Tensor的数据类型与输入相同。

当other为Tensor时，返回的Tensor的数据类型见数据类型提升说明章节。

数据类型提升说明

我们约定float32>float16>bfloat16>int32。

1. 当两个输入参数类型一个为float16而另一个bfloat16时输出的数据类型为float32。
2. 其他情况下输出类型为输入参数类型的更大值，如输入float32和float16则输出为float32。

参数类型	float32	float16	bfloat16	int32
float32	float32	float32	float32	float32
float16	float32	float16	float32	float16
bfloat16	float32	float32	bfloat16	bfloat16
int32	float32	float16	bfloat16	int32

调用示例

TileShape设置示例

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

TileShape维度应和输出一致。

示例1：输入input shape为[m, n]，输出为[m, n]，TileShape设置为[m1, n1], 则m1, n1分别用于切分m, n轴。

pypto.set_vec_tile_shapes(4, 16)

接口调用示例

x = pypto.tensor([2, 2], pypto.DT_FP32) a = 2 b = pypto.tensor([2, 2], pypto.DT_FP32) y = pypto.pow(x, a) z = pypto.pow(x, b)

结果示例如下：

输入数据x: [[1.0 2.0], [-3.0 4.0]] 输入数据b: [[2.0 2.0], [1.0 1.0]] 输出数据y: [[1.0 4.0], [9.0 16.0]] 输出数据z: [[1.0 4.0], [-3.0 4.0]]

【免费下载链接】pyptoPyPTO（发音: pai p-t-o）：Parallel Tensor/Tile Operation编程范式。项目地址: https://gitcode.com/cann/pypto