مجموعة بيانات COCO12-Formats

مقدمة

تعد مجموعة بيانات COCO12-Formats من Ultralytics مجموعة اختبار متخصصة مصممة للتحقق من تحميل الصور عبر جميع امتدادات تنسيقات الصور الـ 12 المدعومة. وهي تحتوي على 12 صورة (6 للتدريب، 6 للتحقق)، تم حفظ كل منها بتنسيق مختلف لضمان اختبار شامل لخط تحميل الصور.

تعد مجموعة البيانات هذه لا تقدر بثمن من أجل:

  • اختبار دعم تنسيقات الصور: التحقق من أن جميع التنسيقات المدعومة تُحمل بشكل صحيح
  • خطوط أنابيب CI/CD: الاختبار الآلي لتوافق التنسيقات
  • تصحيح الأخطاء: عزل المشكلات الخاصة بالتنسيق في خطوط أنابيب التدريب
  • التطوير: التحقق من صحة إضافات أو تغييرات التنسيقات الجديدة

التنسيقات المدعومة

تتضمن مجموعة البيانات صورة واحدة لكل من امتدادات التنسيقات الـ 12 المدعومة والمحددة في ultralytics/data/utils.py:

التنسيقالامتدادالوصفالتدريب/التحقق
AVIF.avifتنسيق ملف صورة AV1 (حديث)تدريب
BMP.bmpBitmap - تنسيق نقطي غير مضغوطتدريب
DNG.dngDigital Negative - تنسيق Adobe RAWتدريب
HEIC.heicترميز الصور عالي الكفاءةتدريب
JPEG.jpegJPEG مع امتداد كاملتدريب
JPG.jpgJPEG مع امتداد قصيرتدريب
JP2.jp2JPEG 2000 - طبي/جغرافي مكانيتقييم
MPO.mpoكائن متعدد الصور (صور ستيريو)تقييم
PNG.pngرسومات الشبكة المحمولةتقييم
TIF.tifTIFF مع امتداد قصيرتقييم
TIFF.tiffتنسيق ملف الصور الموسومتقييم
WebP.webpتنسيق صورة ويب حديثتقييم

هيكل مجموعة البيانات

coco12-formats/
├── images/
│   ├── train/          # 6 images (avif, bmp, dng, heic, jpeg, jpg)
│   └── val/            # 6 images (jp2, mpo, png, tif, tiff, webp)
├── labels/
│   ├── train/          # Corresponding YOLO format labels
│   └── val/
└── coco12-formats.yaml # Dataset configuration

ملف YAML الخاص بمجموعة البيانات

تم تكوين مجموعة بيانات COCO12-Formats باستخدام ملف YAML يحدد مسارات مجموعة البيانات وأسماء الفئات. يمكنك مراجعة ملف coco12-formats.yaml الرسمي في مستودع Ultralytics على GitHub.

ultralytics/cfg/datasets/coco12-formats.yaml
# Ultralytics 🚀 AGPL-3.0 License - https://ultralytics.com/license

# COCO12-Formats dataset (12 images testing all supported image formats) by Ultralytics
# Documentation: https://docs.ultralytics.com/datasets/detect/coco12-formats/
# Example usage: yolo train data=coco12-formats.yaml
# parent
# ├── ultralytics
# └── datasets
#     └── coco12-formats ← downloads here (1 MB)

# Train/val/test sets as 1) dir: path/to/imgs, 2) file: path/to/imgs.txt, or 3) list: [path/to/imgs1, path/to/imgs2, ..]
path: coco12-formats # dataset root dir
train: images/train # train images (relative to 'path') 6 images
val: images/val # val images (relative to 'path') 6 images
test: # test images (optional)

# Classes
names:
  0: person
  1: bicycle
  2: car
  3: motorcycle
  4: airplane
  5: bus
  6: train
  7: truck
  8: boat
  9: traffic light
  10: fire hydrant
  11: stop sign
  12: parking meter
  13: bench
  14: bird
  15: cat
  16: dog
  17: horse
  18: sheep
  19: cow
  20: elephant
  21: bear
  22: zebra
  23: giraffe
  24: backpack
  25: umbrella
  26: handbag
  27: tie
  28: suitcase
  29: frisbee
  30: skis
  31: snowboard
  32: sports ball
  33: kite
  34: baseball bat
  35: baseball glove
  36: skateboard
  37: surfboard
  38: tennis racket
  39: bottle
  40: wine glass
  41: cup
  42: fork
  43: knife
  44: spoon
  45: bowl
  46: banana
  47: apple
  48: sandwich
  49: orange
  50: broccoli
  51: carrot
  52: hot dog
  53: pizza
  54: donut
  55: cake
  56: chair
  57: couch
  58: potted plant
  59: bed
  60: dining table
  61: toilet
  62: tv
  63: laptop
  64: mouse
  65: remote
  66: keyboard
  67: cell phone
  68: microwave
  69: oven
  70: toaster
  71: sink
  72: refrigerator
  73: book
  74: clock
  75: vase
  76: scissors
  77: teddy bear
  78: hair drier
  79: toothbrush

