tf.compat.v1.train.shuffle_batch_join

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

tf.compat.v1.train.shuffle_batch_join(
    tensors_list, batch_size, capacity, min_after_dequeue, seed=None,
    enqueue_many=False, shapes=None, allow_smaller_final_batch=False,
    shared_name=None, name=None
)

Аргумент tensors_list — список кортежей тензоров или список словарей тензоров. Каждый элемент в списке обрабатывается аналогично аргументу tensors в tf.compat.v1.train.shuffle_batch().

Эта версия помещает в очередь различные списки тензоров в разных потоках. Она добавляет следующее к текущему Graph:

• Очередь перемешивания, в которую помещаются тензоры из tensors_list.
• Операцию dequeue_many для создания пакетов из очереди.
• Коллекцию QueueRunner для помещения в очередь тензоров из tensors_list.

Будут запущены len(tensors_list) потоков, при этом поток i помещает в очередь тензоры из tensors_list[i]. tensors_list[i1][j] должны соответствовать tensors_list[i2][j] по типу и форме, за исключением первого измерения, если enqueue_many имеет значение true.

Если enqueue_many равно False, каждый tensors_list[i] предполагается, что представляет собой отдельный пример. Входной тензор с формой [x, y, z] будет выведен как тензор с формой [batch_size, x, y, z].

Если enqueue_many равно True, tensors_list[i] предполагается, что представляет собой пакет примеров, где первое измерение индексируется примером, и все члены tensors_list[i] должны иметь одинаковый размер в первом измерении. Если входной тензор имеет форму [*, x, y, z], выходной тензор будет иметь форму [batch_size, x, y, z].

Аргумент capacity управляет тем, насколько долго предварительная выборка разрешает увеличение очередей.

Возвращаемая операция — это операция удаления из очереди, и она сгенерирует tf.errors.OutOfRangeError, если входная очередь исчерпана. Если эта операция подает в другую входную очередь, её диспетчер очереди перехватит это исключение. Однако, если эта операция используется в главном потоке, вы сами ответственны за перехват этого исключения.

Если allow_smaller_final_batch равно True, меньшее значение пакета, чем batch_size возвращается, когда очередь закрыта, и нет достаточного количества элементов для заполнения пакета, в противном случае ожидающие элементы отбрасываются. Кроме того, все статические формы выходных тензоров, доступные через свойство shape, будут иметь первое значение Dimension равное None, а операции, зависящие от фиксированного batch_size, завершатся ошибкой.

Совместимость с Eager

Потоки ввода данных, основанные на очередях, не поддерживаются при включенном режиме eager. Пожалуйста, используйте API tf.data для приема данных при включенном режиме eager.