tf.sparse.add
| Просмотреть исходный код на GitHub |
Складывает два тензора, по крайней мере один из которых является 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 исчезнут.
| Аргументы | |
|---|---|
a | Первый операнд; SparseTensor или Tensor. |
b | Второй операнд; SparseTensor или Tensor. По крайней мере, один операнд должен быть разреженным. |
threshold | 0-мерный Tensor. Величина порога, определяющая, занимает ли пара значение/индекс места в выходе. Его тип данных должен совпадать с типом данных значений, если они вещественные; если последние — complex64/complex128, то тип данных должен быть float32/float64 соответственно. |
| Возвращаемое значение | |
|---|---|
SparseTensor или Tensor, представляющие сумму. |
| Исключения | |
|---|---|
TypeError | Если оба a и b являются Tensor. Используйте tf.add() вместо этого. |
© 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/sparse/add