Ultralytics YOLO27 :
Get Started

Jeu de données COCO12-Formats#

Introduction#

Le jeu de données COCO12-Formats d'Ultralytics est un jeu de données de test spécialisé, conçu pour valider le chargement des images dans 12 extensions de format prises en charge. Il contient 12 images (6 pour l'entraînement, 6 pour la validation), chacune enregistrée dans un format différent afin de tester exhaustivement le pipeline de chargement des images.

Ce jeu de données est très utile pour :

  • Tester la prise en charge des formats d'image : vérifier que les formats d'image courants se chargent correctement
  • Pipelines CI/CD : tester automatiquement la compatibilité des formats
  • Débogage : isoler les problèmes propres à certains formats dans les pipelines d'entraînement
  • Développement : valider l'ajout ou la modification de formats

Lorsque tu gères des jeux de données sur la plateforme Ultralytics, les images dans ces formats sont traitées automatiquement : aucune conversion manuelle n'est nécessaire.

Formats pris en charge#

Le jeu de données comprend une image pour 12 des 13 extensions de format d'image dans IMG_FORMATS (définies dans ultralytics/data/utils.py) ; .heif est également pris en charge, mais ne dispose d'aucune image d'exemple :

FormatExtensionDescriptionEntraînement/validation
AVIF.avifFormat de fichier image AV1 (moderne)Entraînement
BMP.bmpBitmap - format matriciel non compresséEntraînement
DNG.dngDigital Negative - format RAW d'AdobeEntraînement
HEIC.heicCodage d'image à haute efficacitéEntraînement
JPEG.jpegJPEG avec extension complèteEntraînement
JPG.jpgJPEG avec extension courteEntraînement
JP2.jp2JPEG 2000 - imagerie médicale/géospatialeValidation
MPO.mpoObjet multi-image (images stéréo)Validation
PNG.pngGraphiques réseau transportablesValidation
TIF.tifTIFF avec extension courteValidation
TIFF.tiffFormat de fichier image baliséValidation
WebP.webpFormat d'image Web moderneValidation

Structure du jeu de données#

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

Fichier YAML du jeu de données#

Le jeu de données COCO12-Formats est configuré à l'aide d'un fichier YAML qui définit les chemins d'accès aux données et les noms de classes. Tu peux consulter le fichier officiel coco12-formats.yaml dans le dépôt GitHub d'Ultralytics.

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

Configuration requise#

Aucune configuration manuelle n'est nécessaire. OpenCV lit directement la plupart des formats, et Ultralytics utilise Pillow en solution de repli pour AVIF, HEIC et HEIF. Pillow 11.3 ou une version ultérieure décode AVIF nativement : mets Pillow à niveau si les fichiers AVIF ne se chargent pas. Pour le décodage HEIC/HEIF, le paquet léger pi-heif s'installe automatiquement lors de la première utilisation.

Utilisation#

Le jeu de données COCO12-Formats (1 MB) se télécharge automatiquement au premier lancement de l'entraînement. Pour entraîner un modèle YOLO sur le jeu de données COCO12-Formats, utilise les exemples suivants :

Exemple d’entraînement
from ultralytics import YOLO

# Charger un modèle YOLO préentraîné
model = YOLO("yolo26n.pt")

# Entraîne sur COCO12-Formats pour tester 12 formats d'image pris en charge
results = model.train(data="coco12-formats.yaml", epochs=1, imgsz=640)

Remarques propres à chaque format#

AVIF (format de fichier image AV1)#

AVIF est un format d'image moderne basé sur le codec vidéo AV1, qui offre une excellente compression. Lorsque OpenCV ne prend pas en charge AVIF, Ultralytics le décode avec Pillow 11.3 ou une version ultérieure, sans nécessiter de paquet supplémentaire.

DNG (Digital Negative)#

DNG est le format RAW ouvert d'Adobe, basé sur TIFF. Pour les tests, le jeu de données utilise des fichiers basés sur TIFF avec l'extension .dng.

JP2 (JPEG 2000)#

JPEG 2000 est une norme de compression d'image fondée sur les ondelettes, qui offre une meilleure compression et une meilleure qualité que le JPEG traditionnel. Elle est couramment utilisée en imagerie médicale (DICOM), dans les applications géospatiales et au cinéma numérique. OpenCV et Pillow la prennent tous deux en charge nativement.

MPO (objet multi-image)#

Les fichiers MPO servent aux images stéréoscopiques (3D). Pour tester le format, le jeu de données stocke des données JPEG standard avec l'extension .mpo.

HEIC / HEIF (format de fichier image à haute efficacité)#

Les extensions .heic et .heif font toutes deux référence au même conteneur ISO/IEC 23008-12. Par convention, .heic désigne les fichiers HEIF encodés en HEVC (la variante produite par les appareils Apple), tandis que .heif est l'extension générique plus large.

Ultralytics décode les deux formats grâce à la solution de repli OpenCV → Pillow dans ultralytics/utils/patches.py, qui installe automatiquement pi-heif (léger, dédié au décodage) lors de la première utilisation : aucune configuration manuelle n'est nécessaire pour la lecture. Pour créer toi-même des fichiers HEIC/HEIF (par exemple, réencoder des images d'exemple), installe le paquet complet pillow-heif, qui comprend des encodeurs :

pip install pillow-heif

Cas d’utilisation#

Tests CI/CD#

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 None

Validation des formats#

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}"

Citations et remerciements#

Si tu utilises le jeu de données COCO dans tes recherches, merci de le citer :

Citation
@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}
}

FAQ#

  • Le jeu de données COCO12-Formats est conçu pour tester la compatibilité des formats d'image dans les pipelines d'entraînement Ultralytics YOLO. Il vérifie que 12 formats d'image pris en charge (AVIF, BMP, DNG, HEIC, JP2, JPEG, JPG, MPO, PNG, TIF, TIFF, WebP) se chargent et sont traités correctement.

  • Les différents formats d'image ont des caractéristiques propres (compression, profondeur de bits, espaces colorimétriques). Tester tous les formats permet de garantir :

    • Un code de chargement d'image robuste
    • La compatibilité avec des jeux de données variés
    • La détection précoce des bogues propres à certains formats
  • Aucune installation manuelle n'est nécessaire. Pillow 11.3 ou une version ultérieure décode AVIF nativement, et le décodage HEIC/HEIF installe automatiquement pi-heif lors de la première utilisation. Installe le paquet complet pillow-heif uniquement si tu dois créer toi-même des fichiers HEIC/HEIF.

Commentaires