Link to this sectionتتبع التجارب باستخدام Neptune#

Neptune هو متجر بيانات وصفية لعمليات MLOps، تم تصميمه للفرق التي تجري الكثير من التجارب. فهو يمنحك مكانًا واحدًا لتسجيل وتخزين وعرض وتنظيم ومقارنة والاستعلام عن جميع بياناتك الوصفية لبناء النماذج.

يتكامل Ultralytics YOLO26 مع Neptune لتبسيط تتبع التجارب. يسمح لك هذا التكامل بتسجيل مقاييس التدريب تلقائيًا، وتصور تنبؤات النموذج، وتخزين نواتج النموذج دون الحاجة لكتابة تعليمات برمجية مخصصة للتسجيل.

Link to this sectionالميزات الرئيسية#

• التسجيل المؤتمت: تسجيل مقاييس التدريب الرئيسية تلقائيًا مثل خسارة الصندوق (box loss)، وخسارة التصنيف (classification loss)، وmAP.
• تصور الصور: عرض فسيفساء التدريب وتنبؤات التحقق مباشرة في لوحة تحكم Neptune.
• نقاط حفظ النموذج: تحميل والتحكم في إصدار أوزان النموذج المدرب (best.pt) تلقائيًا في نهاية التدريب.
• تتبع المعاملات الفائقة: تسجيل جميع معاملات الإعداد لضمان إمكانية تكرار تجاربك بالكامل.
• الرسوم البيانية التفاعلية: تصور مصفوفات الارتباك (confusion matrices) ومنحنيات الدقة والاستدعاء (precision-recall curves) لتحليل أداء النموذج.

Link to this sectionالتثبيت#

لاستخدام Neptune مع Ultralytics، ستحتاج إلى تثبيت حزمة عميل neptune جنبًا إلى جنب مع ultralytics.

# Install the required packages
pip install ultralytics neptune

# Enable Neptune integration in Ultralytics settings
yolo settings neptune=True

Link to this sectionالإعدادات#

قبل البدء في التدريب، تحتاج إلى توصيل بيئتك المحلية بمشروع Neptune الخاص بك. ستحتاج إلى رمز API واسم المشروع من لوحة تحكم Neptune الخاصة بك.

Link to this sectionالحصول على بيانات الاعتماد الخاصة بك#

1. سجل الدخول إلى Neptune.ai.
2. أنشئ مشروعًا جديدًا (أو اختر مشروعًا موجودًا).
3. انتقل إلى قائمة المستخدم الخاصة بك واحصل على رمز API.

Link to this sectionتعيين متغيرات البيئة#

الطريقة الأكثر أمانًا للتعامل مع بيانات الاعتماد هي عبر متغيرات البيئة. لاحظ أن رد اتصال Ultralytics Neptune يقرأ وسيطة project الخاصة بـ YOLO ولا يستخدم NEPTUNE_PROJECT. قم بتمرير مسار Neptune الكامل (مثلاً، workspace/name) عبر project= في أمر التدريب الخاص بك؛ وإلا سيحاول Neptune استخدام القيمة الافتراضية الحرفية "Ultralytics" وسيفشل التشغيل.

export NEPTUNE_API_TOKEN="your_long_api_token_here" # required

Link to this sectionالاستخدام#

بمجرد التكوين، يمكنك البدء في تدريب نماذج YOLO26 الخاصة بك. يعمل تكامل Neptune تلقائيًا عند تثبيت حزمة neptune وتمكين التكامل في الإعدادات.

Link to this sectionمثال على التدريب#

from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n.pt")

# Train the model
# Pass the Neptune project slug as the 'project' argument (workspace/name)
results = model.train(data="coco8.yaml", epochs=10, project="my-workspace/my-project", name="experiment-1")

Link to this sectionفهم التكامل#

يوضح الرسم البياني التالي كيفية تفاعل خط أنابيب تدريب Ultralytics مع Neptune لتسجيل النواتج والمقاييس المختلفة.

