tf.keras.utils.get_file
| Просмотреть исходный код на GitHub |
Загружает файл из URL, если он ещё не находится в кэше.
tf.keras.utils.get_file(
fname, origin, untar=False, md5_hash=None, file_hash=None,
cache_subdir='datasets', hash_algorithm='auto', extract=False,
archive_format='auto', cache_dir=None
)
По умолчанию файл по адресу origin загружается в кэш-директорию ~/.keras, помещается в подкаталог datasets, и получает имя файла fname. Поэтому конечное расположение файла example.txt будет ~/.keras/datasets/example.txt.
Также можно извлечь файлы в форматах tar, tar.gz, tar.bz и zip. Передача хэша позволит проверить файл после загрузки. Командные программы shasum и sha256sum могут вычислить хэш.
Пример:
path_to_downloaded_file = tf.keras.utils.get_file(
"flower_photos",
"https://storage.googleapis.com/download.tensorflow.org/example_images/flower_photos.tgz",
untar=True)
| Аргументы | |
|---|---|
fname | Имя файла. Если указан абсолютный путь /path/to/file.txt, файл будет сохранён в этом месте. |
origin | Исходный URL файла. |
untar | Устарело в пользу аргумента extract. Булево значение, указывает нужно ли распаковать файл |
md5_hash | Устарело в пользу аргумента file_hash. md5 хэш файла для проверки. |
file_hash | Ожидаемая строка хэша файла после загрузки. Поддерживаются алгоритмы хэширования sha256 и md5. |
cache_subdir | Подкаталог в директории кэша Keras, где будет сохранён файл. Если указан абсолютный путь /path/to/folder, файл будет сохранён в этом месте. |
hash_algorithm | Выберите алгоритм хэширования для проверки файла. Доступны варианты 'md5', 'sha256', и 'auto'. По умолчанию 'auto' определяет используемый алгоритм хэширования. |
extract | True пытается извлечь файл как архив, например, tar или zip. |
archive_format | Формат архива для попытки извлечения файла. Доступны варианты 'auto', 'tar', 'zip', и None. 'tar' включает файлы tar, tar.gz и tar.bz. По умолчанию 'auto' соответствует ['tar', 'zip']. Значение None или пустой список вернут сообщение о том, что совпадений не найдено. |
cache_dir | Место для хранения кэшированных файлов. Если None, по умолчанию используется стандартный каталог ~/.keras/. |
| Возвращаемые значения | |
|---|---|
| Путь к загруженному файлу |
© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.3/api_docs/python/tf/keras/utils/get_file