diff --git a/CHANGELOG.md b/CHANGELOG.md index ae43e4eadf..cc7b6079d6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## \[Unreleased\] +### New features +- Support MMDetection COCO format + () + ### Enhancements - Optimize Python import to make CLI entrypoint faster () diff --git a/docs/source/docs/data-formats/formats/index.rst b/docs/source/docs/data-formats/formats/index.rst index a15be1dcfa..c03b9c0257 100644 --- a/docs/source/docs/data-formats/formats/index.rst +++ b/docs/source/docs/data-formats/formats/index.rst @@ -32,6 +32,7 @@ Supported Data Formats mapillary_vistas market1501 mars + mmdet mnist mot mots @@ -141,6 +142,10 @@ Supported Data Formats * `Format specification `_ * `Dataset example `_ * `Format documentation `_ +* MMDet-COCO (``detection``, ``segmentation``) + * `Format specification `_ + * `Dataset example `_ + * `Format documentation `_ * MNIST (``classification``) * `Format specification `_ * `Dataset example `_ diff --git a/docs/source/docs/data-formats/formats/mmdet.md b/docs/source/docs/data-formats/formats/mmdet.md new file mode 100644 index 0000000000..e064341638 --- /dev/null +++ b/docs/source/docs/data-formats/formats/mmdet.md @@ -0,0 +1,41 @@ +# MMDetection COCO + +## Format specification + +[MMDetection](https://mmdetection.readthedocs.io/en/latest/) is a training framework for object detection and instance segmentation tasks, providing a modular and flexible architecture that supports various state-of-the-art models, datasets, and training techniques. MMDetection has gained popularity in the research community for its comprehensive features and ease of use in developing and benchmarking object detection algorithms. +MMDetection specifies their COCO format [here](https://mmdetection.readthedocs.io/en/latest/user_guides/dataset_prepare.html). + +Most of available tasks or formats are similar to the [original COCO format](./formats/coco), while only the image directories are separated with respect to subsets. +In this document, we just describe the directory structure of MMDetection COCO format as per [here](https://mmdetection.readthedocs.io/en/latest/user_guides/dataset_prepare.html). +MMDetection COCO dataset directory should have the following structure: + + +``` +└─ Dataset/ + ├── / + │ ├── + │ ├── + │ └── ... + ├── / + │ ├── + │ ├── + │ └── ... + └── annotations/ + ├── instances_.json + └── ... +``` + +### Import using CLI + +``` bash +datum project create +datum project import --format mmdet_coco +``` + +### Import using Python API + +```python +import datumaro as dm + +dataset = dm.Dataset.import_from('', 'mmdet_coco') +```