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.4/api_docs/python/tf/keras/utils/get_file