كيفية ترحيل نماذج Ultralytics YOLO من W\&B إلى Ultralytics Platform

في مشاريع الرؤية الحاسوبية، لا يشكّل تدريب النموذج سوى جزء واحد من سير العمل. ومع تزايد عدد تجاربك، ستحتاج أيضًا إلى إدارة إصدارات النماذج، وتتبع مقاييس التدريب، ومقارنة النتائج، والاستفادة من النماذج المدرّبة في تطبيقات العالم الحقيقي.

تُعدّ Weights & Biases (W&B) أداة شائعة الاستخدام لتتبع التجارب في تعلّم الآلة. إذا كنت تعمل باستخدام Ultralytics YOLO، فربما تستخدم W&B بالفعل لتسجيل مقاييس التدريب مثل الخسارة وmAP والدقة والاستدعاء، وإدارة أوزان النماذج، وتصوير أداء التجارب.

مع انتقال مشاريعك من التجريب إلى النشر، قد ترغب في إدارة النماذج وتقييم أدائها وتصديرها ونشرها من مكان واحد.

يمكن لـ Ultralytics Platform استيراد نقاط التحقق المؤهلة لنماذج Ultralytics YOLO وسجلات تدريبها مباشرةً من W&B. لست بحاجة إلى إعادة تدريب أي شيء؛ فبمجرد استيراد نماذجك، يمكنك اختبار الاستدلال وتصديرها ونشرها.

يشرح هذا الدليل كيفية إعداد نماذجك وسجلات التدريب، واستيراد النماذج عبر تكامل W&B، ورفع نقاط التحقق يدويًا، وتتبع عمليات التدريب المستقبلية في Ultralytics Platform.

قبل الترحيل: راجع النماذج وبيانات التدريب الحالية#

في W&B، تتوافق تجربة التدريب عادةً مع عملية تشغيل، ويمكن تنظيم عدة عمليات تشغيل ضمن مشروع واحد. ويمكن تخزين أوزان النماذج ومخرجات التدريب الأخرى وإصدارها كعناصر.

قبل ترحيل نماذج Ultralytics YOLO، تحقق مما يلي:

• أوزان النموذج: ملفات مثل best.pt، التي تخزّن أفضل نقطة تحقق أداءً من التدريب.
• إعدادات التدريب: معلمات مثل معدل التعلّم وعدد الحقب وحجم الصورة.
• مقاييس التدريب: مقاييس مثل الخسارة وmAP والدقة والاستدعاء.
• سجل التدريب: سجلات التجارب والمقاييس المسجلة في كل حقبة.

ما الذي يمكن لـ Ultralytics Platform استيراده؟#

من خلال تكامل W&B الرسمي، يمكن لـ Ultralytics Platform الوصول إلى عناصر النماذج المؤهلة وقراءة المعلومات المخزنة في نقاط التحقق الخاصة بها.

يتوقف مقدار سجل التدريب الذي ينتقل مع النماذج على ملفات النموذج الأصلية والبيانات المخزنة في W&B. إذا لم تتضمن نقطة التحقق مقاييس التدريب لكل حقبة، تحاول Ultralytics Platform استرجاع منحنيات التدريب من سجل تشغيل W&B. نوصي بعمل نسخة احتياطية من ملفات النماذج وبيانات التجارب المهمة قبل البدء.

استيراد نماذج Ultralytics YOLO عبر تكامل W&B#

إذا كان مشروعك في W&B يحتوي بالفعل على نقطة تحقق best.pt لنموذج Ultralytics YOLO، فيمكنك استخدام تكامل W&B المضمّن في Ultralytics Platform. يمكنك إكمال عملية الاستيراد في متصفحك، لذا لن تحتاج إلى تنزيل كل نموذج وإعادة رفعه يدويًا.

الخطوة 1: سجّل الدخول إلى Ultralytics Platform#

افتح Ultralytics Platform وسجّل الدخول، ثم انتقل إلى مساحة العمل التي تريد استيراد نماذجك إليها.

يلزم أن يكون دورك في مساحة العمل محررًا أو أعلى لاستيراد النماذج. تُحتسب النماذج المستوردة ضمن حدود التخزين والنماذج في مساحة العمل. يتوفر استيراد W&B في جميع الخطط.

