tf.queue.RandomShuffleQueue

Реализация очереди, из которой элементы извлекаются в случайном порядке.

Наследуется от: QueueBase

tf.queue.RandomShuffleQueue(
    capacity, min_after_dequeue, dtypes, shapes=None, names=None, seed=None,
    shared_name=None, name='random_shuffle_queue'
)

Описание методов этого класса см. в tf.queue.QueueBase.

Методы

close

Просмотреть исходный код

close(
    cancel_pending_enqueues=False, name=None
)

Закрывает эту очередь.

Эта операция сигнализирует о том, что больше элементов не будут добавлены в указанную очередь. Последующие операции enqueue и enqueue_many завершатся ошибкой. Последующие операции dequeue и dequeue_many будут продолжать выполняться успешно, если в очереди достаточно элементов. В дальнейшем операции dequeue и dequeue_many, которые в противном случае заблокируются, ожидая новых элементов (если close не был вызван), теперь завершатся ошибкой сразу.

Если cancel_pending_enqueues равно True, все ожидающие запросы также будут отменены.

dequeue

Просмотреть исходный код

dequeue(
    name=None
)

Извлекает один элемент из этой очереди.

Если очередь пуста во время выполнения этой операции, она будет заблокирована до тех пор, пока не будет элемента для извлечения.

Во время выполнения эта операция может вызвать ошибку, если очередь tf.QueueBase.close перед или во время её выполнения. Если очередь закрыта, очередь пуста, и нет ожидающих операций добавления, которые могли бы выполнить этот запрос, будет выброшено исключение tf.errors.OutOfRangeError. Если сеанс tf.Session.close, будет выброшено исключение tf.errors.CancelledError.

dequeue_many

Просмотреть исходный код

dequeue_many(
    n, name=None
)

Извлекает и объединяет n элементов из этой очереди.

Эта операция объединяет компоненты тензоров элементов очереди по 0-й размерности, создавая один тензор. Все компоненты в извлечённом кортеже будут иметь размер n по 0-й размерности.

Если очередь закрыта, и осталось меньше n элементов, то возникает исключение OutOfRange.

Во время выполнения эта операция может вызвать ошибку, если очередь tf.QueueBase.close перед или во время её выполнения. Если очередь закрыта, в очереди меньше n элементов, и нет ожидающих операций добавления, которые могли бы выполнить этот запрос, будет выброшено исключение tf.errors.OutOfRangeError. Если сеанс tf.Session.close, будет выброшено исключение tf.errors.CancelledError.

dequeue_up_to

Просмотреть исходный код

dequeue_up_to(
    n, name=None
)

Извлекает и объединяет n элементов из этой очереди.

Примечание: Эта операция не поддерживается всеми очередями. Если очередь не поддерживает DequeueUpTo, то возбуждается tf.errors.UnimplementedError.

Эта операция объединяет компоненты тензоров элементов очереди по 0-й размерности, создавая один тензор. Если очередь не закрыта, все компоненты в извлеченном кортеже будут иметь размер n по 0-й размерности.

Если очередь закрыта, и осталось более 0 но меньше n элементов, вместо того, чтобы выбросить исключение tf.errors.OutOfRangeError как в tf.QueueBase.dequeue_many, возвращается меньше n элементов сразу. Если очередь закрыта и в очереди осталось 0 элементов, то возбуждается tf.errors.OutOfRangeError точно так же, как в dequeue_many. В противном случае поведение идентично dequeue_many.

enqueue

Просмотреть исходный код

enqueue(
    vals, name=None
)

Добавляет один элемент в эту очередь.

Если очередь заполнена во время выполнения этой операции, она будет заблокирована до тех пор, пока элемент не будет добавлен.

Во время выполнения эта операция может вызвать ошибку, если очередь tf.QueueBase.close перед или во время её выполнения. Если очередь закрыта до запуска этой операции, будет возбуждено исключение tf.errors.CancelledError. Если эта операция заблокирована, и либо (i) очередь закрыта операцией close с cancel_pending_enqueues=True, либо (ii) сеанс tf.Session.close, будет возбуждено исключение tf.errors.CancelledError.

enqueue_many

Просмотреть исходный код

enqueue_many(
    vals, name=None
)

Добавляет ноль или более элементов в эту очередь.

Данная операция разделяет каждый компонент тензора по 0-й размерности, чтобы создать несколько элементов очереди. Все тензоры в vals должны иметь одинаковый размер в 0-й размерности.

Если очередь полная во время выполнения этой операции, она будет блокироваться, пока все элементы не будут внесены в очередь.

Во время выполнения эта операция может вызвать ошибку, если очередь tf.QueueBase.close до или во время её выполнения. Если очередь закрыта до начала выполнения этой операции, будет выброшено исключение tf.errors.CancelledError. Если эта операция заблокирована, и (i) очередь закрыта операцией закрытия с cancel_pending_enqueues=True, или (ii) сессия tf.Session.close, будет выброшено исключение tf.errors.CancelledError.

from_list

Просмотреть исходный код

@staticmethod
from_list(
    index, queues
)

Создать очередь, используя ссылку на очередь из queues[index].

is_closed

Просмотреть исходный код

is_closed(
    name=None
)

Возвращает true, если очередь закрыта.

Эта операция возвращает true, если очередь закрыта, и false, если очередь открыта.

size

Просмотреть исходный код

size(
    name=None
)

Вычисление количества элементов в очереди.