numpy.diag

numpy.diag(v, k=0)

提取对角线或构建对角线数组.

如果你使用这个函数来提取对角线并希望写入结果数组,请参阅更详细的 numpy.diagonal 文档;它返回的是副本还是视图取决于你使用的 numpy 版本.

参数:

varray_like

如果 v 是一个二维数组,返回其 k 行的对角线副本.如果 v 是一个一维数组,返回一个二维数组,其中 v 在 k 行对角线上.

kint, 可选

问题中的对角线.默认值为0.使用 k>0 表示主对角线以上的对角线,使用 k<0 表示主对角线以下的对角线.

返回:

outndarray

提取的对角线或构造的对角线数组.

参见

diagonal

返回指定的对角线.

diagflat

创建一个二维数组,其对角线为展平输入.

trace

沿对角线求和.

triu

数组的上三角部分.

tril

数组的下半三角.

示例

>>> import numpy as np
>>> x = np.arange(9).reshape((3,3))
>>> x
array([[0, 1, 2],
       [3, 4, 5],
       [6, 7, 8]])

>>> np.diag(x)
array([0, 4, 8])
>>> np.diag(x, k=1)
array([1, 5])
>>> np.diag(x, k=-1)
array([3, 7])

>>> np.diag(np.diag(x))
array([[0, 0, 0],
       [0, 4, 0],
       [0, 0, 8]])