Ultralytics YOLO27:

Conjunto de datos COCO12-Formats#

Introducción#

El conjunto de datos COCO12-Formats de Ultralytics es un conjunto de datos de prueba especializado diseñado para validar la carga de imágenes en 12 extensiones de formato de imagen compatibles. Contiene 12 imágenes (6 para entrenamiento y 6 para validación), cada una guardada en un formato diferente para garantizar pruebas exhaustivas de la canalización de carga de imágenes.

Este conjunto de datos es de gran utilidad para:

  • Probar la compatibilidad con formatos de imagen: verifica que los formatos de imagen habituales se carguen correctamente
  • Canalizaciones de CI/CD: pruebas automatizadas de compatibilidad de formatos
  • Depuración: aísla problemas específicos de cada formato en las canalizaciones de entrenamiento
  • Desarrollo: valida la incorporación o los cambios de nuevos formatos

Cuando gestionas conjuntos de datos en Ultralytics Platform, las imágenes en cualquiera de estos formatos se gestionan automáticamente, sin necesidad de conversión manual.

Formatos compatibles#

El conjunto de datos incluye una imagen para cada una de las 12 extensiones de formato compatibles definidas en ultralytics/data/utils.py:

FormatoExtensiónDescripciónEntrenamiento/validación
AVIF.avifFormato de archivo de imagen AV1 (moderno)Entrenar
BMP.bmpMapa de bits: formato ráster sin compresiónEntrenar
DNG.dngNegativo digital: formato RAW de AdobeEntrenar
HEIC.heicCodificación de imágenes de alta eficienciaEntrenar
JPEG.jpegJPEG con la extensión completaEntrenar
JPG.jpgJPEG con la extensión cortaEntrenar
JP2.jp2JPEG 2000: médico/geoespacialVal
MPO.mpoObjeto multipimagen (imágenes estereoscópicas)Val
PNG.pngGráficos de red portátilesVal
TIF.tifTIFF con la extensión cortaVal
TIFF.tiffFormato de archivo de imagen etiquetadoVal
WebP.webpFormato moderno de imagen webVal

Estructura del dataset#

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 del dataset#

El conjunto de datos COCO12-Formats se configura mediante un archivo YAML que define las rutas del conjunto de datos y los nombres de las clases. Puedes consultar el archivo oficial coco12-formats.yaml en el repositorio de Ultralytics en 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

Requisitos#

No se necesita ninguna configuración manual. OpenCV lee la mayoría de los formatos directamente y Ultralytics recurre a Pillow para AVIF, HEIC y HEIF. AVIF se decodifica de forma nativa mediante Pillow 11.3 o posterior, así que actualiza Pillow si los archivos AVIF no se cargan, y la decodificación de HEIC y HEIF instala el paquete ligero pi-heif automáticamente en el primer uso.

Uso#

El conjunto de datos COCO12-Formats (1 MB) se descarga automáticamente la primera vez que inicias el entrenamiento. Para entrenar un modelo YOLO con el conjunto de datos COCO12-Formats, utiliza los siguientes ejemplos:

Ejemplo de entrenamiento
from ultralytics import YOLO

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

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

Notas específicas de cada formato#

AVIF (formato de archivo de imagen AV1)#

AVIF es un formato de imagen moderno basado en el códec de vídeo AV1 que ofrece una compresión excelente. Ultralytics lo decodifica a través de Pillow 11.3 o posterior cuando OpenCV carece de compatibilidad con AVIF, sin necesidad de paquetes adicionales.

DNG (negativo digital)#

DNG es el formato RAW abierto de Adobe basado en TIFF. Para las pruebas, el conjunto de datos utiliza archivos basados en TIFF con la extensión .dng.

JP2 (JPEG 2000)#

JPEG 2000 es un estándar de compresión de imágenes basado en wavelets que ofrece una compresión y una calidad superiores a las del JPEG tradicional. Se utiliza habitualmente en imagen médica (DICOM), aplicaciones geoespaciales y cine digital. OpenCV y Pillow ofrecen compatibilidad nativa.

MPO (objeto multip imagen)#

Los archivos MPO se utilizan para imágenes estereoscópicas (3D). El conjunto de datos almacena datos JPEG estándar con la extensión .mpo para probar el formato.

HEIC/HEIF (formato de archivo de imagen de alta eficiencia)#

Las extensiones .heic y .heif hacen referencia al mismo contenedor ISO/IEC 23008-12. Por convención, .heic designa archivos HEIF codificados con HEVC (la variante producida por los dispositivos Apple), mientras que .heif es la extensión general que engloba ambas.

Ultralytics decodifica ambos mediante la alternativa de OpenCV → Pillow en ultralytics/utils/patches.py, que instala automáticamente pi-heif (ligero y solo para decodificación) durante el primer uso; no se necesita configuración manual para la lectura. Para producir archivos HEIC/HEIF por tu cuenta (por ejemplo, para volver a codificar imágenes de muestra), instala el paquete completo pillow-heif, que incluye codificadores:

pip install pillow-heif

Casos de uso#

Pruebas de 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

Validación de formatos#

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

Citas y agradecimientos#

Si utilizas el conjunto de datos COCO en tu investigación, cita:

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

Preguntas frecuentes#

  • El conjunto de datos COCO12-Formats está diseñado para probar la compatibilidad de formatos de imagen en las canalizaciones de entrenamiento de Ultralytics YOLO. Garantiza que los 12 formatos de imagen compatibles (AVIF, BMP, DNG, HEIC, JP2, JPEG, JPG, MPO, PNG, TIF, TIFF, WebP) se carguen y procesen correctamente.

  • Los distintos formatos de imagen tienen características únicas (compresión, profundidad de bits y espacios de color). Probarlos todos garantiza:

    • Código de carga de imágenes robusto
    • Compatibilidad con conjuntos de datos diversos
    • Detección temprana de errores específicos de cada formato
  • Ninguno necesita instalación manual. AVIF se decodifica de forma nativa mediante Pillow 11.3 o posterior, y la decodificación de HEIC y HEIF instala pi-heif automáticamente en el primer uso. Instala el paquete completo pillow-heif solo si necesitas escribir archivos HEIC o HEIF por ti mismo.

Comentarios