tf.ReaderBase

Базовый класс для разных типов Reader, которые производят запись на каждом шаге.

tf.ReaderBase(
    reader_ref, supports_serialize=False
)

В концептуальном плане Reader преобразует строковые «единицы работы» в записи (пары ключ-значение). Обычно «единицы работы» — это имена файлов, а записи извлекаются из содержимого этих файлов. Мы хотим получить одну запись на шаг, но одна единица работы может соответствовать многим записям.

Поэтому мы вводим некоторое отвязывание, используя очередь. Очередь содержит единицы работы, а Reader извлекает из очереди, когда от него требуется произвести запись (через Read()), но он завершил последнюю единицу работы.

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

Reader не совместимы с выполнением eager. Вместо этого, пожалуйста, используйте tf.data, чтобы получить данные в вашу модель.

Методы

num_records_produced

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

num_records_produced(
    name=None
)

Возвращает количество записей, произведённых этим reader.

Это совпадает с количеством успешных вызовов Read.

num_work_units_completed

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

num_work_units_completed(
    name=None
)

Возвращает количество обработанных единиц работы этим reader.

read

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

read(
    queue, name=None
)

Возвращает следующую пару записей (ключ, значение), произведённую reader.

Будет извлечена единица работы из очереди, если это необходимо (например, когда Reader должен начать чтение из нового файла, так как он завершил предыдущий файл).

read_up_to

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

read_up_to(
    queue, num_records, name=None
)

Возвращает до num_records пар записей (ключ, значение), произведённых reader.

Будет извлечена единица работы из очереди, если это необходимо (например, когда Reader должен начать чтение из нового файла, так как он завершил предыдущий файл). Может вернуть меньше num_records даже до последней партии.

reset

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

reset(
    name=None
)

Восстановление reader в его начальное чистое состояние.

restore_state

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

restore_state(
    state, name=None
)

Восстановление reader до ранее сохранённого состояния.

Не все Reader поддерживают восстановление, поэтому это может вызвать ошибку Unimplemented.

serialize_state

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

serialize_state(
    name=None
)

Производит строковый тензор, кодирующий состояние reader.

Не все Reader поддерживают сериализацию, поэтому это может вызвать ошибку Unimplemented.