إعدادات 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 لتسريع الاستدلال |