Ultralytics YOLO27:
Get Started
Coming Soon

تكامل Label Studio#

سيصبح الاستيراد المباشر من Label Studio متاحًا قريبًا في Ultralytics Platform، بحيث يمكن رفع تصدير خام لكشف الصور أو تقسيمها كما هو، من دون الحاجة إلى اختيار تنسيق.

إلى أن يتاح ذلك، توجد طريقة مختصرة تعمل الآن، لأن تنسيق YOLO with Images في Label Studio يستخدم بنية تقرؤها Platform، وتتضمن قائمة الفئات.

الاستيراد من Label Studio الآن#

  1. التصدير من Label Studio. افتح مشروعك وانقر Export.
  2. اختر تنسيقًا يتضمن الصور. اختر YOLO with Images، أو YOLOv8 OBB with Images للصناديق الدوارة، ثم انقر Export.
  3. ارفع الملفات إلى Platform. أنشئ مجموعة بيانات جديدة من ملف ZIP.
  4. التدريب. حرّر التعليقات التوضيحية، ودرّب، وانشر من دون مغادرة مساحة العمل.

استيراد مجموعة بيانات Label Studio إلى Ultralytics Platform

تصديرا YOLO وCOCO العاديان لا يتضمنان سوى التعليقات التوضيحية

ينشئ خيارا Label Studio، YOLO وCOCO، ملفات التسميات من دون الصور، لأن الصور عادةً ما تكون موجودة خلف عناوين 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 بالطريقة نفسها. تُستبدل رموز الوصول الشخصية الأحدث برمز حامل قصير الأجل قبل استخدامها، لذا تحقّق من نوع الرمز الذي يصدره مثيلك. ينبغي للمشاريع الكبيرة استخدام نقاط نهاية اللقطات بدلًا من ذلك؛ إذ تنشئ التصدير مهمةً تعمل في الخلفية وتتيح تنزيله باستخدام المعرّف. ويُنفّذ مثال 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/

تقرأ Platform أعمق مجلد classes.txt (أو notes.json) في الأرشيف، لذا تبقى أسماء التسميات محفوظة أيضًا إذا فككت ضغط التصدير ثم أعدت ضغطه داخل مجلد.

اختيار تنسيق التصدير#

يوفر Label Studio تنسيقات تصدير متعددة. لكشف الصور وتقسيمها:

تنسيق Label Studioالتوافقملاحظات
YOLO with Imagesالأفضليتضمن classes.txt والصور، لذا يكفي رفع واحد
YOLOv8 OBB with Imagesنعميحافظ على دوران الصناديق ويُستورد كمجموعة بيانات OBB
COCO with Imagesنعميُقرأ أيضًا؛ وهو الخيار الأفضل إذا كان كل تعليق توضيحي مضلعًا بأربع نقاط
YOLO / COCOلاملفات التعليقات التوضيحية فقط — يفشل الرفع لعدم العثور على صور
Pascal VOC XMLلالا يمكن قراءة ملفات التسميات XML

لكي تُقرأ التعليقات التوضيحية في تصدير COCO، يجب أن يتضمن كل تعليق bbox، ويتم تخطي مناطق الحشود ("iscrowd": 1)، وتصبح أسماء الفئات أسماء فئاتك — لذا لا يحتاج أرشيف COCO إلى classes.txt للاحتفاظ بتسمياته.

يُستورد Pascal VOC من دون تعليقات توضيحية

لا تقرأ Platform تسميات Pascal VOC XML، وقد يفشل تصدير VOC بصمت لا بصخب: تُستورد الصور دون الصناديق، كما يضيف تصدير لخمس صور أو أكثر فئة واحدة باسم images. اختر YOLO with Images أو COCO with Images بدلًا من ذلك.

ما الذي ينتقل إلى Platform#

تحدد Platform مهمة YOLO استنادًا إلى التسميات في التصدير:

