Skip to content
Tutorials3 min read

رسم مربعات الإحاطة لاكتشاف الأجسام

دليل شامل لإعداد توسيم مربعات الإحاطة لمهام الرؤية الحاسوبية، بما في ذلك ألوان التسميات والتحقق من الصحة.

Potato Team·

رسم مربعات الإحاطة لاكتشاف الأجسام

توسيم مربعات الإحاطة ضروري لتدريب نماذج اكتشاف الأجسام. يغطي هذا الدليل التعليمي كل شيء من الإعداد الأساسي إلى الميزات المتقدمة مثل التوسيم المسبق وقواعد التحقق.

إعداد مربعات الإحاطة الأساسي

التكوين الأدنى

yaml
annotation_task_name: "Object Detection Annotation"
 
data_files:
  - "data/images.json"
 
annotation_schemes:
  - annotation_type: image_annotation
    name: objects
    description: "Draw boxes around all objects"
    tools:
      - bbox
    labels:
      - name: car
        color: "#FF6B6B"
      - name: person
        color: "#4ECDC4"
      - name: bicycle
        color: "#45B7D1"

كيف يعمل

  1. اختر تسمية من شريط الأدوات
  2. انقر واسحب لرسم مربع
  3. اضبط الزوايا لتحسين المربع
  4. أضف المزيد من المربعات حسب الحاجة
  5. أرسل عند الانتهاء

تكوين التسميات المفصل

yaml
annotation_schemes:
  - annotation_type: image_annotation
    name: objects
    description: "Annotate all visible objects"
    tools:
      - bbox
    labels:
      - name: person
        color: "#FF6B6B"
        description: "Any human, partial or full"
        keyboard_shortcut: "p"
 
      - name: car
        color: "#4ECDC4"
        description: "Cars, trucks, SUVs"
        keyboard_shortcut: "c"
 
      - name: motorcycle
        color: "#45B7D1"
        description: "Motorcycles and scooters"
        keyboard_shortcut: "m"
 
      - name: bicycle
        color: "#96CEB4"
        description: "Bicycles of all types"
        keyboard_shortcut: "b"
 
      - name: traffic_light
        color: "#FFEAA7"
        description: "Traffic signals"
        keyboard_shortcut: "t"
 
      - name: stop_sign
        color: "#DDA0DD"
        description: "Stop signs"
        keyboard_shortcut: "s"

إضافة خصائص الأجسام

التقاط معلومات إضافية عن كل مربع:

yaml
annotation_schemes:
  - annotation_type: image_annotation
    name: objects
    tools:
      - bbox
    labels:
      - name: person
        color: "#FF6B6B"
        attributes:
          - name: occlusion
            type: radio
            options: [none, partial, heavy]
          - name: truncated
            type: checkbox
            description: "Object extends beyond image"
          - name: difficult
            type: checkbox
            description: "Hard to identify"

عندما يرسم المُوسِّمون مربعاً، سيُطلب منهم ملء هذه الخصائص.

قواعد التحقق

ضمان جودة التوسيم من خلال التحقق:

yaml
annotation_schemes:
  - annotation_type: image_annotation
    name: objects
    tools:
      - bbox
    labels: [...]
    min_annotations: 1

اختصارات لوحة المفاتيح

يتضمن Potato اختصارات لوحة مفاتيح مدمجة للتوسيم الفعال:

  • مفاتيح الأرقام لاختيار التسميات
  • مفتاح الحذف لإزالة التوسيمات المحددة
  • مفاتيح الأسهم للتنقل بين العناصر

خيارات العرض

تكوين إعدادات عرض الصور:

yaml
image_display:
  width: 800
  height: 600

تكوين الإنتاج الكامل

yaml
annotation_task_name: "Autonomous Driving - Object Detection"
 
data_files:
  - "data/driving_frames.json"
 
annotation_schemes:
  - annotation_type: image_annotation
    name: objects
    description: "Annotate all traffic participants and objects"
    tools:
      - bbox
    min_annotations: 1
    labels:
      - name: vehicle
        color: "#FF6B6B"
        keyboard_shortcut: "v"
        attributes:
          - name: type
            type: radio
            options: [car, truck, bus, motorcycle, bicycle]
          - name: occlusion
            type: radio
            options: [0%, 1-25%, 26-50%, 51-75%, 76-99%]
 
      - name: pedestrian
        color: "#4ECDC4"
        keyboard_shortcut: "p"
        attributes:
          - name: pose
            type: radio
            options: [standing, walking, sitting, lying]
          - name: age_group
            type: radio
            options: [child, adult, elderly]
 
      - name: cyclist
        color: "#45B7D1"
        keyboard_shortcut: "c"
 
      - name: traffic_sign
        color: "#FFEAA7"
        keyboard_shortcut: "t"
        attributes:
          - name: sign_type
            type: radio
            options: [stop, yield, speed_limit, warning, other]
 
      - name: traffic_light
        color: "#DDA0DD"
        keyboard_shortcut: "l"
        attributes:
          - name: state
            type: radio
            options: [red, yellow, green, off, unknown]

صيغة الإخراج

json
{
  "frame_id": "frame_0001",
  "frame_path": "/images/frame_0001.jpg",
  "image_dimensions": {"width": 1920, "height": 1080},
  "annotations": {
    "objects": [
      {
        "label": "vehicle",
        "bbox": [450, 380, 680, 520],
        "attributes": {
          "type": "car",
          "occlusion": "0%"
        }
      },
      {
        "label": "pedestrian",
        "bbox": [820, 400, 870, 550],
        "attributes": {
          "pose": "walking",
          "age_group": "adult"
        }
      }
    ]
  }
}

نصائح لمربعات إحاطة عالية الجودة

  1. مربعات محكمة: قلل الخلفية في المربعات
  2. قواعد متسقة: وثّق الحالات الحدية بوضوح
  3. جلسات معايرة: راجع الأمثلة معاً
  4. تتبع المقاييس: راقب توزيعات عدد وحجم المربعات

الخطوات التالية


الوثائق الكاملة في /docs/features/image-annotation.