Spec-Zone.ru › TensorFlow

tf.ragged.map_flat_values

Применяет op к flat_values одного или нескольких RaggedTensors.

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

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

Подробнее см. Руководство по миграции.

tf.compat.v1.ragged.map_flat_values

tf.ragged.map_flat_values(
    op, *args, **kwargs
)

Используется в ноутбуках

Используется в руководстве
  • Разреженные тензоры

Заменяет все RaggedTensor в args или kwargs на его flat_values тензор (который сворачивает все разреженные измерения), а затем вызывает op. Возвращает RaggedTensor, построенный из входных RaggedTensor и значения, возвращаемого op.

Если входные аргументы содержат несколько RaggedTensor, то они должны иметь одинаковые nested_row_splits.

Данная операция обычно используется для применения поэлементных операций к каждому значению в RaggedTensor.

Предупреждение: tf.ragged.map_flat_values не применяет op к каждой строке разреженного тензора. Это различие важно для операций, не являющихся поэлементными, таких как tf.reduce_sum. Если вам необходимо применить операцию, не являющуюся поэлементной, к каждой строке разреженного тензора, используйте tf.map_fn вместо этого. (Вам может потребоваться указать output_signature при использовании tf.map_fn с разреженными тензорами.)

Примеры:

rt = tf.ragged.constant([[1, 2, 3], [], [4, 5], [6]])
tf.ragged.map_flat_values(tf.ones_like, rt)
<tf.RaggedTensor [[1, 1, 1], [], [1, 1], [1]]>
tf.ragged.map_flat_values(tf.multiply, rt, rt)
<tf.RaggedTensor [[1, 4, 9], [], [16, 25], [36]]>
tf.ragged.map_flat_values(tf.add, rt, 5)
<tf.RaggedTensor [[6, 7, 8], [], [9, 10], [11]]>

Пример с операцией, не являющейся поэлементной (обратите внимание, что map_flat_values и map_fn возвращают разные результаты):

rt = tf.ragged.constant([[1.0, 3.0], [], [3.0, 6.0, 3.0]])
def normalized(x):
  return x / tf.reduce_sum(x)
tf.ragged.map_flat_values(normalized, rt)
<tf.RaggedTensor [[0.0625, 0.1875], [], [0.1875, 0.375, 0.1875]]>
tf.map_fn(normalized, rt)
<tf.RaggedTensor [[0.25, 0.75], [], [0.25, 0.5, 0.25]]>
Args
op Операция, которая должна быть применена к RaggedTensor flat_values. op обычно является поэлементной операцией (например, math_ops.add), но может быть использована любая операция, сохраняющая размер внешнего измерения. То есть, shape[0] возвращаемого op должно совпадать с shape[0] RaggedTensor flat_values тензора.
*args Аргументы для op.
**kwargs Аргументы ключевых слов для op.
Returns
RaggedTensor, размер ragged_rank которого соответствует размеру ragged_rank всех входных RaggedTensor.
Raises
ValueError Если args не содержит RaggedTensors, или если размеры nested_splits входных RaggedTensor не совпадают.

© 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/ragged/map_flat_values

Spec-Zone.ru

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