torch.diagonal_scatter

torch.diagonal_scatter(input, src, offset=0, dim1=0, dim2=1) → 张量

将 src 张量的值嵌入到 input 张量沿 input 对角线元素的位置，参照维度 dim1 和 dim2。

此函数返回具有新存储空间的张量；它不是一个视图。

参数 offset 控制要考虑哪个对角线

• 如果 offset = 0，则为主对角线。

• 如果 offset > 0，则为主对角线上方。

• 如果 offset < 0，则为主对角线下方。

参数

• input (张量) – 输入张量。必须至少为 2 维。

• src (张量) – 要嵌入到 input 中的张量。

• offset (int, 可选) – 要考虑的对角线。默认值: 0 (主对角线)。

• dim1 (int, 可选) – 计算对角线时参照的第一个维度。默认值: 0。

• dim2 (int, 可选) – 计算对角线时参照的第二个维度。默认值: 1。

注意

src 的大小必须适当，才能嵌入到 input 中。具体来说，它应该与 torch.diagonal(input, offset, dim1, dim2) 具有相同的形状。

示例

>>> a = torch.zeros(3, 3)
>>> a
tensor([[0., 0., 0.],
        [0., 0., 0.],
        [0., 0., 0.]])

>>> torch.diagonal_scatter(a, torch.ones(3), 0)
tensor([[1., 0., 0.],
        [0., 1., 0.],
        [0., 0., 1.]])

>>> torch.diagonal_scatter(a, torch.ones(2), 1)
tensor([[0., 1., 0.],
        [0., 0., 1.],
        [0., 0., 0.]])