CANN/pypto amin函数API文档

📅 2026/7/2 23:17:10 👁️ 阅读次数 📝 编程学习
CANN/pypto amin函数API文档

# pypto.amin

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

功能说明

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

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

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

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

函数原型

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

参数说明

参数名输入/输出说明
input输入源操作数。
支持的类型为:Tensor。
Tensor支持的数据类型为:DT_FP16,DT_BF16,DT_FP32,DT_INT32,DT_INT16。
不支持空Tensor;Shape仅支持1-4维;Shape Size不大于2147483647(即INT32_MAX)。
dim输入源操作数。
支持任意单轴。
keepdim输入源操作数
控制在进行归约后,是否保持被压缩的维度。
默认值为False。

返回值说明

返回输出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一致。

示例1:输入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.amin(x, -1, True)

结果示例如下:

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

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考