Настройки Ultralytics

Ultralytics хранит постоянные настройки для каждой машины в JSON-файле в пользовательской папке конфигурации и предоставляет к ним доступ через объект settings в Python и команду yolo settings. Эти настройки определяют пути хранения датасетов, весов и результатов запусков, API-ключ Ultralytics Platform и включённые системы отслеживания экспериментов. Аргументы для отдельных запусков, такие как imgsz и epochs, описаны на странице конфигурации.

Просмотр, изменение и сброс настроек

from ultralytics import settings

print(settings)  # просмотреть все настройки
value = settings["runs_dir"]  # прочитать одну настройку
settings.update({"runs_dir": "/path/to/runs", "tensorboard": False})  # изменить одну или несколько настроек
settings.reset()  # восстановить настройки по умолчанию

Справочник по настройкам#

Название	Пример значения	Тип данных	Описание
`settings_version`	`'0.0.8'`	`str`	Версия схемы настроек, отличающаяся от версии пакета `ultralytics`
`datasets_dir`	`'/path/to/datasets'`	`str`	Каталог для хранения наборов данных
`weights_dir`	`'/path/to/weights'`	`str`	Каталог для загрузки весов модели для URL и платформы (`ul://`), а также каталог для поиска по умолчанию по кратким названиям моделей
`runs_dir`	`'/path/to/runs'`	`str`	Каталог для хранения запусков экспериментов
`uuid`	`'a1b2c3d4'`	`str`	Анонимизированный идентификатор машины (хеш SHA-256), используемый для аналитики
`sync`	`True`	`bool`	Отправлять анонимизированные данные аналитики и отчёты о сбоях в Ultralytics; см. раздел Конфиденциальность
`api_key`	`''`	`str`	API-ключ Ultralytics Platform
`openai_api_key`	`''`	`str`	Ключ API OpenAI для функции «Спросить ИИ» в Explorer, доступной до `ultralytics==8.3.11`
`clearml`	`True`	`bool`	Включить журналирование в ClearML
`comet`	`True`	`bool`	Включить отслеживание экспериментов в Comet ML
`dvc`	`True`	`bool`	Включить отслеживание экспериментов с помощью DVC
`mlflow`	`True`	`bool`	Включить отслеживание экспериментов с помощью MLflow
`raytune`	`True`	`bool`	Включить отчётность для Ray Tune и настройки гиперпараметров
`tensorboard`	`False`	`bool`	Включить журналирование с помощью TensorBoard
`wandb`	`False`	`bool`	Включить журналирование с помощью Weights & Biases
`vscode_msg`	`True`	`bool`	Показывать предложение установить расширение Ultralytics-Snippets, если обнаружен терминал VS Code
`openvino_msg`	`True`	`bool`	На CPU Intel показывать подсказку об экспорте в OpenVINO для ускорения инференса

По краткому имени модели, например YOLO("yolo26n.pt"), загрузка выполняется сначала из текущего рабочего каталога, затем из weights_dir; если модель не найдена ни в одном из этих каталогов, веса загружаются в текущий рабочий каталог. Чтобы загружать веса вместо этого в weights_dir, укажи полный путь, например YOLO(Path(settings["weights_dir"]) / "yolo26n.pt").

Участники

glenn-jocher¹

Echoslayer¹

raimbekovm¹

Создано 2 месяца назадОбновлено на прошлой неделе

Настройки Ultralytics

Справочник по настройкам#

Комментарии