https://github.com/cocodataset/panopticapi
COCO 2018 Panoptic Segmentation Task API (Beta version)
https://github.com/cocodataset/panopticapi
Last synced: 9 months ago
JSON representation
COCO 2018 Panoptic Segmentation Task API (Beta version)
- Host: GitHub
- URL: https://github.com/cocodataset/panopticapi
- Owner: cocodataset
- License: other
- Created: 2018-06-27T13:00:46.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-06-09T09:14:02.000Z (over 2 years ago)
- Last Synced: 2025-03-28T23:06:37.574Z (10 months ago)
- Language: Python
- Size: 642 KB
- Stars: 431
- Watchers: 9
- Forks: 184
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
- License: license.txt
Awesome Lists containing this project
- awesome-panoptic-segmentation - cocodataset/panopticapi
README
# COCO 2018 Panoptic Segmentation Task API (Beta version)
This API is an experimental version of [COCO 2018 Panoptic Segmentation Task API](http://cocodataset.org/#panoptic-2018).
To install panopticapi, run:
```
pip install git+https://github.com/cocodataset/panopticapi.git
```
## Summary
**Evaluation script**
[panopticapi/evaluation.py](panopticapi/evaluation.py) calculates [PQ metrics](http://cocodataset.org/#panoptic-eval).
For more information about the script usage: `python -m panopticapi.evaluation --help`
**Format converters**
COCO panoptic segmentation is stored in a new [format](http://cocodataset.org/#format-data). Unlike COCO detection format that stores each segment independently, COCO panoptic format stores all segmentations for an image in a single PNG file. This compact representation naturally maintains non-overlapping property of the panoptic segmentation.
We provide several converters for COCO panoptic format. Full description and usage examples are available [here](https://github.com/cocodataset/panopticapi/blob/master/CONVERTERS.md).
**Semantic and instance segmentation heuristic combination**
We provide [a simple script](panopticapi/combine_semantic_and_instance_predictions.py)
that heuristically combines semantic and instance segmentation predictions into panoptic segmentation prediction.
The merging logic of the script is described in the panoptic segmentation [paper](https://arxiv.org/abs/1801.00868).
In addition, this script is able to filter out stuff predicted segments that have their area below the threshold defined by `--stuff_area_limit` parameter.
For more information about the script logic and usage: `python -m panopticapi.combine_semantic_and_instance_predictions.py --help`
**COCO panoptic segmentation challenge categories**
Json file [panoptic_coco_categories.json](panoptic_coco_categories.json) contains the list of all categories used in COCO panoptic segmentation challenge 2018.
**Visualization**
[visualization.py](visualization.py) provides an example of generating visually appealing representation of the panoptic segmentation data.
## Contact
If you have any questions regarding this API, please contact us at alexander.n.kirillov-at-gmail.com.