torch.diagflat

torch.diagflat(input, offset=0) → Tensor

• Если input является вектором (тензором 1-й размерности), то возвращает 2-мерный квадратный тензор с элементами input в качестве диагонали.
• Если input является тензором с более чем одной размерностью, то возвращает 2-мерный тензор с диагональными элементами, равными расплощенному input.

Аргумент offset определяет, какую диагональ учитывать:

• Если offset = 0, то это главная диагональ.
• Если offset > 0, то это диагональ выше главной диагонали.
• Если offset < 0, то это диагональ ниже главной диагонали.

Параметры

• input (Tensor) – входной тензор.
• offset (int, optional) – диагональ для рассмотрения. По умолчанию: 0 (главная диагональ).

Примеры:

>>> a = torch.randn(3)
>>> a
tensor([-0.2956, -0.9068,  0.1695])
>>> torch.diagflat(a)
tensor([[-0.2956,  0.0000,  0.0000],
        [ 0.0000, -0.9068,  0.0000],
        [ 0.0000,  0.0000,  0.1695]])
>>> torch.diagflat(a, 1)
tensor([[ 0.0000, -0.2956,  0.0000,  0.0000],
        [ 0.0000,  0.0000, -0.9068,  0.0000],
        [ 0.0000,  0.0000,  0.0000,  0.1695],
        [ 0.0000,  0.0000,  0.0000,  0.0000]])

>>> a = torch.randn(2, 2)
>>> a
tensor([[ 0.2094, -0.3018],
        [-0.1516,  1.9342]])
>>> torch.diagflat(a)
tensor([[ 0.2094,  0.0000,  0.0000,  0.0000],
        [ 0.0000, -0.3018,  0.0000,  0.0000],
        [ 0.0000,  0.0000, -0.1516,  0.0000],
        [ 0.0000,  0.0000,  0.0000,  1.9342]])