tf.keras.utils.get_file

Загружает файл из 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,
    force_download=False
)

Используется в ноутбуках

Используется в руководстве	Используется в учебных пособиях
tf.data: Создание потоков данных TensorFlow Использование формата SavedModel Эстиматоры Миграция кода TFLite в TF2 Использование сопоставления контрфактуальных логитов с Keras	Перенос обучения с TensorFlow Hub Загрузка данных CSV Перенос обучения с YAMNet для классификации звуков окружающей среды Предварительно созданные эстиматоры Перенос стиля нейронной сетью

По умолчанию файл по адресу origin загружается в кэш ~/.keras, помещается в подкаталог datasets и получает имя файла fname. Полный путь к файлу example.txt будет, следовательно, ~/.keras/datasets/example.txt. Файлы в форматах .tar, .tar.gz, .tar.bz и .zip также могут быть распакованы.

Передача хэша позволит проверить файл после загрузки. Командные программы shasum и sha256sum могут вычислить хэш.

Пример:

path_to_downloaded_file = get_file(
    origin="https://storage.googleapis.com/download.tensorflow.org/example_images/flower_photos.tgz",
    extract=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`	Попытка извлечения файла как архива, например, tar или zip.
`archive_format`	Формат архива для извлечения файла. Доступны `"auto'`, `"tar'`, `"zip'` и `None`. `"tar"` включает tar, tar.gz и tar.bz файлы. По умолчанию `"auto"` соответствует `["tar", "zip"]`. None или пустой список вернут "нет совпадений".
`cache_dir`	Место хранения кэшированных файлов; по умолчанию это `$KERAS_HOME`, если переменная среды `KERAS_HOME` установлена, или `~/.keras/`.
`force_download`	Если `True`, файл всегда будет перезагружен независимо от состояния кэша.

Возвращаемое значение
Путь к загруженному файлу.

⚠️ Предупреждение о вредоносных загрузках ⚠️

Загрузка чего-либо из интернета сопряжена с риском. НИКОГДА не загружайте файл/архив, если не доверяете источнику. Рекомендуется указать аргумент file_hash (если хэш исходного файла известен), чтобы убедиться, что загруженный файл соответствует ожидаемому.

© 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/keras/utils/get_file