tf.compat.v1.scatter_sub

Вычитает разреженные обновления из переменной-ссылки.

tf.compat.v1.scatter_sub(
    ref, indices, updates, use_locking=False, name=None
)

# Scalar indices
ref[indices, ...] -= updates[...]

# Vector indices (for each i)
ref[indices[i], ...] -= updates[i, ...]

# High rank indices (for each i, ..., j)
ref[indices[i, ..., j], ...] -= updates[i, ..., j, ...]

Данная операция выводит ref после выполнения обновления. Это упрощает объединение операций, которым необходимо использовать начальное значение.

Дублированные записи обрабатываются корректно: если несколько indices ссылаются на одно местоположение, их (отрицательные) вклады суммируются.

Требует updates.shape = indices.shape + ref.shape[1:] или updates.shape = [].

Аргументы
`ref`	Изменяемая `Tensor`. Должна быть одного из следующих типов: `float32`, `float64`, `int32`, `uint8`, `int16`, `int8`, `complex64`, `int64`, `qint8`, `quint8`, `qint32`, `bfloat16`, `uint16`, `complex128`, `half`, `uint32`, `uint64`. Должна быть получена из узла `Variable` .
`indices`	`Tensor`. Должна быть одного из следующих типов: `int32`, `int64`. Массив индексов в первом измерении `ref`.
`updates`	`Tensor`. Должен иметь тот же тип, что и `ref`. Массив обновляемых значений, которые необходимо вычесть из `ref`.
`use_locking`	Необязательный `bool`. По умолчанию `False`. Если True, вычитание будет защищено блокировкой; в противном случае поведение не определено, но может иметь меньше конфликтов.
`name`	Имя операции (необязательно).

Возвращает
Изменяемая `Tensor`. Имеет тот же тип, что и `ref`.

© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.3/api_docs/python/tf/compat/v1/scatter_sub