إعدادات 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 | مفتاح OpenAI API لميزة «اسأل الذكاء الاصطناعي» في 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 لتسريع الاستدلال |