joaogante HF staff commited on
Commit
99ff23f
1 Parent(s): 04ae934

init files (wo tf weights)

Browse files
Files changed (5) hide show
  1. README.md +111 -0
  2. config.json +21 -0
  3. flax_model.msgpack +3 -0
  4. preprocessor_config.json +15 -0
  5. pytorch_model.bin +3 -0
README.md ADDED
@@ -0,0 +1,111 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ tags:
4
+ - vision
5
+ datasets:
6
+ - imagenet-21k
7
+ inference: false
8
+ ---
9
+
10
+ # Vision Transformer (base-sized model)
11
+
12
+ Vision Transformer (ViT) model pre-trained on ImageNet-21k (14 million images, 21,843 classes) at resolution 224x224. It was introduced in the paper [An Image is Worth 16x16 Words: Transformers for Image Recognition at Scale](https://arxiv.org/abs/2010.11929) by Dosovitskiy et al. and first released in [this repository](https://github.com/google-research/vision_transformer). However, the weights were converted from the [timm repository](https://github.com/rwightman/pytorch-image-models) by Ross Wightman, who already converted the weights from JAX to PyTorch. Credits go to him.
13
+
14
+ Disclaimer: The team releasing ViT did not write a model card for this model so this model card has been written by the Hugging Face team.
15
+
16
+ ## Model description
17
+
18
+ The Vision Transformer (ViT) is a transformer encoder model (BERT-like) pretrained on a large collection of images in a supervised fashion, namely ImageNet-21k, at a resolution of 224x224 pixels.
19
+
20
+ Images are presented to the model as a sequence of fixed-size patches (resolution 16x16), which are linearly embedded. One also adds a [CLS] token to the beginning of a sequence to use it for classification tasks. One also adds absolute position embeddings before feeding the sequence to the layers of the Transformer encoder.
21
+
22
+ Note that this model does not provide any fine-tuned heads, as these were zero'd by Google researchers. However, the model does include the pre-trained pooler, which can be used for downstream tasks (such as image classification).
23
+
24
+ By pre-training the model, it learns an inner representation of images that can then be used to extract features useful for downstream tasks: if you have a dataset of labeled images for instance, you can train a standard classifier by placing a linear layer on top of the pre-trained encoder. One typically places a linear layer on top of the [CLS] token, as the last hidden state of this token can be seen as a representation of an entire image.
25
+
26
+ ## Intended uses & limitations
27
+
28
+ You can use the raw model for image classification. See the [model hub](https://huggingface.co/models?search=google/vit) to look for
29
+ fine-tuned versions on a task that interests you.
30
+
31
+ ### How to use
32
+
33
+ Here is how to use this model in PyTorch:
34
+
35
+ ```python
36
+ from transformers import ViTFeatureExtractor, ViTModel
37
+ from PIL import Image
38
+ import requests
39
+
40
+ url = 'http://images.cocodataset.org/val2017/000000039769.jpg'
41
+ image = Image.open(requests.get(url, stream=True).raw)
42
+
43
+ feature_extractor = ViTFeatureExtractor.from_pretrained('google/vit-base-patch16-224-in21k')
44
+ model = ViTModel.from_pretrained('google/vit-base-patch16-224-in21k')
45
+ inputs = feature_extractor(images=image, return_tensors="pt")
46
+
47
+ outputs = model(**inputs)
48
+ last_hidden_states = outputs.last_hidden_state
49
+ ```
50
+
51
+ Here is how to use this model in JAX/Flax:
52
+
53
+ ```python
54
+ from transformers import ViTFeatureExtractor, FlaxViTModel
55
+ from PIL import Image
56
+ import requests
57
+
58
+ url = 'http://images.cocodataset.org/val2017/000000039769.jpg'
59
+ image = Image.open(requests.get(url, stream=True).raw)
60
+
61
+ feature_extractor = ViTFeatureExtractor.from_pretrained('google/vit-base-patch16-224-in21k')
62
+ model = FlaxViTModel.from_pretrained('google/vit-base-patch16-224-in21k')
63
+
64
+ inputs = feature_extractor(images=image, return_tensors="np")
65
+ outputs = model(**inputs)
66
+ last_hidden_states = outputs.last_hidden_state
67
+ ```
68
+
69
+ ## Training data
70
+
71
+ The ViT model was pretrained on [ImageNet-21k](http://www.image-net.org/), a dataset consisting of 14 million images and 21k classes.
72
+
73
+ ## Training procedure
74
+
75
+ ### Preprocessing
76
+
77
+ 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).
78
+
79
+ Images are resized/rescaled to the same resolution (224x224) and normalized across the RGB channels with mean (0.5, 0.5, 0.5) and standard deviation (0.5, 0.5, 0.5).
80
+
81
+ ### Pretraining
82
+
83
+ The model was trained on TPUv3 hardware (8 cores). All model variants are trained with a batch size of 4096 and learning rate warmup of 10k steps. For ImageNet, the authors found it beneficial to additionally apply gradient clipping at global norm 1. Pre-training resolution is 224.
84
+
85
+ ## Evaluation results
86
+
87
+ For evaluation results on several image classification benchmarks, we refer to tables 2 and 5 of the original paper. Note that for fine-tuning, the best results are obtained with a higher resolution (384x384). Of course, increasing the model size will result in better performance.
88
+
89
+ ### BibTeX entry and citation info
90
+
91
+ ```bibtex
92
+ @misc{wu2020visual,
93
+ title={Visual Transformers: Token-based Image Representation and Processing for Computer Vision},
94
+ author={Bichen Wu and Chenfeng Xu and Xiaoliang Dai and Alvin Wan and Peizhao Zhang and Zhicheng Yan and Masayoshi Tomizuka and Joseph Gonzalez and Kurt Keutzer and Peter Vajda},
95
+ year={2020},
96
+ eprint={2006.03677},
97
+ archivePrefix={arXiv},
98
+ primaryClass={cs.CV}
99
+ }
100
+ ```
101
+
102
+ ```bibtex
103
+ @inproceedings{deng2009imagenet,
104
+ title={Imagenet: A large-scale hierarchical image database},
105
+ author={Deng, Jia and Dong, Wei and Socher, Richard and Li, Li-Jia and Li, Kai and Fei-Fei, Li},
106
+ booktitle={2009 IEEE conference on computer vision and pattern recognition},
107
+ pages={248--255},
108
+ year={2009},
109
+ organization={Ieee}
110
+ }
111
+ ```
config.json ADDED
@@ -0,0 +1,21 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "_name_or_path": "google/vit-base-patch16-224-in21k",
3
+ "architectures": [
4
+ "ViTModel"
5
+ ],
6
+ "attention_probs_dropout_prob": 0.0,
7
+ "hidden_act": "gelu",
8
+ "hidden_dropout_prob": 0.0,
9
+ "hidden_size": 768,
10
+ "image_size": 224,
11
+ "initializer_range": 0.02,
12
+ "intermediate_size": 3072,
13
+ "layer_norm_eps": 1e-12,
14
+ "model_type": "vit",
15
+ "num_attention_heads": 12,
16
+ "num_channels": 3,
17
+ "num_hidden_layers": 12,
18
+ "patch_size": 16,
19
+ "qkv_bias": true,
20
+ "transformers_version": "4.13.0.dev0"
21
+ }
flax_model.msgpack ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:aa00da5f7abb687576e6f9138d48cbb0fe7489f2bc9768793d262c3987b3db32
3
+ size 345564359
preprocessor_config.json ADDED
@@ -0,0 +1,15 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "do_normalize": true,
3
+ "do_resize": true,
4
+ "image_mean": [
5
+ 0.5,
6
+ 0.5,
7
+ 0.5
8
+ ],
9
+ "image_std": [
10
+ 0.5,
11
+ 0.5,
12
+ 0.5
13
+ ],
14
+ "size": 224
15
+ }
pytorch_model.bin ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:84066da0f5d8ff1cc494c660d4693141fae2e356535bf18a14d9fc00a055a6a1
3
+ size 345636463