tf.tuple

Группирует тензоры.

tf.tuple(
    tensors, control_inputs=None, name=None
)

Возвращаемые тензоры имеют те же значения, что и входные тензоры, но вычисляются только после вычисления всех входных тензоров.

Примечание: В TensorFlow 2 с eager и/или Autograph этот метод не требуется, поскольку операции выполняются в ожидаемом порядке благодаря автоматическим зависимостям управления. Используйте tf.tuple только при работе с кодом v1 tf.Graph.

См. также tf.group и tf.control_dependencies.

Пример:

with tf.Graph().as_default():
  with tf.compat.v1.Session() as sess:
    v = tf.Variable(0.0)
    a = tf.constant(1.0)
    sess.run(tf.compat.v1.global_variables_initializer())
    for i in range(5):
      update_op = v.assign_add(1.0)
      b = a + v
      res_b = sess.run(b)
      res_v = sess.run(v)
      print(res_v)
0.0
0.0
0.0
0.0
0.0

with tf.Graph().as_default():
  with tf.compat.v1.Session() as sess:
    v = tf.Variable(0.0)
    a = tf.constant(1.0)
    sess.run(tf.compat.v1.global_variables_initializer())
    for i in range(5):
      update_op = v.assign_add(1.0)
      calc = [a + v]
      # `tf.tuple` ensures `update_op` is run before `b`
      b = tf.tuple(calc, [tf.group(update_op)])
      res_b = sess.run(b)
      res_v = sess.run(v)
      print(res_v)
1.0
2.0
3.0
4.0
5.0

Аргументы
`tensors`	Список `Tensor`ов или `IndexedSlices`, некоторые элементы могут быть `None`.
`control_inputs`	Список дополнительных операций, которые нужно завершить перед возвратом.
`name`	(необязательно) Имя, которое будет использоваться как `name_scope` для операции.

Возвращает
То же, что и `tensors`.

Вызывает исключения
`ValueError`	Если `tensors` не содержит ни одного `Tensor` или `IndexedSlices`.
`TypeError`	Если `control_inputs` не является списком объектов `Operation` или `Tensor`.

© 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/tuple