تسميات Label Studioمجموعة بيانات Platform
RectangleLabelsكشف، أو OBB عند التصدير بتنسيق YOLOv8 OBB
PolygonLabelsتقسيم، أو OBB عند التصدير بتنسيق YOLO إذا كان كل مضلع مؤلفًا من أربع نقاط
RectangleLabels + PolygonLabelsتقسيم — تظل الصناديق قابلة للتحرير، لكن لا تُستخدم في التدريب سوى المضلعات
KeyPointLabels داخل مستطيلالوضعية
Choicesلا تصدره تنسيقات YOLO أو COCO في Label Studio، لذا تُستورد الصور بلا تسميات
  • الصناديق الدوارة — يُسقط تصديرا YOLO وCOCO الدوران؛ استخدم YOLOv8 OBB with Images للاحتفاظ به.
  • النقاط المفتاحية — لا يتضمن تصدير YOLO من Label Studio نقطة مفتاحية إلا إذا كان لـ <Label> في KeyPointLabels سمة model_index ورُسمت النقطة داخل مستطيل؛ وإلا فيتضمن التصدير الصناديق وحدها، وتُستورد مجموعة البيانات بوصفها مهمة كشف.
  • المضلعات ذات النقاط الأربع — تبدو في ملفات YOLO مطابقةً للصندوق الموجّه، لذا يُستورد تصدير YOLO الذي تتكون فيه كل تسمية من مضلع ذي أربع نقاط على أنه OBB. استخدم COCO with Images لهذه المشاريع.

ما الذي سيضيفه التكامل#

اختيار تنسيق التصدير المناسب هو الخطوة التي يلغيها التكامل. عند إطلاقه، ستتمكن من تصدير أي تنسيق من تنسيقات كشف الصور وتقسيمها في Label Studio ورفعه، وستحوّل Platform التعليقات التوضيحية تلقائيًا إلى مهمة YOLO المطابقة.

  • لا حاجة إلى اختيار تنسيق — تتحول صادرات كشف الصور وتقسيمها من Label Studio إلى مجموعة بيانات YOLO مع الحفاظ على أسماء التسميات
  • مساحة عمل واحدة — لن تعود إضافة التعليقات التوضيحية والتدريب والنشر موزعةً على أدوات منفصلة ونص برمجي للتحويل
  • واصل إضافة التعليقات التوضيحية — تُفتح مجموعات البيانات المستوردة في محرر التعليقات التوضيحية في Platform، بما في ذلك التعليق التوضيحي الذكي المدعوم بـ SAM
  • ابدأ التدريب فورًا — تصبح مجموعات البيانات جاهزة لـالتدريب السحابي بمجرد اكتمال معالجتها
متاح الآن

يتاح استخدام تكاملي Labelbox وRoboflow اليوم، وتستورد Platform مباشرةً مجموعات بيانات YOLO وCOCO وJSON من LabelMe، ومجموعات بيانات NDJSON من Ultralytics أو Labelbox.

الأسئلة الشائعة#

  • اختر YOLO with Images ليتضمن الأرشيف classes.txt والصور. ويمكن أيضًا استيراد COCO with Images. أما خياري YOLO وCOCO العاديان فينشئان ملفات التسميات فقط، ولا يمكن قراءة Pascal VOC XML.

  • استُخدم تصدير YOLO أو COCO العادي. لا تتضمن هذه الأرشيفات الصور، لأن Label Studio يوفّرها عادةً من عناوين URL. أعد التصدير باستخدام الصيغة التي تتضمن with Images.

  • لا يحتوي الأرشيف على classes.txt أو notes.json، ويحدث ذلك عادةً لأنه أُعيد إنشاؤه من مجلدي images/ وlabels/ وحدهما. ارفع ملف ZIP الذي صدّره Label Studio، إذ يتضمن الملفين.

  • نعم. استدعِ نقطة نهاية التصدير باستخدام exportType=YOLO_WITH_IMAGES، أو COCO_WITH_IMAGES وYOLO_OBB_WITH_IMAGES. ينبغي للمشاريع الكبيرة استخدام نقاط نهاية اللقطات، التي تنشئ التصدير كمهمة تعمل في الخلفية.

المساهمون
GLglenn-jocher4RAraimbekovm3SEsergiuwaxmann1

التعليقات