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 Использование Counterfactual Logit Pairing с 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`	Ожидаемая строка хеша файла после загрузки. Поддерживаются алгоритмы хеширования SHA-256 и 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_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