tf.compat.v1.WholeFileReader
Считыватель, который выводит всё содержимое файла в качестве значения.
Наследуется от: ReaderBase
tf.compat.v1.WholeFileReader(
name=None
)
Для использования поставьте имена файлов в очередь. Результатом Read будут имя файла (ключ) и содержимое этого файла (значение).
Поддерживаемые методы см. в ReaderBase.
| Аргументы | |
|---|---|
name | Имя операции (необязательно). |
| Атрибуты | |
|---|---|
reader_ref | Операция, реализующая считыватель. |
supports_serialize | Может ли реализация считывателя сериализовать своё состояние. |
Методы
num_records_produced
num_records_produced(
name=None
)
Возвращает количество записей, выданных этим считывателем.
Это число совпадает с количеством успешно выполненных операций Read.
| Аргументы | |
|---|---|
name | Имя операции (необязательно). |
| Возвращает | |
|---|---|
| Тензор типа int64. |
num_work_units_completed
num_work_units_completed(
name=None
)
Возвращает количество рабочих единиц, обработку которых завершил этот считыватель.
| Аргументы | |
|---|---|
name | Имя операции (необязательно). |
| Возвращает | |
|---|---|
| Тензор типа int64. |
read
read(
queue, name=None
)
Возвращает следующую пару записей (ключ, значение), полученную от считывателя.
При необходимости извлекает рабочую единицу из очереди (например, когда считывателю нужно начать чтение нового файла, поскольку чтение предыдущего файла завершено).
| Аргументы | |
|---|---|
queue | Queue или изменяемый строковый тензор, представляющий дескриптор Queue, содержащей строковые рабочие элементы. |
name | Имя операции (необязательно). |
| Возвращает | |
|---|---|
| Кортеж тензоров (ключ, значение). | |
key | Строковый скалярный тензор. |
value | Строковый скалярный тензор. |
read_up_to
read_up_to(
queue, num_records, name=None
)
Возвращает до num_records пар (ключ, значение), полученных от считывателя.
При необходимости извлекает рабочую единицу из очереди (например, когда считывателю нужно начать чтение нового файла, поскольку чтение предыдущего файла завершено). Даже до последней порции может быть возвращено меньше записей, чем num_records.
| Аргументы | |
|---|---|
queue | Queue или изменяемый строковый тензор, представляющий дескриптор Queue, содержащей строковые рабочие элементы. |
num_records | Количество записей для чтения. |
name | Имя операции (необязательно). |
| Возвращает | |
|---|---|
| Кортеж тензоров (ключи, значения). | |
keys | Одномерный строковый тензор. |
values | Одномерный строковый тензор. |
reset
reset(
name=None
)
Возвращает считыватель в исходное чистое состояние.
| Аргументы | |
|---|---|
name | Имя операции (необязательно). |
| Возвращает | |
|---|---|
| Созданная операция. |
restore_state
restore_state(
state, name=None
)
Возвращает считыватель к ранее сохранённому состоянию.
Не все считыватели поддерживают восстановление состояния, поэтому эта операция может вызвать ошибку Unimplemented.
| Аргументы | |
|---|---|
state | Строковый тензор. Результат SerializeState для считывателя соответствующего типа. |
name | Имя операции (необязательно). |
| Возвращает | |
|---|---|
| Созданная операция. |
serialize_state
serialize_state(
name=None
)
Создаёт строковый тензор, кодирующий состояние считывателя.
Не все считыватели поддерживают сериализацию, поэтому эта операция может вызвать ошибку Unimplemented.
| Аргументы | |
|---|---|
name | Имя операции (необязательно). |
| Возвращает | |
|---|---|
| Строковый тензор. |
Совместимость с eager execution
Считыватели несовместимы с eager execution. Вместо этого используйте tf.data, чтобы передать данные в модель.
© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/api_docs/python/tf/compat/v1/WholeFileReader