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 исчезнут.
| Аргументы | |
|---|---|
a | Первый операнд; SparseTensor или Tensor. |
b | Второй операнд; SparseTensor или Tensor. По крайней мере, один операнд должен быть разреженным. |
threshold | 0-мерный Tensor. Пороговое значение величины, определяющее, занимает ли пара значение/индекс выходного места. Его тип данных должен совпадать с типом данных значений, если они вещественные; если последние являются complex64/complex128, то тип данных должен быть float32/float64 соответственно. |
| Возвращаемое значение | |
|---|---|
SparseTensor или Tensor, представляющие сумму. |
| Исключения | |
|---|---|
TypeError | Если оба a и b являются Tensor. Используйте tf.add() вместо этого. |
© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/api_docs/python/tf/sparse/add