đ DETR (End-to-End Object Detection) model with ResNet-101 backbone
The DETR model is an end-to-end object detection model based on the Transformer architecture, trained on the COCO 2017 panoptic dataset. It can be used for panoptic segmentation tasks.
đ Quick Start
The DETR model can be used for panoptic segmentation. You can find all available DETR models on the model hub.
⨠Features
- End-to-End Training: Trained end-to-end on the COCO 2017 panoptic dataset.
- Transformer Architecture: Based on the encoder-decoder transformer architecture.
- Panoptic Segmentation: Can be extended to perform panoptic segmentation by adding a mask head.
đĻ Installation
No specific installation steps are provided in the original document, so this section is skipped.
đģ Usage Examples
Basic Usage
from transformers import DetrFeatureExtractor, DetrForSegmentation
from PIL import Image
import requests
url = 'http://images.cocodataset.org/val2017/000000039769.jpg'
image = Image.open(requests.get(url, stream=True).raw)
feature_extractor = DetrFeatureExtractor.from_pretrained('facebook/detr-resnet-101-panoptic')
model = DetrForSegmentation.from_pretrained('facebook/detr-resnet-101-panoptic')
inputs = feature_extractor(images=image, return_tensors="pt")
outputs = model(**inputs)
processed_sizes = torch.as_tensor(inputs["pixel_values"].shape[-2:]).unsqueeze(0)
result = feature_extractor.post_process_panoptic(outputs, processed_sizes)[0]
panoptic_seg = Image.open(io.BytesIO(result["png_string"]))
panoptic_seg = numpy.array(panoptic_seg, dtype=numpy.uint8)
panoptic_seg_id = rgb_to_id(panoptic_seg)
Currently, both the feature extractor and model support PyTorch.
đ Documentation
Model description
The DETR model is an encoder-decoder transformer with a convolutional backbone. Two heads are added on top of the decoder outputs in order to perform object detection: a linear layer for the class labels and a MLP (multi-layer perceptron) for the bounding boxes. The model uses so-called object queries to detect objects in an image. Each object query looks for a particular object in the image. For COCO, the number of object queries is set to 100.
The model is trained using a "bipartite matching loss": one compares the predicted classes + bounding boxes of each of the N = 100 object queries to the ground truth annotations, padded up to the same length N (so if an image only contains 4 objects, 96 annotations will just have a "no object" as class and "no bounding box" as bounding box). The Hungarian matching algorithm is used to create an optimal one-to-one mapping between each of the N queries and each of the N annotations. Next, standard cross-entropy (for the classes) and a linear combination of the L1 and generalized IoU loss (for the bounding boxes) are used to optimize the parameters of the model.
DETR can be naturally extended to perform panoptic segmentation, by adding a mask head on top of the decoder outputs.
Intended uses & limitations
You can use the raw model for panoptic segmentation. See the model hub to look for all available DETR models.
đ§ Technical Details
Training data
The DETR model was trained on COCO 2017 panoptic, a dataset consisting of 118k/5k annotated images for training/validation respectively.
Training procedure
Preprocessing
The exact details of preprocessing of images during training/validation can be found here.
Images are resized/rescaled such that the shortest side is at least 800 pixels and the largest side at most 1333 pixels, and normalized across the RGB channels with the ImageNet mean (0.485, 0.456, 0.406) and standard deviation (0.229, 0.224, 0.225).
Training
The model was trained for 300 epochs on 16 V100 GPUs. This takes 3 days, with 4 images per GPU (hence a total batch size of 64).
Evaluation results
This model achieves the following results on COCO 2017 validation: a box AP (average precision) of 40.1, a segmentation AP (average precision) of 33 and a PQ (panoptic quality) of 45.1.
For more details regarding evaluation results, we refer to table 5 of the original paper.
đ License
The model is licensed under the Apache-2.0 license.
BibTeX entry and citation info
@article{DBLP:journals/corr/abs-2005-12872,
author = {Nicolas Carion and
Francisco Massa and
Gabriel Synnaeve and
Nicolas Usunier and
Alexander Kirillov and
Sergey Zagoruyko},
title = {End-to-End Object Detection with Transformers},
journal = {CoRR},
volume = {abs/2005.12872},
year = {2020},
url = {https://arxiv.org/abs/2005.12872},
archivePrefix = {arXiv},
eprint = {2005.12872},
timestamp = {Thu, 28 May 2020 17:38:09 +0200},
biburl = {https://dblp.org/rec/journals/corr/abs-2005-12872.bib},
bibsource = {dblp computer science bibliography, https://dblp.org}
}
Additional Information
Property |
Details |
Model Type |
DETR (End-to-End Object Detection) model with ResNet-101 backbone |
Training Data |
COCO 2017 panoptic |
Tags |
image-segmentation, vision |
â ī¸ Important Note
The team releasing DETR did not write a model card for this model so this model card has been written by the Hugging Face team.
You can find interactive examples of this model below: