tf.compat.v1.cond
Возвращает true_fn() если предикат pred истинный, иначе false_fn(). (устаревшие аргументы)
tf.compat.v1.cond(
pred, true_fn=None, false_fn=None, strict=False, name=None, fn1=None, fn2=None
)
true_fn и false_fn оба возвращают списки выходных тензоров. true_fn и false_fn должны иметь одинаковое ненулевое количество и тип выходов.
Хотя это поведение соответствует модели потока данных TensorFlow, оно часто удивляло пользователей, которые ожидали более ленивой семантики. Рассмотрим следующую простую программу:
z = tf.multiply(a, b) result = tf.cond(x < y, lambda: tf.add(x, z), lambda: tf.square(y))
Если x < y, операция tf.add будет выполнена, а операция tf.square не будет выполнена. Поскольку z необходим хотя бы для одной ветви cond, операция tf.multiply всегда выполняется безусловно.
Обратите внимание, что cond вызывает true_fn и false_fn точно один раз (внутри вызова cond, и совсем не во время Session.run()). cond склеивает фрагменты графа, созданные во время вызовов true_fn и false_fn, с некоторыми дополнительными узлами графа, чтобы гарантировать, что правильная ветвь будет выполнена в зависимости от значения pred.
tf.cond поддерживает вложенные структуры, как реализовано в tensorflow.python.util.nest. true_fn и false_fn должны возвращать одинаковую (возможно, вложенную) структуру значений списков, кортежей и/или именованных кортежей. Исключение составляют только одиночные списки и кортежи: когда они возвращаются true_fn и/или false_fn, они неявно распаковываются в одиночные значения. Это поведение отключено путём передачи strict=True.
| Args | |
|---|---|
pred | Скаляр, определяющий, возвращать ли результат true_fn или false_fn . |
true_fn | Выполняемая функция, если pred истинно. |
false_fn | Выполняемая функция, если pred ложно. |
strict | Логическое значение, которое включает/отключает режим "строгий"; см. выше. |
name | Необязательный префикс имени для возвращаемых тензоров. |
| Returns | |
|---|---|
Тензоры, возвращенные вызовом либо true_fn или false_fn. Если вызываемые функции возвращают одиночный список, элемент извлекается из списка. |
| Raises | |
|---|---|
TypeError | если true_fn или false_fn не являются вызываемыми функциями. |
ValueError | если true_fn и false_fn не возвращают одинакового количества тензоров или возвращают тензоры разных типов. |
Пример:
x = tf.constant(2) y = tf.constant(5) def f1(): return tf.multiply(x, 17) def f2(): return tf.add(y, 23) r = tf.cond(tf.less(x, y), f1, f2) # r is set to f1(). # Operations in f2 (e.g., tf.add) are not executed.
© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.3/api_docs/python/tf/compat/v1/cond