torch.Tensor.scatter_add_

Tensor.scatter_add_(dim, index, src) → Tensor

Добавляет все значения из тензора src в self по индексам, указанным в тензоре index, аналогично scatter_(). Каждое значение из src добавляется к элементу с индексом в self, который задаётся его индексом в src для dimension != dim и соответствующим значением в index для dimension = dim.

Для 3-мерного тензора self обновляется следующим образом:

self[index[i][j][k]][j][k] += src[i][j][k]  # if dim == 0
self[i][index[i][j][k]][k] += src[i][j][k]  # if dim == 1
self[i][j][index[i][j][k]] += src[i][j][k]  # if dim == 2

self, index и src должны иметь одинаковое количество измерений. Также требуется, чтобы index.size(d) <= src.size(d) для всех измерений d и чтобы index.size(d) <= self.size(d) для всех измерений d != dim. Обратите внимание, что index и src не выполняют широковещательную передачу. Если index пуст, всегда возвращается исходный тензор без дополнительной проверки ошибок.

Примечание

При работе с тензорами на устройстве CUDA эта операция может быть недетерминированной. Дополнительные сведения см. в разделе Воспроизводимость.

Примечание

Обратный проход реализован только для src.shape == index.shape.

Параметры:

• dim (int) – ось, вдоль которой выполняется индексирование
• index (LongTensor) – индексы элементов для распределения и сложения; может быть пустым или иметь те же размерности, что и src. Если тензор пуст, операция возвращает self без изменений.
• src (Tensor) – исходные элементы для распределения и сложения

Пример:

>>> src = torch.ones((2, 5))
>>> index = torch.tensor([[0, 1, 2, 0, 0]])
>>> torch.zeros(3, 5, dtype=src.dtype).scatter_add_(0, index, src)
tensor([[1., 0., 0., 1., 1.],
        [0., 1., 0., 0., 0.],
        [0., 0., 1., 0., 0.]])
>>> index = torch.tensor([[0, 1, 2, 0, 0], [0, 1, 2, 2, 2]])
>>> torch.zeros(3, 5, dtype=src.dtype).scatter_add_(0, index, src)
tensor([[2., 0., 0., 1., 1.],
        [0., 2., 0., 0., 0.],
        [0., 0., 2., 1., 1.]])