Back to Ultralytics

COCO128 Segmentation Dataset

docs/en/datasets/segment/coco128-seg.md

8.4.947.4 KB
Original Source

COCO128-Seg Dataset

Introduction

Ultralytics COCO128-Seg is a small but versatile instance segmentation dataset composed of the first 128 images of the COCO train 2017 set. This dataset is ideal for testing and debugging segmentation models, or for experimenting with new detection approaches. With 128 images, it is small enough to be easily manageable, yet diverse enough to test training pipelines for errors and act as a sanity check before training larger datasets.

Dataset Structure

  • Images: 128 total, with train and val split identically (see note below).
  • Classes: Same 80 object categories as COCO.
  • Labels: YOLO-format polygons stored in labels/train2017 for the shared train and val image directory.
  • Download size: ~7 MB.

!!! note

The default YAML points train and val at the same 128 images, so validation metrics measure fit on the training set rather than generalization on held-out data. Duplicate or customize the split if you need a true held-out set.

This dataset is intended for use with Ultralytics Platform and YOLO26.

Dataset YAML

A YAML file is used to define the dataset configuration. It contains information about the dataset's paths, classes, and other relevant information. In the case of the COCO128-Seg dataset, the coco128-seg.yaml file is maintained at https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/coco128-seg.yaml.

!!! example "ultralytics/cfg/datasets/coco128-seg.yaml"

```yaml
--8<-- "ultralytics/cfg/datasets/coco128-seg.yaml"
```

Usage

To train a YOLO26n-seg model on the COCO128-Seg dataset for 100 epochs with an image size of 640, you can use the following code snippets. For a comprehensive list of available arguments, refer to the model Training page.

!!! example "Train Example"

=== "Python"

    ```python
    from ultralytics import YOLO

    # Load a model
    model = YOLO("yolo26n-seg.pt")  # load a pretrained model (recommended for training)

    # Train the model
    results = model.train(data="coco128-seg.yaml", epochs=100, imgsz=640)
    ```

=== "CLI"

    ```bash
    # Start training from a pretrained *.pt model
    yolo segment train data=coco128-seg.yaml model=yolo26n-seg.pt epochs=100 imgsz=640
    ```

Sample Images and Annotations

Here are some examples of images from the COCO128-Seg dataset, along with their corresponding annotations:

  • Mosaiced Image: This image demonstrates a training batch composed of mosaiced dataset images. Mosaicing is a technique used during training that combines multiple images into a single image to increase the variety of objects and scenes within each training batch. This helps improve the model's ability to generalize to different object sizes, aspect ratios, and contexts.

Citations and Acknowledgments

If you use the COCO dataset in your research or development work, please cite the following paper:

!!! quote ""

=== "BibTeX"

    ```bibtex
    @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ár},
          year={2015},
          eprint={1405.0312},
          archivePrefix={arXiv},
          primaryClass={cs.CV}
    }
    ```

We would like to acknowledge the COCO Consortium for creating and maintaining this valuable resource for the computer vision community. For more information about the COCO dataset and its creators, visit the COCO dataset website.

FAQ

What is the COCO128-Seg dataset, and how is it used in Ultralytics YOLO26?

The COCO128-Seg dataset is a compact instance segmentation dataset by Ultralytics, consisting of the first 128 images from the COCO train 2017 set. This dataset is tailored for testing and debugging segmentation models or experimenting with new detection methods. It is particularly useful with Ultralytics YOLO26 and Platform for rapid iteration and pipeline error-checking before scaling to larger datasets. For detailed usage, refer to the model Training page.

How can I train a YOLO26n-seg model using the COCO128-Seg dataset?

To train a YOLO26n-seg model on the COCO128-Seg dataset for 100 epochs with an image size of 640, you can use Python or CLI commands. Here's a quick example:

!!! example "Train Example"

=== "Python"

    ```python
    from ultralytics import YOLO

    # Load a model
    model = YOLO("yolo26n-seg.pt")  # Load a pretrained model (recommended for training)

    # Train the model
    results = model.train(data="coco128-seg.yaml", epochs=100, imgsz=640)
    ```

=== "CLI"

    ```bash
    # Start training from a pretrained *.pt model
    yolo segment train data=coco128-seg.yaml model=yolo26n-seg.pt epochs=100 imgsz=640
    ```

For a thorough explanation of available arguments and configuration options, you can check the Training documentation.

Why is the COCO128-Seg dataset important for model development and debugging?

Because the download and train/val loop are much smaller than full COCO, COCO128-Seg lets you run a 1-epoch sanity check on a new pipeline — verifying the model trains, validates, and saves checkpoints correctly — before scaling to the full COCO-Seg dataset. Learn more about supported dataset formats in the Ultralytics segmentation dataset guide.

Where can I find the YAML configuration file for the COCO128-Seg dataset?

The YAML configuration file for the COCO128-Seg dataset is available in the Ultralytics repository. You can access the file directly at https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/datasets/coco128-seg.yaml. The YAML file includes essential information about dataset paths, classes, and configuration settings required for model training and validation.

How does COCO128-Seg compare to COCO8-Seg and the full COCO-Seg dataset?

COCO128-Seg (128 images) sits between COCO8-Seg (8 images) and the full COCO-Seg dataset (118,287 training images) in terms of size:

  • COCO8-Seg: 8 images (4 train, 4 val) — ideal for quick sanity checks and debugging.
  • COCO128-Seg: 128 images — balanced between size and diversity, with train and val sharing the same directory.
  • Full COCO-Seg: 118,287 training images — comprehensive but resource-intensive, requiring ~27 GB on first download.

COCO128-Seg offers more diversity than COCO8-Seg while remaining far more manageable than the full COCO-Seg dataset for experimentation and initial model development.