tf.data.experimental.load
Загрузка ранее сохранённого набора данных.
tf.data.experimental.load(
path, element_spec=None, compression=None, reader_func=None
)
Пример использования:
import tempfile path = os.path.join(tempfile.gettempdir(), "saved_data") # Save a dataset dataset = tf.data.Dataset.range(2) tf.data.experimental.save(dataset, path) new_dataset = tf.data.experimental.load(path) for elem in new_dataset: print(elem) tf.Tensor(0, shape=(), dtype=int64) tf.Tensor(1, shape=(), dtype=int64)
Обратите внимание, что для загрузки ранее сохранённого набора данных необходимо указать element_spec — тип значений элементов сохранённого набора данных, который можно получить с помощью tf.data.Dataset.element_spec. Это требование необходимо для того, чтобы вывод формы загруженного набора данных не требовал операций ввода-вывода.
Если был использован параметр по умолчанию для фрагментации сохранённого набора данных, порядок элементов сохранённого набора данных будет сохранён при его загрузке.
Аргумент reader_func может быть использован для указания пользовательского порядка, в котором элементы должны загружаться из отдельных фрагментов. reader_func должен принимать один аргумент — набор наборов данных, каждый из которых содержит элементы одного из фрагментов, — и возвращать набор элементов. Например, порядок фрагментов можно перемешать при их загрузке следующим образом:
def custom_reader_func(datasets):
datasets = datasets.shuffle(NUM_SHARDS)
return datasets.interleave(lambda x: x, num_parallel_calls=AUTOTUNE)
dataset = tf.data.experimental.load(
path="/path/to/data", ..., reader_func=custom_reader_func)
| Аргументы | |
|---|---|
path | Обязательный. Путь к ранее сохранённому набору данных. |
element_spec | Необязательный. Вложенная структура объектов tf.TypeSpec, соответствующая структуре элемента сохранённого набора данных, и определяющая тип отдельных элементов. Если не указан, используется вложенная структура tf.TypeSpec, сохранённая вместе с набором данных. Этот аргумент необходимо указать, если метод выполняется в режиме графа. |
compression | Необязательный. Алгоритм для разархивирования данных при чтении. Поддерживаются GZIP и NONE. По умолчанию NONE. |
reader_func | Необязательный. Функция для управления чтением данных из фрагментов. Если указана, функция будет отслеживаться и выполняться как вычисление графа. |
| Возвращаемое значение | |
|---|---|
Экземпляр tf.data.Dataset. |
| Исключения | |
|---|---|
FileNotFoundError | Если element_spec не указан, и вложенная структура сохранённых tf.TypeSpec не может быть найдена вместе с сохранённым набором данных. |
ValueError | Если element_spec не указан и метод выполняется в режиме графа. |
© 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/versions/r2.9/api_docs/python/tf/data/experimental/load