تكامل Label Studio#
ستتوفر عمليات الاستيراد المباشر من Label Studio إلى Ultralytics Platform قريبًا، بحيث يُرفع تصدير اكتشاف الصور الخام أو تجزئتها كما هو، من دون الحاجة إلى اختيار تنسيق.
وإلى أن يحدث ذلك، توجد طريقة مختصرة تعمل اليوم، لأن تصدير Label Studio بصيغة YOLO مع الصور هو تخطيط يقرأه Platform، ويتضمن قائمة الفئات.
الاستيراد من Label Studio اليوم#
- التصدير من Label Studio. افتح مشروعك وانقر على تصدير.
- اختر تنسيقًا يتضمن الصور. اختر YOLO مع الصور وانقر على تصدير.
- الرفع إلى المنصة. أنشئ مجموعة بيانات جديدة من ملف ZIP.
- التدريب. حرّر التعليقات التوضيحية، ودرّب، وانشر من دون مغادرة مساحة العمل.
تكتب خيارتا Label Studio، YOLO وCOCO، ملفات التسميات من دون الصور، لأن صورك تكون عادةً موجودة خلف عناوين URL التي وُجّه إليها Label Studio. يؤدي رفع أحد هذين الأرشيفين إلى Platform إلى إنشاء مجموعة بيانات بلا صور. اختر الخيار مع الصور بدلًا من ذلك.
التصدير باستخدام API#
تعيد واجهة تصدير API الأرشيف نفسه، مع وجود اسم التنسيق في 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 بالطريقة نفسها. تُستبدل رموز الوصول الشخصية الأحدث برمز حامل قصير الأجل قبل استخدامها، لذا تحقّق من نوع الرمز الذي يصدره مثيلك. ينبغي للمشاريع الكبيرة استخدام نقاط نهاية اللقطات بدلًا من ذلك، إذ تنشئ التصدير كوظيفة في الخلفية وتتيح تنزيله باستخدام المعرّف؛ ويطبّق مثال export_yolo_with_images.py في SDK ذلك تمامًا.
يتضمن تصدير YOLO من Label Studio قائمة فئاته إلى جانب التسميات، ويقرأها Platform:
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 مع الصور | الأفضل | يتضمن classes.txt والصور، لذا يكفي رفع واحد |
| COCO مع الصور | نعم | يُقرأ أيضًا؛ ويُستورد المزيج من المضلعات والمربعات كبيانات تجزئة، مع إسقاط العناصر التي تحتوي على مربعات فقط |
| YOLO / COCO | لا | ملفات التعليقات التوضيحية فقط — تُستورد مجموعة البيانات بلا صور |
| Pascal VOC XML | لا | لا يمكن قراءة ملفات تسميات XML |
في تصدير COCO، يجب أن تحمل كل تعليقات توضيحية bbox لكي تُقرأ، بينما تُتخطى مناطق الحشود ("iscrowd": 1)، وتصبح أسماء الفئات أسماء فئاتك — لذلك لا يحتاج أرشيف COCO إلى classes.txt للاحتفاظ بتسمياته.
لا يقرأ Platform تسميات Pascal VOC XML، ويفشل تصدير VOC بصمت بدلًا من إظهار فشل واضح: تُستورد الصور ولا تُستورد التعليقات التوضيحية. اختر YOLO مع الصور أو COCO مع الصور بدلًا من ذلك.
ما سيضيفه التكامل#
إن اختيار تنسيق التصدير المناسب هو الخطوة التي يلغيها التكامل. وعند إطلاقه، ستتمكن من تصدير أي من تنسيقات اكتشاف الصور وتجزيئها في Label Studio، ورفعه، وسيُطابق Platform التعليقات التوضيحية مع مهمة YOLO المطابقة تلقائيًا.
- لا حاجة إلى اختيار تنسيق — تُطابق عمليات تصدير اكتشاف الصور وتجزيئها في Label Studio مجموعة بيانات YOLO مع الحفاظ على أسماء التسميات
- مساحة عمل واحدة — لن يعود وضع التسميات والتدريب والنشر موزعًا بين أدوات منفصلة ونص تحويل
- واصل وضع التسميات — تُفتح مجموعات البيانات المستوردة في محرر التعليقات التوضيحية في المنصة، بما في ذلك وضع التسميات الذكي المدعوم بـ SAM
- ابدأ التدريب فورًا — تصبح مجموعات البيانات جاهزة لـ التدريب السحابي بمجرد انتهاء معالجتها