riccardomusmeci
commited on
Commit
•
f3d261b
1
Parent(s):
70299d1
Update README.md
Browse files
README.md
CHANGED
@@ -1,81 +1,79 @@
|
|
1 |
-
|
2 |
-
{}
|
3 |
---
|
4 |
|
5 |
-
|
6 |
-
|
7 |
-
|
8 |
-
|
9 |
-
|
10 |
-
|
11 |
-
|
12 |
-
|
13 |
-
|
14 |
-
|
15 |
-
|
16 |
-
|
17 |
|
18 |
-
|
19 |
|
20 |
-
|
21 |
|
22 |
-
|
23 |
|
24 |
-
|
25 |
-
|
26 |
-
|
27 |
|
28 |
|
29 |
-
|
30 |
-
|
31 |
-
|
32 |
-
|
33 |
|
34 |
-
|
35 |
|
36 |
-
|
37 |
-
|
38 |
-
|
39 |
-
|
40 |
|
41 |
-
|
42 |
-
|
43 |
-
|
44 |
|
45 |
-
|
46 |
-
|
47 |
|
48 |
-
|
49 |
-
|
50 |
|
51 |
-
|
52 |
-
|
53 |
-
|
54 |
-
|
55 |
-
|
56 |
|
57 |
-
|
58 |
-
|
59 |
-
|
60 |
|
61 |
-
|
62 |
-
|
63 |
-
|
64 |
|
65 |
-
|
66 |
|
67 |
-
|
68 |
-
|
69 |
-
|
70 |
|
71 |
-
|
72 |
-
|
73 |
|
74 |
-
|
75 |
-
|
76 |
|
77 |
-
|
78 |
-
|
79 |
-
|
80 |
|
81 |
-
|
|
|
1 |
+
|
|
|
2 |
---
|
3 |
|
4 |
+
---
|
5 |
+
license: apache-2.0
|
6 |
+
tags:
|
7 |
+
- mlx
|
8 |
+
- mlx-image
|
9 |
+
- vision
|
10 |
+
- image-classification
|
11 |
+
datasets:
|
12 |
+
- imagenet-1k
|
13 |
+
library_name: mlx-image
|
14 |
+
---
|
15 |
+
# vit_base_patch16_224.dino
|
16 |
|
17 |
+
A [Vision Transformer](https://arxiv.org/abs/2010.11929v2) image classification model trained on ImageNet-1k dataset with [DINO](https://arxiv.org/abs/2104.14294).
|
18 |
|
19 |
+
The model was trained in self-supervised fashion on ImageNet-1k dataset. No classification head was trained, only the backbone.
|
20 |
|
21 |
+
Disclaimer: This is a porting of the torch model weights to Apple MLX Framework.
|
22 |
|
23 |
+
<div align="center">
|
24 |
+
<img width="100%" alt="DINO illustration" src="dino.gif">
|
25 |
+
</div>
|
26 |
|
27 |
|
28 |
+
## How to use
|
29 |
+
```bash
|
30 |
+
pip install mlx-image
|
31 |
+
```
|
32 |
|
33 |
+
Here is how to use this model for image classification:
|
34 |
|
35 |
+
```python
|
36 |
+
from mlxim.model import create_model
|
37 |
+
from mlxim.io import read_rgb
|
38 |
+
from mlxim.transform import ImageNetTransform
|
39 |
|
40 |
+
transform = ImageNetTransform(train=False, img_size=224)
|
41 |
+
x = transform(read_rgb("cat.png"))
|
42 |
+
x = mx.expand_dims(x, 0)
|
43 |
|
44 |
+
model = create_model("vit_base_patch16_224.dino")
|
45 |
+
model.eval()
|
46 |
|
47 |
+
logits, attn_masks = model(x, attn_masks=True)
|
48 |
+
```
|
49 |
|
50 |
+
You can also use the embeds from layer before head:
|
51 |
+
```python
|
52 |
+
from mlxim.model import create_model
|
53 |
+
from mlxim.io import read_rgb
|
54 |
+
from mlxim.transform import ImageNetTransform
|
55 |
|
56 |
+
transform = ImageNetTransform(train=False, img_size=512)
|
57 |
+
x = transform(read_rgb("cat.png"))
|
58 |
+
x = mx.expand_dims(x, 0)
|
59 |
|
60 |
+
# first option
|
61 |
+
model = create_model("vit_base_patch16_224.dino", num_classes=0)
|
62 |
+
model.eval()
|
63 |
|
64 |
+
embeds = model(x)
|
65 |
|
66 |
+
# second option
|
67 |
+
model = create_model("vit_base_patch16_224.dino")
|
68 |
+
model.eval()
|
69 |
|
70 |
+
embeds, attn_masks = model.get_features(x)
|
71 |
+
```
|
72 |
|
73 |
+
## Attention maps
|
74 |
+
You can visualize the attention maps using the `attn_masks` returned by the model. Go check the mlx-image [notebook](https://github.com/riccardomusmeci/mlx-image/blob/main/notebooks/dino_attention.ipynb).
|
75 |
|
76 |
+
<div align="center">
|
77 |
+
<img width="100%" alt="Attention Map" src="attention_maps.png">
|
78 |
+
</div>
|
79 |
|
|