CANN/PyPTO amax操作API文档

# pypto.amax

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

产品支持情况

功能说明

对一个多维向量在指定的维度求最大值。

定义指定计算的维度（Reduce轴）为R轴，非指定维度（Normal轴）为A轴。如下图所示，对Shape为(2, 3)的二维矩阵进行运算，指定在第一维求最大值，输出结果为[4, 5, 6]；指定在第二维求最大值，输出结果为[3, 6]。

图 1amax按第一个维度计算示例

图 2amax按最后一个维度计算示例

函数原型

amax(input: Tensor, dim: int, keepdim: bool = False) -> Tensor:

参数说明

返回值说明

返回输出Tensor，输出Tensor的Shape与keepdim参数相关。

若keepdim参数为 True，则在执行归约操作后保留被归约的维度。输出Tensor在除dim指定的维度外，其他维度的Shape与输入Tensor的Shape一致，而在dim指定的维度上的大小为 1。

若keepdim参数为False（默认），则被归约的维度会从输出Tensor中移除，而tileshape中对应的维度不变, 所以建议在调其他operation前重设tileshape。

约束说明

1. TileShape大小不超过 64KB；

2. 尾轴要 32bytes 对齐；

调用示例

TileShape设置示例

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

TileShape维度应和输入input一致。

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

pypto.set_vec_tile_shapes(4, 16)

注意：如果keepdim设置为false，则被归约的维度会从输出Tensor中移除，而tileshape中对应的维度不变, 所以建议在调其他operation前重设tileshape。

接口调用示例

x = pypto.tensor([2, 3], pypto.DT_FP32) y = pypto.amax(x, -1, True)

结果示例如下：

输入数据 x: [[1.0 2.0 3.0], [1.0 2.0 3.0]] 输出数据 y: [[3.0], [3.0]]

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