الخطوة 2: افتح تكامل W&B#

في Ultralytics Platform، انتقل إلى الإعدادات → التكاملات → Weights & Biases. من هنا يمكنك استيراد نماذج Ultralytics YOLO الحالية من W&B.

الخطوة 3: اربط حساب W&B#

استخرج مفتاح API من صفحة تفويض W&B. عُد إلى Ultralytics Platform، والصق المفتاح، ثم انقر اتصال.

بعد الاتصال، تعرض Ultralytics Platform مشاريع W&B التي يمكن لمفتاحك الوصول إليها، بما في ذلك مشاريعك ومشاريع فرقك، إلى جانب النماذج المتاحة للاستيراد. تأكد من أن مفتاح API يملك صلاحية قراءة المشاريع التي تريد ترحيلها.

ملاحظة أمنية: مفاتيح API بيانات اعتماد حساسة. لا تودعها في مستودعات الشيفرة العامة ولا تشاركها مع الآخرين.

عندما يتصل مالك مساحة العمل باستخدام مفتاح API لـ W&B، تخزّنه Ultralytics Platform مشفرًا وتعيد استخدامه في عمليات الاستيراد المستقبلية ضمن مساحة العمل، لذا لن تحتاج إلى إدخاله مجددًا. وحده المالك يستطيع إضافة المفتاح المحفوظ أو استبداله أو إزالته. أما المفتاح الذي يُدخله أي عضو آخر في مساحة العمل، فيُستخدم لعملية الاستيراد تلك فقط.

الخطوة 4: اختر المشاريع المراد استيرادها#

بعد الاتصال، تعرض القائمة مشاريع W&B التي يمكن لمفتاح API الوصول إليها وتحتوي على عناصر نماذج. انتظر حتى تُحمّل تفاصيل النماذج، ثم اختر المشاريع التي تريد ترحيلها.

تستورد Ultralytics Platform النماذج حسب المشروع؛ إذ تحاول استيراد كل نموذج مؤهل في كل مشروع تختاره. ويكون النموذج مؤهلًا عندما:

1. يحتوي تشغيل W&B الخاص به على عنصر نموذج يتضمن نقطة تحقق best.pt.
2. يكون نوع مهمته مدعومًا في Ultralytics Platform.
3. لا يتجاوز حجم نقطة التحقق حد رفع النماذج البالغ 1 GB.

لا يمكن اختيار المشاريع التي لا تحتوي على أي نماذج مؤهلة.

الخطوة 5: ابدأ الاستيراد#

بعد اختيار المشاريع، انقر استيراد N، حيث يمثّل N عدد المشاريع التي اخترتها. تبدأ Ultralytics Platform استيراد النماذج المؤهلة، وتعرض تقدمها في متعقّب الرفع في الخلفية.

أبقِ علامة تبويب المتصفح مفتوحة حتى يكتمل الرفع. يمكنك مواصلة التنقل داخل Ultralytics Platform أثناء تنفيذ عمليات الرفع.

الخطوة 6: راجع النماذج المستوردة#

عند اكتمال الاستيراد، افتح المشروع المقابل واختر نموذجًا للاطلاع على تفاصيله. يُستورد كل مشروع W&B إلى مشروع في Ultralytics Platform بالاسم نفسه، ويُنشأ المشروع إذا لم يكن موجودًا بالفعل.

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

أصبحت نماذج Ultralytics YOLO الحالية جاهزة الآن للإدارة والاختبار والاستخدام في Ultralytics Platform.

بديل: ارفع أوزان النماذج الحالية يدويًا#

إذا كان نموذجك محفوظًا محليًا، فيمكنك رفعه مباشرةً إلى Ultralytics Platform.

بعد تدريب نموذج Ultralytics YOLO على اكتشاف الأجسام، يبدو دليل المخرجات عادةً كما يلي:

runs/
└── detect/
    └── train/
        └── weights/
            ├── best.pt
            └── last.pt

يحتوي الملف best.pt على أفضل نقطة تحقق أداءً من التدريب، وهو الملف الأكثر استخدامًا للاستدلال والنشر.