# Download script/URL (optional)
download: https://github.com/ultralytics/assets/releases/download/v0.0.0/coco12-formats.zip

المتطلبات

تتطلب بعض التنسيقات تبعيات إضافية:

pip install pillow pillow-heif pillow-avif-plugin

مكتبة نظام AVIF (اختياري)

لكي تتمكن OpenCV من قراءة ملفات AVIF مباشرة، يجب تثبيت libavif قبل بناء OpenCV:

brew install libavif
ملاحظة

قد لا تتضمن حزمة opencv-python المثبتة عبر pip دعم AVIF لأنها مبنية مسبقاً. يستخدم Ultralytics مكتبة Pillow مع pillow-avif-plugin كخيار احتياطي لصور AVIF عندما يفتقر OpenCV إلى الدعم.

الاستخدام

لتدريب نموذج YOLO على مجموعة بيانات COCO12-Formats، استخدم الأمثلة التالية:

مثال على التدريب
from ultralytics import YOLO

# Load a pretrained YOLO model
model = YOLO("yolo26n.pt")

# Train on COCO12-Formats to test all image formats
results = model.train(data="coco12-formats.yaml", epochs=1, imgsz=640)

ملاحظات خاصة بالتنسيق

AVIF (تنسيق ملف صورة AV1)

AVIF هو تنسيق صور حديث يعتمد على برنامج ترميز الفيديو AV1، ويوفر ضغطاً ممتازاً. يتطلب pillow-avif-plugin:

pip install pillow-avif-plugin

DNG (Digital Negative)

DNG هو تنسيق RAW مفتوح من Adobe يعتمد على TIFF. لأغراض الاختبار، تستخدم مجموعة البيانات ملفات تعتمد على TIFF مع الامتداد .dng.

JP2 (JPEG 2000)

JPEG 2000 هو معيار ضغط صور يعتمد على الموجات ويقدم ضغطاً وجودة أفضل من JPEG التقليدي. يُستخدم بشكل شائع في التصوير الطبي (DICOM)، والتطبيقات الجغرافية المكانية، والسينما الرقمية. مدعوم أصلاً بواسطة كل من OpenCV و Pillow.

MPO (كائن متعدد الصور)

تُستخدم ملفات MPO للصور المجسمة (ثلاثية الأبعاد). تخزن مجموعة البيانات بيانات JPEG قياسية مع الامتداد .mpo لاختبار التنسيق.

HEIC (ترميز الصور عالي الكفاءة)

يتطلب HEIC حزمة pillow-heif للترميز الصحيح:

pip install pillow-heif

حالات الاستخدام

اختبار CI/CD

from ultralytics import YOLO

def test_all_image_formats():
    """Test that all image formats load correctly."""
    model = YOLO("yolo26n.pt")
    results = model.train(data="coco12-formats.yaml", epochs=1, imgsz=64)
    assert results is not None

التحقق من صحة التنسيق

from pathlib import Path

from ultralytics.data.utils import IMG_FORMATS

# Verify all formats are represented
dataset_dir = Path("datasets/coco12-formats/images")
found_formats = {f.suffix[1:].lower() for f in dataset_dir.rglob("*.*")}
assert found_formats == IMG_FORMATS, f"Missing formats: {IMG_FORMATS - found_formats}"

الاقتباسات والشكر

إذا كنت تستخدم مجموعة بيانات COCO في بحثك، يرجى الاستشهاد بها:

اقتباس
@misc{lin2015microsoft,
      title={Microsoft COCO: Common Objects in Context},
      author={Tsung-Yi Lin and Michael Maire and Serge Belongie and Lubomir Bourdev and Ross Girshick and James Hays and Pietro Perona and Deva Ramanan and C. Lawrence Zitnick and Piotr Doll{\'a}r},
      year={2015},
      eprint={1405.0312},
      archivePrefix={arXiv},
      primaryClass={cs.CV}
}

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

فيم تُستخدم مجموعة بيانات COCO12-Formats؟

تم تصميم مجموعة بيانات COCO12-Formats لاختبار توافق تنسيق الصور في خطوط أنابيب تدريب Ultralytics YOLO. وهي تضمن تحميل ومعالجة جميع تنسيقات الصور الـ 12 المدعومة (AVIF، BMP، DNG، HEIC، JP2، JPEG، JPG، MPO، PNG، TIF، TIFF، WebP) بشكل صحيح.

لماذا يتم اختبار تنسيقات صور متعددة؟

تتمتع تنسيقات الصور المختلفة بخصائص فريدة (الضغط، عمق البت، مساحات الألوان). يضمن اختبار جميع التنسيقات:

  • كود تحميل صور قوي
  • التوافق عبر مجموعات بيانات متنوعة
  • الاكتشاف المبكر للأخطاء الخاصة بالتنسيق

ما هي التنسيقات التي تتطلب تبعيات خاصة؟

  • AVIF: يتطلب pillow-avif-plugin
  • HEIC: يتطلب pillow-heif

التعليقات