tf.ragged.map_flat_values
Применяет op к flat_values одного или нескольких RaggedTensors.
tf.ragged.map_flat_values(
op, *args, **kwargs
)
Используется в ноутбуках
| Используется в руководстве |
|---|
Заменяет все RaggedTensor в args или kwargs на его flat_values тензор (который сворачивает все разреженные измерения), а затем вызывает op. Возвращает RaggedTensor, построенный из входных RaggedTensor и значения, возвращаемого op.
Если входные аргументы содержат несколько RaggedTensor, то они должны иметь одинаковые nested_row_splits.
Данная операция обычно используется для применения поэлементных операций к каждому значению в RaggedTensor.
Примеры:
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