Spec-Zone.ru › TensorFlow 2.9

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.
Args
a Первый операнд; SparseTensor или Tensor.
b Второй операнд; SparseTensor или Tensor. По крайней мере один операнд должен быть разреженным.
threshold 0-мерное Tensor. Пороговое значение величины, определяющее, занимает ли пара выходного значение/индекс место. Его тип данных должен совпадать с типом данных значений, если они являются вещественными; если последние являются complex64/complex128, то тип данных должен быть float32/float64 соответственно.
Returns
SparseTensor или Tensor, представляющие сумму.
Raises
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/versions/r2.9/api_docs/python/tf/sparse/add

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API