في Ultralytics Platform، افتح المشروع المستهدف. اسحب الملف .pt وأفلته في صفحة المشروع أو الشريط الجانبي للنماذج، أو انقر رفع النماذج واختر ملفًا محليًا. عند اكتمال الرفع، تقرأ Ultralytics Platform تلقائيًا البيانات الوصفية المدعومة للنموذج، مثل المهمة والبنية وأسماء الفئات.

للتحقق من تحميل النموذج بصورة صحيحة قبل رفعه، يمكنك إجراء تنبؤ سريع باستخدام حزمة Ultralytics Python:

from ultralytics import YOLO

# ⁨حمّل النموذج المحلي⁩
model = YOLO("best.pt")

# ⁨تشغيل الاستدلال⁩
results = model.predict(
    source="test.jpg",
    conf=0.25,
)

print(results)

استبدل المسارات الواردة في المثال بمسارات أوزان النموذج وصورة الاختبار.

لاحظ أن الرفع اليدوي لا يمكنه استعادة سجل التدريب الذي لم يُحفظ في نقطة التحقق الأصلية.

بعد تجهيز نماذجك الحالية، يمكنك أيضًا إرسال عمليات تدريب Ultralytics YOLO المستقبلية مباشرةً إلى Ultralytics Platform.

تتبّع عمليات التدريب الجديدة في Ultralytics Platform#

يستخدم المثال التالي Ultralytics YOLO26 لتوضيح كيفية تدريب نموذج على جهازك مع بث مقاييس التدريب إلى Ultralytics Platform.

الخطوة 1: ثبّت Ultralytics أو حدّثه#

pip install -U ultralytics

يتطلب بث مقاييس التدريب المحلي إلى Ultralytics Platform ما يلي:

• Python 3.11 أو إصدار أحدث
• ultralytics الإصدار 8.4.120 أو إصدار أحدث

إذا كنت قد تتبعت التجارب باستخدام W&B وتريد أن تُرسل عمليات التشغيل المستقبلية التقارير إلى Ultralytics Platform فقط، فيمكنك إيقاف تسجيل W&B:

yolo settings wandb=False

لن يؤدي ذلك إلى حذف أي بيانات تجارب مخزنة مسبقًا في W&B.

الخطوة 2: أعدّ مفتاح API الخاص بـ Ultralytics Platform#

في Ultralytics Platform، انتقل إلى الإعدادات → مفاتيح API. يمكن لمالك مساحة العمل إنشاء مفتاح للتدريب: انقر إضافة مفتاح، واختر Ultralytics، وأدخل اسمًا، ثم انقر إنشاء مفتاح.

في Linux أو macOS، عيّنه كمتغير بيئة:

export ULTRALYTICS_API_KEY="YOUR_API_KEY"

استبدل YOUR_API_KEY بمفتاحك، ولا تضعه في مستودعات الشيفرة العامة.

الخطوة 3: درّب YOLO26#

يدرّب هذا المثال YOLO26n على مجموعة البيانات النموذجية COCO8:

yolo train \
  model=yolo26n.pt \
  data=coco8.yaml \
  epochs=5 \
  project=your-username/my-project \
  name=experiment-1

إليك وظيفة كل وسيطة:

• model: النموذج المراد تدريبه.
• data: إعدادات مجموعة البيانات.
• epochs: عدد حقب التدريب.
• project: المشروع المستهدف في Ultralytics Platform، بالتنسيق username/project.
• name: اسم هذه التجربة.

استبدل your-username/my-project باسم مستخدم مساحة العمل واسم المشروع.

يمكنك تنفيذ الأمر نفسه باستخدام واجهة Python البرمجية:

from ultralytics import YOLO

model = YOLO("yolo26n.pt")

model.train(
    data="coco8.yaml",
    epochs=5,
    project="your-username/my-project",
    name="experiment-1",
)

بمجرد بدء التدريب، تُبث المقاييس المدعومة إلى Ultralytics Platform في الوقت الفعلي.

لإعداد أبسط، افتح علامة التبويب التدريب المحلي في مربع حوار التدريب ضمن Ultralytics Platform، وانسخ الأمر المُنشأ، الذي يتضمن مفتاح API الخاص بك بالفعل.

