numpy.trace#
- numpy.trace(a, offset=0, axis1=0, axis2=1, dtype=None, out=None)[源代码]#
返回数组对角线上的和。
如果 a 是二维的,则返回其沿给定偏移量的对角线上的和,即所有 i 的元素
a[i,i+offset]
的和。如果 a 的维度大于 2,则使用 axis1 和 axis2 指定的轴来确定要返回其迹的二维子数组。结果数组的形状与删除 axis1 和 axis2 的 a 的形状相同。
- 参数:
- aarray_like
输入数组,从中获取对角线。
- offsetint, 可选
对角线与主对角线的偏移量。可以是正数或负数。默认为 0。
- axis1, axis2int, 可选
用作从中获取对角线的二维子数组的第一个和第二个轴的轴。默认为 a 的前两个轴。
- dtypedtype, 可选
确定返回的数组的数据类型以及元素求和的累加器的数据类型。如果 dtype 的值为 None 且 a 的整数类型精度低于默认整数精度,则使用默认整数精度。否则,精度与 a 的精度相同。
- outndarray, 可选
放置输出的数组。其类型被保留,并且它必须具有正确的形状来保存输出。
- 返回:
- sum_along_diagonalsndarray
如果 a 是二维的,则返回沿对角线的和。如果 a 的维度更大,则返回沿对角线的和的数组。
示例
>>> import numpy as np >>> np.trace(np.eye(3)) 3.0 >>> a = np.arange(8).reshape((2,2,2)) >>> np.trace(a) array([6, 8])
>>> a = np.arange(24).reshape((2,2,2,3)) >>> np.trace(a).shape (2, 3)