COCO12-Formats Veri Kümesi#
Giriş#
Ultralytics COCO12-Formats veri kümesi, desteklenen 12 görüntü biçimi uzantısında görüntü yüklemeyi doğrulamak için tasarlanmış özel bir test veri kümesidir. Görüntü yükleme sürecinin kapsamlı biçimde test edilmesini sağlamak için her biri farklı bir biçimde kaydedilmiş 12 görüntü (eğitim için 6, doğrulama için 6) içerir.
Bu veri kümesi şu amaçlar için çok değerlidir:
- Görüntü biçimi desteğini test etme: Yaygın görüntü biçimlerinin doğru yüklendiğini doğrula
- CI/CD süreçleri: Biçim uyumluluğunun otomatik olarak test edilmesi
- Hata ayıklama: Eğitim süreçlerinde biçime özgü sorunları yalıtma
- Geliştirme: Yeni biçim eklemelerini veya değişikliklerini doğrulama
Ultralytics Platform üzerinde veri kümelerini yönettiğinde, bu biçimlerdeki görüntüler otomatik olarak işlenir; elle dönüştürme gerekmez.
Desteklenen Biçimler#
Veri kümesinde, ultralytics/data/utils.py içinde tanımlanan IMG_FORMATS kapsamındaki 13 görüntü biçimi uzantısının 12'sinin her biri için bir görüntü bulunur; .heif de desteklenir ancak buna ait örnek görüntü yoktur:
| Biçim | Uzantı | Açıklama | Eğitim/Doğrulama |
|---|---|---|---|
| AVIF | .avif | AV1 Görüntü Dosyası Biçimi (modern) | Eğit |
| BMP | .bmp | Bitmap - sıkıştırılmamış raster biçimi | Eğit |
| DNG | .dng | Digital Negative - Adobe RAW biçimi | Eğit |
| HEIC | .heic | Yüksek Verimli Görüntü Kodlaması | Eğit |
| JPEG | .jpeg | Tam uzantılı JPEG | Eğit |
| JPG | .jpg | Kısa uzantılı JPEG | Eğit |
| JP2 | .jp2 | JPEG 2000 - tıbbi/coğrafi | Doğrula |
| MPO | .mpo | Çoklu Görüntü Nesnesi (stereo görüntüler) | Doğrula |
| PNG | .png | Taşınabilir Ağ Grafikleri | Doğrula |
| TIF | .tif | Kısa uzantılı TIFF | Doğrula |
| TIFF | .tiff | Etiketli Görüntü Dosyası Biçimi | Doğrula |
| WebP | .webp | Modern web görüntü biçimi | Doğrula |
Veri Kümesi Yapısı#
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 configurationVeri Kümesi YAML Dosyası#
COCO12-Formats veri kümesi, veri kümesi yollarını ve sınıf adlarını tanımlayan bir YAML dosyasıyla yapılandırılır. Resmî coco12-formats.yaml dosyasını Ultralytics GitHub deposunda inceleyebilirsin.
# 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.zipGereksinimler#
Elle kurulum gerekmez. OpenCV çoğu biçimi doğrudan okur; AVIF, HEIC ve HEIF için Ultralytics, Pillow'a geri döner. AVIF, Pillow 11.3 veya daha yeni bir sürümde yerel olarak çözümlenir; AVIF dosyaları yüklenemiyorsa Pillow'ı yükselt. HEIC/HEIF çözümleme için gereken hafif pi-heif paketi de ilk kullanımda otomatik olarak yüklenir.
Kullanım#
COCO12-Formats veri kümesi (1 MB), eğitime ilk başladığında otomatik olarak indirilir. COCO12-Formats veri kümesinde bir YOLO modeli eğitmek için aşağıdaki örnekleri kullan:
from ultralytics import YOLO
# Önceden eğitilmiş bir YOLO modeli yükle
model = YOLO("yolo26n.pt")
# Desteklenen 12 görüntü biçimini test etmek için COCO12-Formats üzerinde eğitim yap
results = model.train(data="coco12-formats.yaml", epochs=1, imgsz=640)Biçime Özgü Notlar#
AVIF (AV1 Görüntü Dosyası Biçimi)#
AVIF, mükemmel sıkıştırma sunan AV1 video kodlayıcısını temel alan modern bir görüntü biçimidir. OpenCV AVIF desteği sunmadığında Ultralytics, ek paket gerektirmeden Pillow 11.3 veya daha yeni bir sürüm aracılığıyla kod çözme işlemi yapar.
DNG (Digital Negative)#
DNG, TIFF'i temel alan Adobe'un açık RAW biçimidir. Test amacıyla veri kümesinde .dng uzantılı TIFF tabanlı dosyalar kullanılır.
JP2 (JPEG 2000)#
JPEG 2000, geleneksel JPEG'e kıyasla daha iyi sıkıştırma ve kalite sunan, dalgacık tabanlı bir görüntü sıkıştırma standardıdır. Tıbbi görüntülemede (DICOM), coğrafi uygulamalarda ve dijital sinemada yaygın olarak kullanılır. Hem OpenCV hem de Pillow tarafından yerel olarak desteklenir.
MPO (Çoklu Görüntü Nesnesi)#
MPO dosyaları stereoskopik (3D) görüntüler için kullanılır. Veri kümesinde biçim testi amacıyla standart JPEG verileri .mpo uzantısıyla saklanır.
HEIC / HEIF (Yüksek Verimli Görüntü Dosyası Biçimi)#
Hem .heic hem de .heif uzantıları aynı ISO/IEC 23008-12 kapsayıcısını belirtir. Geleneksel olarak .heic, HEVC ile kodlanmış HEIF dosyalarını (Apple aygıtlarının ürettiği türü) belirtirken .heif daha genel bir uzantıdır.
Ultralytics her iki biçimin kodunu da ultralytics/utils/patches.py içindeki OpenCV → Pillow yedekleme yöntemiyle çözer; bu yöntem ilk kullanımda pi-heif paketini (hafif, yalnızca kod çözme) otomatik olarak yükler — okuma için elle kurulum gerekmez. HEIC/HEIF dosyalarını kendin oluşturmak (ör. örnek görüntüleri yeniden kodlamak) için kodlayıcıları da içeren tam pillow-heif paketini yükle:
pip install pillow-heifKullanım Alanları#
CI/CD Testi#
from ultralytics import YOLO
def test_image_formats():
"""Test that 12 supported image formats load correctly."""
model = YOLO("yolo26n.pt")
results = model.train(data="coco12-formats.yaml", epochs=1, imgsz=64)
assert results is not NoneBiçim Doğrulama#
from pathlib import Path
from ultralytics.data.utils import IMG_FORMATS
# Verify all dataset formats are supported
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"Unsupported formats: {found_formats - IMG_FORMATS}"Atıflar ve Teşekkürler#
Araştırmanda COCO veri kümesini kullanıyorsan lütfen şu kaynağı belirt:
@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}
}Sık Sorulan Sorular#
COCO12-Formats veri kümesi, Ultralytics YOLO eğitim süreçlerinde görüntü biçimi uyumluluğunu test etmek için tasarlanmıştır. Desteklenen 12 görüntü biçiminin (AVIF, BMP, DNG, HEIC, JP2, JPEG, JPG, MPO, PNG, TIF, TIFF, WebP) doğru şekilde yüklenip işlendiğini doğrular.
Görüntü biçimlerinin her biri kendine özgü özelliklere (sıkıştırma, bit derinliği, renk uzayları) sahiptir. Tüm biçimleri test etmek şunları sağlar:
- Sağlam görüntü yükleme kodu
- Çeşitli veri kümeleri genelinde uyumluluk
- Biçime özgü hataların erken tespiti
Elle kurulum gerektiren bir biçim yoktur. AVIF, Pillow 11.3 veya daha yeni bir sürümde yerel olarak çözümlenir; HEIC/HEIF çözümleme için gereken
pi-heifpaketi de ilk kullanımda otomatik olarak yüklenir. Yalnızca HEIC/HEIF dosyalarını kendin yazman gerekiyorsa tampillow-heifpaketini yükle.



