CollectionStudio julien-c HF Staff commited on
Commit
4f3f5eb
·
0 Parent(s):

Duplicate from facebook/detr-resnet-101-dc5

Browse files

Co-authored-by: Julien Chaumond <julien-c@users.noreply.huggingface.co>

Files changed (6) hide show
  1. .gitattributes +17 -0
  2. README.md +98 -0
  3. config.json +216 -0
  4. model.safetensors +3 -0
  5. preprocessor_config.json +18 -0
  6. pytorch_model.bin +3 -0
.gitattributes ADDED
@@ -0,0 +1,17 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ *.bin.* filter=lfs diff=lfs merge=lfs -text
2
+ *.lfs.* filter=lfs diff=lfs merge=lfs -text
3
+ *.bin filter=lfs diff=lfs merge=lfs -text
4
+ *.h5 filter=lfs diff=lfs merge=lfs -text
5
+ *.tflite filter=lfs diff=lfs merge=lfs -text
6
+ *.tar.gz filter=lfs diff=lfs merge=lfs -text
7
+ *.ot filter=lfs diff=lfs merge=lfs -text
8
+ *.onnx filter=lfs diff=lfs merge=lfs -text
9
+ *.arrow filter=lfs diff=lfs merge=lfs -text
10
+ *.ftz filter=lfs diff=lfs merge=lfs -text
11
+ *.joblib filter=lfs diff=lfs merge=lfs -text
12
+ *.model filter=lfs diff=lfs merge=lfs -text
13
+ *.msgpack filter=lfs diff=lfs merge=lfs -text
14
+ *.pb filter=lfs diff=lfs merge=lfs -text
15
+ *.pt filter=lfs diff=lfs merge=lfs -text
16
+ *.pth filter=lfs diff=lfs merge=lfs -text
17
+ model.safetensors filter=lfs diff=lfs merge=lfs -text
README.md ADDED
@@ -0,0 +1,98 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ tags:
4
+ - object-detection
5
+ datasets:
6
+ - coco
7
+ widget:
8
+ - src: https://huggingface.co/datasets/mishig/sample_images/resolve/main/savanna.jpg
9
+ example_title: Savanna
10
+ - src: https://huggingface.co/datasets/mishig/sample_images/resolve/main/football-match.jpg
11
+ example_title: Football Match
12
+ - src: https://huggingface.co/datasets/mishig/sample_images/resolve/main/airport.jpg
13
+ example_title: Airport
14
+ ---
15
+
16
+ # DETR (End-to-End Object Detection) model with ResNet-101 backbone (dilated C5 stage)
17
+
18
+ DEtection TRansformer (DETR) model trained end-to-end on COCO 2017 object detection (118k annotated images). It was introduced in the paper [End-to-End Object Detection with Transformers](https://arxiv.org/abs/2005.12872) by Carion et al. and first released in [this repository](https://github.com/facebookresearch/detr).
19
+
20
+ Disclaimer: 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.
21
+
22
+ ## Model description
23
+
24
+ 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.
25
+
26
+ 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.
27
+
28
+ ## Intended uses & limitations
29
+
30
+ You can use the raw model for object detection. See the [model hub](https://huggingface.co/models?search=facebook/detr) to look for all available DETR models.
31
+
32
+ ### How to use
33
+
34
+ Here is how to use this model:
35
+
36
+ ```python
37
+ from transformers import DetrFeatureExtractor, DetrForObjectDetection
38
+ from PIL import Image
39
+ import requests
40
+
41
+ url = 'http://images.cocodataset.org/val2017/000000039769.jpg'
42
+ image = Image.open(requests.get(url, stream=True).raw)
43
+
44
+ feature_extractor = DetrFeatureExtractor.from_pretrained('facebook/detr-resnet-101-dc5')
45
+ model = DetrForObjectDetection.from_pretrained('facebook/detr-resnet-101-dc5')
46
+
47
+ inputs = feature_extractor(images=image, return_tensors="pt")
48
+ outputs = model(**inputs)
49
+
50
+ # model predicts bounding boxes and corresponding COCO classes
51
+ logits = outputs.logits
52
+ bboxes = outputs.pred_boxes
53
+ ```
54
+
55
+ Currently, both the feature extractor and model support PyTorch.
56
+
57
+ ## Training data
58
+
59
+ The DETR model was trained on [COCO 2017 object detection](https://cocodataset.org/#download), a dataset consisting of 118k/5k annotated images for training/validation respectively.
60
+
61
+ ## Training procedure
62
+
63
+ ### Preprocessing
64
+
65
+ The exact details of preprocessing of images during training/validation can be found [here](https://github.com/google-research/vision_transformer/blob/master/vit_jax/input_pipeline.py).
66
+
67
+ 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).
68
+
69
+ ### Training
70
+
71
+ 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).
72
+
73
+ ## Evaluation results
74
+
75
+ This model achieves an AP (average precision) of **44.9** on COCO 2017 validation. For more details regarding evaluation results, we refer to table 1 of the original paper.
76
+
77
+ ### BibTeX entry and citation info
78
+
79
+ ```bibtex
80
+ @article{DBLP:journals/corr/abs-2005-12872,
81
+ author = {Nicolas Carion and
82
+ Francisco Massa and
83
+ Gabriel Synnaeve and
84
+ Nicolas Usunier and
85
+ Alexander Kirillov and
86
+ Sergey Zagoruyko},
87
+ title = {End-to-End Object Detection with Transformers},
88
+ journal = {CoRR},
89
+ volume = {abs/2005.12872},
90
+ year = {2020},
91
+ url = {https://arxiv.org/abs/2005.12872},
92
+ archivePrefix = {arXiv},
93
+ eprint = {2005.12872},
94
+ timestamp = {Thu, 28 May 2020 17:38:09 +0200},
95
+ biburl = {https://dblp.org/rec/journals/corr/abs-2005-12872.bib},
96
+ bibsource = {dblp computer science bibliography, https://dblp.org}
97
+ }
98
+ ```
config.json ADDED
@@ -0,0 +1,216 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "activation_dropout": 0.0,
3
+ "activation_function": "relu",
4
+ "architectures": [
5
+ "DetrForObjectDetection"
6
+ ],
7
+ "attention_dropout": 0.0,
8
+ "auxiliary_loss": false,
9
+ "backbone": "resnet101",
10
+ "bbox_cost": 5,
11
+ "bbox_loss_coefficient": 5,
12
+ "class_cost": 1,
13
+ "classifier_dropout": 0.0,
14
+ "d_model": 256,
15
+ "decoder_attention_heads": 8,
16
+ "decoder_ffn_dim": 2048,
17
+ "decoder_layerdrop": 0.0,
18
+ "decoder_layers": 6,
19
+ "dice_loss_coefficient": 1,
20
+ "dilation": true,
21
+ "dropout": 0.1,
22
+ "encoder_attention_heads": 8,
23
+ "encoder_ffn_dim": 2048,
24
+ "encoder_layerdrop": 0.0,
25
+ "encoder_layers": 6,
26
+ "eos_coefficient": 0.1,
27
+ "giou_cost": 2,
28
+ "giou_loss_coefficient": 2,
29
+ "id2label": {
30
+ "0": "N/A",
31
+ "1": "person",
32
+ "2": "bicycle",
33
+ "3": "car",
34
+ "4": "motorcycle",
35
+ "5": "airplane",
36
+ "6": "bus",
37
+ "7": "train",
38
+ "8": "truck",
39
+ "9": "boat",
40
+ "10": "traffic light",
41
+ "11": "fire hydrant",
42
+ "12": "N/A",
43
+ "13": "stop sign",
44
+ "14": "parking meter",
45
+ "15": "bench",
46
+ "16": "bird",
47
+ "17": "cat",
48
+ "18": "dog",
49
+ "19": "horse",
50
+ "20": "sheep",
51
+ "21": "cow",
52
+ "22": "elephant",
53
+ "23": "bear",
54
+ "24": "zebra",
55
+ "25": "giraffe",
56
+ "26": "N/A",
57
+ "27": "backpack",
58
+ "28": "umbrella",
59
+ "29": "N/A",
60
+ "30": "N/A",
61
+ "31": "handbag",
62
+ "32": "tie",
63
+ "33": "suitcase",
64
+ "34": "frisbee",
65
+ "35": "skis",
66
+ "36": "snowboard",
67
+ "37": "sports ball",
68
+ "38": "kite",
69
+ "39": "baseball bat",
70
+ "40": "baseball glove",
71
+ "41": "skateboard",
72
+ "42": "surfboard",
73
+ "43": "tennis racket",
74
+ "44": "bottle",
75
+ "45": "N/A",
76
+ "46": "wine glass",
77
+ "47": "cup",
78
+ "48": "fork",
79
+ "49": "knife",
80
+ "50": "spoon",
81
+ "51": "bowl",
82
+ "52": "banana",
83
+ "53": "apple",
84
+ "54": "sandwich",
85
+ "55": "orange",
86
+ "56": "broccoli",
87
+ "57": "carrot",
88
+ "58": "hot dog",
89
+ "59": "pizza",
90
+ "60": "donut",
91
+ "61": "cake",
92
+ "62": "chair",
93
+ "63": "couch",
94
+ "64": "potted plant",
95
+ "65": "bed",
96
+ "66": "N/A",
97
+ "67": "dining table",
98
+ "68": "N/A",
99
+ "69": "N/A",
100
+ "70": "toilet",
101
+ "71": "N/A",
102
+ "72": "tv",
103
+ "73": "laptop",
104
+ "74": "mouse",
105
+ "75": "remote",
106
+ "76": "keyboard",
107
+ "77": "cell phone",
108
+ "78": "microwave",
109
+ "79": "oven",
110
+ "80": "toaster",
111
+ "81": "sink",
112
+ "82": "refrigerator",
113
+ "83": "N/A",
114
+ "84": "book",
115
+ "85": "clock",
116
+ "86": "vase",
117
+ "87": "scissors",
118
+ "88": "teddy bear",
119
+ "89": "hair drier",
120
+ "90": "toothbrush"
121
+ },
122
+ "init_std": 0.02,
123
+ "init_xavier_std": 1.0,
124
+ "is_encoder_decoder": true,
125
+ "label2id": {
126
+ "N/A": 83,
127
+ "airplane": 5,
128
+ "apple": 53,
129
+ "backpack": 27,
130
+ "banana": 52,
131
+ "baseball bat": 39,
132
+ "baseball glove": 40,
133
+ "bear": 23,
134
+ "bed": 65,
135
+ "bench": 15,
136
+ "bicycle": 2,
137
+ "bird": 16,
138
+ "boat": 9,
139
+ "book": 84,
140
+ "bottle": 44,
141
+ "bowl": 51,
142
+ "broccoli": 56,
143
+ "bus": 6,
144
+ "cake": 61,
145
+ "car": 3,
146
+ "carrot": 57,
147
+ "cat": 17,
148
+ "cell phone": 77,
149
+ "chair": 62,
150
+ "clock": 85,
151
+ "couch": 63,
152
+ "cow": 21,
153
+ "cup": 47,
154
+ "dining table": 67,
155
+ "dog": 18,
156
+ "donut": 60,
157
+ "elephant": 22,
158
+ "fire hydrant": 11,
159
+ "fork": 48,
160
+ "frisbee": 34,
161
+ "giraffe": 25,
162
+ "hair drier": 89,
163
+ "handbag": 31,
164
+ "horse": 19,
165
+ "hot dog": 58,
166
+ "keyboard": 76,
167
+ "kite": 38,
168
+ "knife": 49,
169
+ "laptop": 73,
170
+ "microwave": 78,
171
+ "motorcycle": 4,
172
+ "mouse": 74,
173
+ "orange": 55,
174
+ "oven": 79,
175
+ "parking meter": 14,
176
+ "person": 1,
177
+ "pizza": 59,
178
+ "potted plant": 64,
179
+ "refrigerator": 82,
180
+ "remote": 75,
181
+ "sandwich": 54,
182
+ "scissors": 87,
183
+ "sheep": 20,
184
+ "sink": 81,
185
+ "skateboard": 41,
186
+ "skis": 35,
187
+ "snowboard": 36,
188
+ "spoon": 50,
189
+ "sports ball": 37,
190
+ "stop sign": 13,
191
+ "suitcase": 33,
192
+ "surfboard": 42,
193
+ "teddy bear": 88,
194
+ "tennis racket": 43,
195
+ "tie": 32,
196
+ "toaster": 80,
197
+ "toilet": 70,
198
+ "toothbrush": 90,
199
+ "traffic light": 10,
200
+ "train": 7,
201
+ "truck": 8,
202
+ "tv": 72,
203
+ "umbrella": 28,
204
+ "vase": 86,
205
+ "wine glass": 46,
206
+ "zebra": 24
207
+ },
208
+ "mask_loss_coefficient": 1,
209
+ "max_position_embeddings": 1024,
210
+ "model_type": "detr",
211
+ "num_hidden_layers": 6,
212
+ "num_queries": 100,
213
+ "position_embedding_type": "sine",
214
+ "scale_embedding": false,
215
+ "transformers_version": "4.7.0.dev0"
216
+ }
model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:707de69ca32dee6b518798a866219809eb3e76c190f70acda1c1f67c9f7de6c7
3
+ size 242797616
preprocessor_config.json ADDED
@@ -0,0 +1,18 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "do_normalize": true,
3
+ "do_resize": true,
4
+ "feature_extractor_type": "DetrFeatureExtractor",
5
+ "format": "coco_detection",
6
+ "image_mean": [
7
+ 0.485,
8
+ 0.456,
9
+ 0.406
10
+ ],
11
+ "image_std": [
12
+ 0.229,
13
+ 0.224,
14
+ 0.225
15
+ ],
16
+ "max_size": 1333,
17
+ "size": 800
18
+ }
pytorch_model.bin ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:7bd3d719aaea1dc63844e7ced0c820fa5e4cc7b041beea54f18559a88717f287
3
+ size 243011543