الخطوة 4: اطّلع على نتائج التدريب#

افتح علامة التبويب التدريب الخاصة بالنموذج للاطلاع على ما سُجّل أثناء التدريب، بما في ذلك:

• خسارة التدريب والتحقق
• مقاييس النموذج مثل الدقة والاستدعاء وmAP
• معدل التعلّم بمرور الوقت
• مخططات التحقق، عند توفرها
• سجلات وحدة التحكم
• موارد النظام، بما فيها استخدام GPU وCPU والذاكرة

استخدم هذه السجلات لتحليل التدريب ومقارنة الأداء عبر الإعدادات وأحجام النماذج.

ما يمكنك فعله بعد الترحيل#

بعد نقل نماذجك إلى منصة Ultralytics، يمكنك اختبارها وتصديرها ومقارنتها ونشرها.

اختبار النماذج في المتصفح#

افتح علامة التبويب Predict في صفحة أحد النماذج، وحمّل صورة، وشاهد تنبؤات النموذج فورًا.

تصدير النماذج بتنسيقات مختلفة#

يمكن لمنصة Ultralytics تصدير النماذج إلى مجموعة من تنسيقات النشر، بما فيها ONNX وTensorRT وCoreML. اختر التنسيق بناءً على مهمة النموذج والعتاد الذي ستنشره عليه.

مقارنة التجارب ضمن مشروع#

يمكنك مقارنة التجارب مباشرةً في صفحة المشروع. إليك كيفية مطابقة مفاهيم W&B مع منصة Ultralytics:

تُضاف النماذج المستوردة من مشروع W&B نفسه إلى مشروع منصة Ultralytics نفسه، ما يتيح لك مقارنة نتائج التدريب المتاحة لها بعد اكتمال الاستيراد.

مقارنة المخططات#

حدّد النماذج التي تريد مقارنتها من قائمة النماذج على اليسار. تعرض اللوحة على اليمين منحنياتها متراكبةً ومجمّعةً ضمن فئات مثل Metrics وLoss وLearning Rate. وبحسب المهمة والبيانات المتاحة، تشمل هذه الفئات mAP50-95 والدقة والاستدعاء وخسائر التدريب والتحقق المنفردة. مرّر المؤشر فوق منحنى للاطّلاع على القيم الدقيقة، واستخدم وسيلة الإيضاح لإظهار نموذج أو إخفائه، وانقر واسحب للتكبير على منطقة محددة.

مقارنة الجداول#

انتقل إلى عرض Table لمقارنة معلمات التدريب والمقاييس النهائية للنماذج المحددة جنبًا إلى جنب. فعّل Diff لإظهار الأعمدة التي تختلف قيمها بين النماذج فقط، ما يسهّل تحديد المعلمات الفائقة التي ربما أثّرت في نتائجك.

واصل تطوير مشاريع الرؤية الحاسوبية#

تغطي منصة Ultralytics أيضًا إدارة مجموعات البيانات والتعليق التوضيحي والتدريب السحابي باستخدام GPU وإدارة النماذج ونشر النماذج، لتتمكن من جمع مزيد من سير عملك في مكان واحد مع نمو مشاريعك.

انقل تجارب W&B إلى منصة Ultralytics#

بفضل تكامل W&B المدمج، يمكنك استيراد نقاط التحقق المؤهلة لنماذج Ultralytics YOLO وسجلات التدريب المتاحة الخاصة بها إلى منصة Ultralytics دون إعادة التدريب. ويمكن تحميل نقاط التحقق المحفوظة محليًا يدويًا.

ومن هناك، يمكنك تتبّع عمليات تشغيل التدريب الجديدة ومقارنة أداء النماذج وتشغيل الاستدلال وتصدير النماذج ونشرها، كل ذلك في مكان واحد.

جرّب منصة Ultralytics

وثائق ذات صلة#

• دليل تكامل W&B مع منصة Ultralytics
• دليل البدء السريع لمنصة Ultralytics
• دليل التدريب على منصة Ultralytics
• دليل تكامل Ultralytics YOLO مع W&B