tf.sparse.add

Складывает два тензора, по крайней мере один из которых является SparseTensor.

tf.sparse.add(
    a, b, threshold=0
)

Если переданы один SparseTensor и один Tensor, возвращает Tensor. Если оба аргумента являются SparseTensor, это возвращает SparseTensor. Порядок аргументов не важен. Используйте обычную функцию tf.add() для сложения двух плотных Tensor.

Размеры двух операндов должны совпадать: векторизация не поддерживается.

Индексы любого входного SparseTensor предполагаются упорядоченными в стандартном лексикографическом порядке. Если это не так, выполните SparseReorder перед этой операцией, чтобы восстановить порядок индексов.

Если оба аргумента являются разреженными, выполняется «обрезание» следующим образом. По умолчанию, если сумма двух значений равна нулю в некотором индексе, выходной SparseTensor по-прежнему будет включать это местоположение в своём индексе, храня ноль в соответствующей ячейке значений. Для переопределения этого вызывающие функции могут указать threshold, указывая, что если сумма имеет величину строго меньше threshold, соответствующее значение и индекс не будут включены. В частности, threshold == 0.0 (значение по умолчанию) означает, что всё сохраняется, и фактическое пороговое значение происходит только для положительного значения.

Например, предположим, что логическая сумма двух разреженных операндов (в плотном виде) выглядит так:

[       2]
[.1     0]
[ 6   -.2]

Тогда,

• threshold == 0 (значение по умолчанию): все 5 пар индекс/значение будут возвращены.
• threshold == 0.11: исчезнут только .1 и 0, и будут возвращены оставшиеся три пары индекс/значение.
• threshold == 0.21: исчезнут .1, 0 и -.2.