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 в коллекцию QUEUE_RUNNER для помещения тензоров из 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; в противном случае оставшиеся элементы отбрасываются. Кроме того, первое значение Dimension статических форм всех выходных тензоров, доступных через свойство shape, будет равно None, и операции, зависящие от фиксированного значения batch_size, завершатся ошибкой.

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