تكامل Labelbox#

يقرأ Ultralytics Platform ملفات تصدير Labelbox بتنسيق NDJSON مباشرةً. فلا حاجة إلى لصق مفتاح أو إبقاء اتصال نشط أو صيانة برنامج نصي للتحويل — صدّر من Labelbox، وارفع الملف، وستصل تسمياتك كمجموعة بيانات عادية في Platform.

الاستيراد من Labelbox#

1. التصدير من Labelbox. في مشروع وضع التسميات، افتح علامة التبويب Data Rows، وحدد All، وانقر على Export data، واختر الحقول المراد تضمينها، ثم أكّد. ومن Catalog، حدد صفوف البيانات واختر Manage selection > Export data، ثم فعّل Export labels from project واختر المشروع، وإلا فسيصل الملف بلا أي تعليقات توضيحية.
2. نزّل الملف. ينفّذ Labelbox عملية التصدير كوظيفة تعمل في الخلفية. راقبها في Notifications، وانقر على Download عند اكتمالها لحفظ ملف .ndjson.
3. ارفع الملف إلى Platform. أنشئ مجموعة بيانات جديدة وارفع ملف .ndjson، أو ألصق رابطًا مباشرًا إليه. يمكنك أيضًا البدء من Settings > Integrations > Labelbox.
4. درّب النموذج. بعد اكتمال المعالجة، حرّر التعليقات التوضيحية ثم درّب النموذج تمامًا كما تفعل مع أي مجموعة بيانات أخرى في Platform.

على عكس CVAT وLabel Studio، لا يوجد تنسيق عليك اختياره — فتصدير Labelbox نفسه هو التنسيق المدعوم.

التصدير باستخدام SDK#

يوفر Labelbox أيضًا مهمة التصدير ضمن SDK الخاص بـ Python، وهي الطريقة الأسهل لإنشاء مسار عمل قابل للتكرار. بثّ المهمة واكتب كائن JSON واحدًا في كل سطر:

import json

import labelbox

client = labelbox.Client(api_key="YOUR_LABELBOX_API_KEY")
export_task = labelbox.ExportTask.get_task(client, "YOUR_EXPORT_TASK_ID")
export_task.wait_till_done()  # ⁨يؤدي بث مهمة ليست COMPLETE إلى رفع استثناء⁩

with open("dataset.ndjson", "w") as f:
    f.writelines(json.dumps(data_row.json) + "\n" for data_row in export_task.get_buffered_stream())

ما الذي يتم استيراده#

يتعرّف Platform تلقائيًا على تنسيق Labelbox ويحوّل مربعات الإحاطة والمضلعات إلى نوع مهمة YOLO المقابل:

تصبح قيمة name لكل كائن اسم الفئة — لذا يُستورد تعليق توضيحي من نوع "name": "Dog" باسم الفئة Dog، لا بصيغته الصغيرة value — وتُطبّع إحداثيات البكسل نسبةً إلى أبعاد media_attributes الواردة في التصدير، لذا احتفظ بسمات الوسائط في التصدير: فالصفوف التي لا تتضمن العرض والارتفاع تستورد صورها بلا تعليقات توضيحية. ولا تُسجّل فئة إلا للكائنات التي يستطيع Platform استيرادها، لذلك لا تضيف أدوات الأقنعة والنقاط والخطوط المتعددة فئات فارغة إلى مجموعة البيانات. تُسمّى كل صورة باسم data_row.external_id، ثم باسم global_key عند غيابه، ثم باسم الملف الوارد في عنوان URL الموقّع إذا لم يتضمن التصدير أيًا منهما. تُستورد صفوف بيانات الصور، بينما تُتخطى صفوف بيانات الفيديو والنص وسائر أنواع البيانات غير الصورية. ويُستورد تصدير الكتالوج الذي لا يحتوي على تعليقات توضيحية كمجموعة بيانات صور غير موسومة، جاهزة لوضع التسميات في محرر التعليقات التوضيحية في Platform.

يبدو صف بيانات واحد كما يلي، بعد اختصاره إلى الحقول التي يقرأها Platform:

{
    "data_row": {
        "external_id": "000000000307.jpg",
        "global_key": "000000000307.jpg",
        "row_data": "https://storage.labelbox.com/...?Expires=...&Signature=..."
    },
    "media_attributes": { "height": 480, "width": 640, "mime_type": "image/jpeg" },
    "projects": {
        "<project-id>": {
            "labels": [
                {
                    "annotations": {
                        "objects": [
                            {
                                "name": "Dog",
                                "annotation_kind": "ImageBoundingBox",
                                "bounding_box": { "top": 200.0, "left": 407.0, "height": 172.0, "width": 176.0 }
                            }
                        ]
                    }
                }
            ]
        }
    }
}

يتم تجاهل كل ما عدا ذلك في التصدير — embeddings وmetadata_fields وattachments وproject_details. ويُستحسن إلغاء تحديد التضمينات عند التصدير: فقد شكّلت نحو أربعة أخماس حجم ملف تصدير تجريبي، مقابل خُمس للحقول التي يقرأها Platform فعليًا.

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