Trace

产品支持情况

产品	是否支持
Ascend 950PR/Ascend 950DT	√
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas A2 推理系列产品	√
Atlas 200I/500 A2 推理产品	×
Atlas 推理系列产品	√
Atlas 训练系列产品	√

功能说明

• 算子功能： Trace算子用于计算矩阵从左上角开始的主对角线元素的和。

• 计算公式：

  $$out=sum(diag(self))$$

参数说明

参数名	输入/输出	描述	数据类型	数据格式
self	输入	表示输入张量，公式中的输入self。	BFLOAT16、FLOAT16、FLOAT32、COMPLEX64、INT32、INT64、INT16、INT8、UINT8、BOOL	ND
out	输出	表示输出张量，公式中的输出out。	BFLOAT16、FLOAT16、FLOAT32、COMPLEX64、INT64	ND

约束说明

1. self 必须为2D Tensor。
2. 图模式输出为0D标量。
3. ACLNN调用时，out 必须为0D Tensor。
4. 对于形状为 $(M,N)$ 的非方阵，累加的对角线长度为 $\min (M,N)$。
5. 非2D输入或ACLNN调用时非0D输出会返回参数错误。
6. 支持空2D Tensor，结果为0D标量0。

调用说明

调用方式	样例代码	说明
aclnn调用	test_aclnn_trace	通过aclnnTrace接口方式调用Trace算子。
图模式调用	test_geir_trace	通过算子IR构图方式调用Trace算子