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 :
| Format | Extension | Description | Entraînement/validation |
|---|---|---|---|
| AVIF | .avif | Format de fichier image AV1 (moderne) | Entraînement |
| BMP | .bmp | Bitmap - format matriciel non compressé | Entraînement |
| DNG | .dng | Digital Negative - format RAW d'Adobe | Entraînement |
| HEIC | .heic | Codage d'image à haute efficacité | Entraînement |
| JPEG | .jpeg | JPEG avec extension complète | Entraînement |
| JPG | .jpg | JPEG avec extension courte | Entraînement |
| JP2 | .jp2 | JPEG 2000 - imagerie médicale/géospatiale | Validation |
| MPO | .mpo | Objet multi-image (images stéréo) | Validation |
| PNG | .png | Graphiques réseau transportables | Validation |
| TIF | .tif | TIFF avec extension courte | Validation |
| TIFF | .tiff | Format de fichier image balisé | Validation |
| WebP | .webp | Format d'image Web moderne | Validation |
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 configurationFichier 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 🚀 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.zipConfiguration 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 :
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-heifCas 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 NoneValidation 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 :
@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-heiflors de la première utilisation. Installe le paquet completpillow-heifuniquement si tu dois créer toi-même des fichiers HEIC/HEIF.



