Paramètres Ultralytics#
Ultralytics stocke des paramètres persistants propres à chaque machine dans un fichier JSON du répertoire de configuration de l’utilisateur et les expose via l’objet settings en Python et la commande yolo settings. Ces paramètres déterminent où sont stockés les jeux de données, les poids et les exécutions, quelle clé API de la plateforme Ultralytics est utilisée et quels outils de suivi des expériences sont activés. Les arguments propres à chaque exécution, tels que imgsz et epochs, sont documentés sur la page Configuration.
Afficher, modifier et réinitialiser les paramètres
from ultralytics import settings
print(settings) # afficher tous les paramètres
value = settings["runs_dir"] # lire un paramètre
settings.update({"runs_dir": "/path/to/runs", "tensorboard": False}) # modifier un ou plusieurs paramètres
settings.reset() # rétablir les valeurs par défautRéférence des paramètres#
| Nom | Valeur d’exemple | Type de données | Description |
|---|---|---|---|
settings_version | '0.0.8' | str | Version du schéma des paramètres, distincte de la version du package ultralytics |
datasets_dir | '/path/to/datasets' | str | Répertoire où sont stockés les jeux de données |
weights_dir | '/path/to/weights' | str | Répertoire où sont stockés les poids des modèles |
runs_dir | '/path/to/runs' | str | Répertoire où sont stockées les exécutions des expériences |
uuid | 'a1b2c3d4' | str | Identifiant anonymisé de la machine (hachage SHA-256) utilisé à des fins d’analyse |
sync | True | bool | Envoyer des données d’analyse anonymisées et des rapports d’incident à Ultralytics ; voir Confidentialité |
api_key | '' | str | Clé API de la plateforme Ultralytics |
openai_api_key | '' | str | Clé API OpenAI pour la fonctionnalité Ask AI de Explorer, disponible jusqu’à ultralytics==8.3.11 |
clearml | True | bool | Activer la journalisation avec ClearML |
comet | True | bool | Activer le suivi des expériences avec Comet ML |
dvc | True | bool | Activer le suivi des expériences avec DVC |
mlflow | True | bool | Activer le suivi des expériences avec MLflow |
raytune | True | bool | Activer les rapports de réglage des hyperparamètres avec Ray Tune |
tensorboard | False | bool | Activer la journalisation avec TensorBoard |
wandb | False | bool | Activer la journalisation avec Weights & Biases |
vscode_msg | True | bool | Afficher une invite proposant d’installer l’extension Ultralytics-Snippets lorsqu’un terminal VS Code est détecté |
openvino_msg | True | bool | Sur les processeurs Intel, afficher un conseil suggérant l’exportation vers OpenVINO pour accélérer l’inférence |