إعدادات 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 | دليل التنزيل لأوزان النماذج الخاصة بعنوان URL والمنصة (ul://)، والبحث الاحتياطي عن أسماء النماذج المجردة |
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 لتسريع الاستدلال |
يُحمَّل اسم النموذج المجرد مثل YOLO("yolo26n.pt") من دليل العمل الحالي، ثم من weights_dir؛ وإذا لم يوجد في أيٍّ منهما، تُنزَّل الأوزان إلى دليل العمل الحالي. لتنزيلها إلى weights_dir بدلاً من ذلك، مرّر المسار الكامل، مثل YOLO(Path(settings["weights_dir"]) / "yolo26n.pt").
التعليقات
اطرح سؤالًا، وشارك نتائجك، أو ساعد شخصًا آخر.