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 в очередь QUEUE_RUNNER.

Будут запущены 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, завершатся ошибкой.

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