تكامل Label Studio#
عمليات الاستيراد المباشرة لـ Label Studio قادمة إلى Ultralytics Platform، بحيث يتم رفع تصدير اكتشاف أو تجزئة الصور الخام كما هو دون الحاجة لاختيار تنسيق.
حتى ذلك الحين، يوجد مسار قصير يعمل اليوم، لأن تصدير YOLO with Images من Label Studio يمثل تخطيطاً تقرؤه المنصة، متضمناً قائمة الفئات.
الاستيراد من Label Studio اليوم#
- التصدير من Label Studio. افتح مشروعك وانقر فوق Export.
- اختر تنسيقاً يتضمن الصور. اختر YOLO with Images وانقر على Export.
- التحميل إلى Platform. أنشئ مجموعة بيانات جديدة من ملف ZIP.
- التدريب. قم بتعديل التعليقات التوضيحية، وتدريب النموذج، والنشر دون مغادرة مساحة العمل.
تكتب خيارات YOLO و COCO في Label Studio ملفات التسميات بدون الصور، نظراً لأن صورك عادة ما تكون موجودة خلف عناوين URL التي تمت الإشارة إليها في Label Studio. يؤدي رفع أحد تلك الأرشيفات إلى Platform إلى منحك مجموعة بيانات بدون صور. اختر بدلاً من ذلك المتغير الذي يتضمن الصور (with Images).
التصدير باستخدام API#
تُرجِع واجهة برمجة تطبيقات التصدير الخاصة بـ Label Studio نفس الأرشيف، مع اسم التنسيق في exportType:
curl -X GET "https://<your-label-studio>/api/projects/<project-id>/export?exportType=YOLO_WITH_IMAGES&download_all_tasks=true" \
-H "Authorization: Token <your-legacy-token>" \
-o dataset.zipتعمل COCO_WITH_IMAGES و YOLO_OBB_WITH_IMAGES بنفس الطريقة. يتم استبدال الرموز المميزة للوصول الشخصي الأحدث برمز حامل (bearer token) قصير الأجل قبل الاستخدام، لذا تحقق من نوع الرمز المميز الذي تصدره نسختك. يجب أن تستخدم المشاريع الكبيرة نقاط نهاية اللقطات بدلاً من ذلك، والتي تنشئ التصدير كعملية في الخلفية وتقوم بتنزيله بواسطة المعرف؛ مثال export_yolo_with_images.py في SDK يقرر ذلك بالضبط.
يحمل تصدير YOLO من Label Studio قائمة فئاته بجانب التعليقات التوضيحية، وتقرؤها المنصة:
archive.zip/
├── classes.txt # class names Platform reads first
├── notes.json # fallback, used only when classes.txt is missing or empty
├── images/
└── labels/قم برفع الأرشيف تماماً كما أنشأه Label Studio. يبحث Platform عن classes.txt و notes.json في الجذر الرئيسي للأرشيف، لذا فإن إعادة ضغط التصدير داخل مجلد آخر يؤدي إلى فقدان أسماء التسميات الخاصة بك ويتم استيراد الفئات كـ class0 و class1 وما إلى ذلك.
اختيار تنسيق التصدير#
يقدم Label Studio العديد من تنسيقات التصدير. لاكتشاف الصور وتجزئتها:
| تنسيق Label Studio | يعمل | ملاحظات |
|---|---|---|
| YOLO with Images | الأفضل | يرسل classes.txt والصور، لذا يكفي رفع ملف واحد |
| COCO with Images | نعم | يتم قراءته أيضاً؛ مزيج من المضلعات والصناديق يتم استيراده كتجزئة، مع إسقاط الصناديق فقط |
| YOLO / COCO | لا | ملفات التسميات التوضيحية فقط - يتم استيراد مجموعة البيانات بدون صور |
| Pascal VOC XML | لا | لا يمكن قراءة ملفات التسميات XML |
في تصدير COCO، يجب أن تحمل كل تعليقات توضيحية bbox ليتم قراءتها، ويتم تخطي مناطق الحشود ("iscrowd": 1)، وتصبح أسماء الفئات هي أسماء الفئات الخاصة بك — لذا فإن أرشيف COCO لا يحتاج إلى classes.txt للاحتفاظ بتسمياته.
لا تقرأ المنصة تسميات Pascal VOC XML، ويفشل تصدير VOC بصمت بدلاً من بضجيج: يتم استيراد الصور ولا يتم استيراد التعليقات التوضيحية. اختر YOLO with Images أو COCO with Images بدلاً من ذلك.
ما سيضيفه التكامل#
يعد اختيار تنسيق التصدير الصحيح هو الخطوة التي يزيلها التكامل. بمجرد إصداره، ستقوم بتصدير أي من تنسيقات اكتشاف وتجزئة الصور الخاصة بـ Label Studio، ورفعه، وسيقوم Platform بربط التعليقات التوضيحية بمهمة YOLO المطابقة بنفسه.
- لا توجد حاجة لاختيار تنسيق — عمليات تصدير اكتشاف وتجزئة الصور في Label Studio ترتبط بمجموعة بيانات YOLO مع الاحتفاظ بأسماء التسميات
- مساحة عمل واحدة — التسمية، والتدريب، والنشر تتوقف عن امتدادها عبر أدوات منفصلة وبرنامج نصي للتحويل
- استمر في التعليق التوضيحي — تفتح مجموعات البيانات المستوردة في محرر التعليقات التوضيحية في Platform، بما في ذلك التعليق التوضيحي الذكي المدعوم بـ SAM
- التدريب الفوري — تصبح مجموعات البيانات جاهزة لـ التدريب السحابي بمجرد إنهاء معالجتها