graph LR
    A[YOLO Training Loop] --> B{Neptune Callback}
    B -->|Log Scalars| C[Loss, mAP, LR]
    B -->|Log Images| D[Mosaics, Preds]
    B -->|Log Artifacts| E[Model Weights]
    B -->|Log Metadata| F[Hyperparameters]

    C --> G[Neptune Server]
    D --> G
    E --> G
    F --> G

    G --> H[Neptune Web Dashboard]

Link to this sectionما الذي يتم تسجيله؟#

عند تشغيل أمر التدريب، يلتقط تكامل Neptune تلقائيًا هيكل البيانات التالي في عملية التشغيل الخاصة بك:

1. الإعدادات/المعاملات الفائقة: يتم تسجيل جميع وسيطات التدريب (epochs، lr0، optimizer، إلخ) تحت قسم الإعدادات.
2. الإعدادات/النموذج: بنية النموذج وتعريفه.
3. المقاييس:
   • التدريب: box_loss، cls_loss، dfl_loss، lr (معدل التعلم).
   • المقاييس: precision، recall، mAP50، mAP50-95.
4. الصور:
   • Mosaic: دفعات التدريب التي تعرض زيادة البيانات.
   • Validation: تسميات الحقيقة الأرضية وتنبؤات النموذج على بيانات التحقق.
   • Plots: مصفوفات الارتباك، ومنحنيات الدقة والاستدعاء.
5. الأوزان: يتم تحميل النموذج المدرب النهائي (best.pt) إلى مجلد weights في تشغيل Neptune.

Link to this sectionالاستخدام المتقدم#

Link to this sectionتنظيم عمليات التشغيل#

يمكنك استخدام وسيطات project وname القياسية في Ultralytics لتنظيم عملياتك في Neptune.

• project: يجب أن يكون مسار مشروع Neptune workspace/name؛ وهذا ما يمرره رد الاتصال إلى neptune.init_run.
• name: يعمل كمعرف لعملية التشغيل المحددة.

Link to this sectionالتسجيل المخصص#

إذا كنت بحاجة إلى تسجيل مقاييس مخصصة إضافية بجانب التسجيل التلقائي، يمكنك الوصول إلى مثيل تشغيل Neptune. لاحظ أنك ستحتاج إلى تعديل منطق المدرب أو إنشاء رد اتصال مخصص للوصول إلى كائن التشغيل المحدد، حيث يتعامل تكامل Ultralytics مع دورة حياة التشغيل داخليًا.

Link to this sectionالأسئلة الشائعة#

Link to this sectionكيف يمكنني تعطيل تسجيل Neptune؟#

إذا قمت بتثبيت neptune ولكنك ترغب في تعطيل التسجيل لجلسة محددة أو عالميًا، يمكنك تعديل إعدادات YOLO.

# Disable Neptune integration
yolo settings neptune=False

Link to this sectionصور لا يتم تحميلها. ما المشكلة؟#

تأكد من أن شبكتك تسمح بالاتصال بخوادم Neptune. بالإضافة إلى ذلك، يحدث تسجيل الصور عادةً في فترات زمنية محددة (على سبيل المثال، نهاية الدورات أو نهاية التدريب). إذا قمت بمقاطعة التدريب مبكرًا باستخدام Ctrl+C، فقد لا يتم تحميل بعض النواتج النهائية مثل مصفوفات الارتباك أو أفضل أوزان للنموذج.

Link to this sectionهل يمكنني التسجيل في معرف تشغيل Neptune محدد؟#

يقوم التكامل الحالي بإنشاء عملية تشغيل جديدة تلقائيًا لكل جلسة تدريب. لاستئناف التسجيل في عملية تشغيل موجودة، ستحتاج عادةً إلى التعامل مع تهيئة Neptune يدويًا في كود Python، وهو ما يقع خارج نطاق التكامل التلقائي. ومع ذلك، يدعم Ultralytics استئناف التدريب محليًا، مما سيؤدي إلى إنشاء عملية تشغيل جديدة في Neptune لتتبع الدورات المستأنفة.

Link to this sectionأين يمكنني العثور على أوزان النموذج في Neptune؟#

في لوحة تحكم Neptune الخاصة بك، انتقل إلى قسم Artifacts أو All Metadata. ستجد مجلد weights يحتوي على ملف best.pt الخاص بك، والذي يمكنك تنزيله للنشر.