tf.keras.utils.get_file
| Просмотреть исходный код на GitHub |
Загружает файл из URL, если он ещё не находится в кэше.
tf.keras.utils.get_file(
fname=None,
origin=None,
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, файл будет сохранён по этому пути. Если None, будет использовано имя файла по адресу origin. |
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/. |
| Возвращает | |
|---|---|
| Путь к загруженному файлу |
© 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/keras/utils/get_file