Skip to main content

Simple command line tool to convert COCO datasets to ultralytics YOLO format.

Project description

coco-to-yolo

Simple command line tool to convert COCO object detection datasets to YOLO format.

Usage

  1. Install via pip pip install coco-to-yolo
  2. Convert COCO dataset to ultralytics YOLO format using coco_to_yolo <<coco_dir>> <<output_dir>>

By default the script assumes the coco dataset to be structured as follows:

<<coco_dir>>
├── annotations
│   └── annotations.json     # Exactly ONE annotation file in COCO json format
└── images                   # Arbitary number of images (matching the file names 
    ├── image1.jpeg          # in the annotations json file)
    ├── image2.jpeg         
    └── ...

Split generation

By default the script will split 10% of the data into a test split and not generate a validation split. The ratio of splitted test and validation data can be adapted by specifying the --test_ratio and --val_ratio arguments, e.g.

Example usage

coco_to_yolo /home/COCO_ds /home/COCO_ds --test_ratio 0.15 --val_ratio 0.1

will convert the dataset in the /home/COCO_ds to the format required by YOLO, split 15% of the data for the testing, 10% for validation, and store the resulting dataset in /home/COCO_ds

Contributions

Feel free to suggest extensions and point out mistakes by creating an issue or sending me a pull request.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

coco_to_yolo-1.2.1.tar.gz (4.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

coco_to_yolo-1.2.1-py3-none-any.whl (5.4 kB view details)

Uploaded Python 3

File details

Details for the file coco_to_yolo-1.2.1.tar.gz.

File metadata

  • Download URL: coco_to_yolo-1.2.1.tar.gz
  • Upload date:
  • Size: 4.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for coco_to_yolo-1.2.1.tar.gz
Algorithm Hash digest
SHA256 06da297a9205dde3c6c1b70842cb974373666ded0330b934178aeaf9b6f52be7
MD5 58462209548689f54f89b30ff437c50d
BLAKE2b-256 b40b25337bec2b8a4f92eb2192c5d4fdc0bb0a76f64df7aaaef1de571bb23484

See more details on using hashes here.

File details

Details for the file coco_to_yolo-1.2.1-py3-none-any.whl.

File metadata

  • Download URL: coco_to_yolo-1.2.1-py3-none-any.whl
  • Upload date:
  • Size: 5.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for coco_to_yolo-1.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8122009339e71963cdecdeb9f59278672e5bc7bfc54c9c3facbc7fd498b5102f
MD5 a004bb3a38b70989cd4114e691568119
BLAKE2b-256 e437454184d8b6106bf042f77a58d60a23a13aa7d438467346687568b3ea3add

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page