Настройки Ultralytics#
Ultralytics хранит постоянные настройки для каждой машины в JSON-файле в каталоге конфигурации пользователя и предоставляет доступ к ним через объект settings в Python и команду yolo settings. Эти настройки определяют, где хранятся наборы данных, веса и запуски, какой API-ключ платформы Ultralytics используется и какие средства отслеживания экспериментов включены. Аргументы для отдельных запусков, например 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 | Каталог для хранения весов моделей |
runs_dir | '/path/to/runs' | str | Каталог для хранения запусков экспериментов |
uuid | 'a1b2c3d4' | str | Анонимизированный идентификатор машины (хеш SHA-256), используемый для аналитики |
sync | True | bool | Отправлять Ultralytics анонимизированные данные аналитики и отчёты о сбоях; см. раздел «Конфиденциальность» |
api_key | '' | str | API-ключ платформы Ultralytics |
openai_api_key | '' | str | API-ключ OpenAI для функции Ask AI в 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 | На процессорах Intel показывать подсказку о том, что экспорт в OpenVINO ускорит инференс |