Spec-Zone.ru › TensorFlow 2.9

tf.compat.v1.sparse_add

Складывает два тензора, по меньшей мере один из которых является разреженным. (аргументы устарели)

Просмотр псевдонимов

Псевдонимы для миграции

См. Руководство по миграции для получения дополнительной информации.

tf.compat.v1.sparse.add

tf.compat.v1.sparse_add(
    a, b, threshold=None, thresh=None
)
Устарело: НЕКОТОРЫЕ АРГУМЕНТЫ УСТАРЕЛИ: (thresh). Они будут удалены в будущей версии. Инструкции по обновлению: устарел thresh, используйте threshold вместо него

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

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

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

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

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

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

Тогда,

  • thresh == 0 (по умолчанию): все 5 пар индекс/значение будут возвращены.
  • thresh == 0.11: исчезнут только .1 и 0, и будут возвращены оставшиеся три пары индекс/значение.
  • thresh == 0.21: исчезнут .1, 0 и -.2.
Аргументы
a Первый операнд; разреженный или плотный тензор.
b Второй операнд; разреженный или плотный тензор. По меньшей мере один операнд должен быть разреженным.
threshold Необязательный 0-мерный тензор (по умолчанию 0). Пороговое значение величины, определяющее, будет ли пара значение/индекс выходного тензора занимать место. Его тип данных должен соответствовать типу значений, если они вещественные; если последние являются complex64/complex128, то тип данных должен быть float32/float64 соответственно.
thresh Устаревший псевдоним для threshold.
Возвращаемое значение
Разреженный или плотный тензор, представляющий сумму.
Исключения
TypeError Если оба a и b являются плотными. Используйте 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/compat/v1/sparse_add

Spec-Zone.ru

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