julien-c HF staff commited on
Commit
dc26cab
1 Parent(s): 3c55bd4

Migrate model card from transformers-repo

Browse files

Read announcement at https://discuss.huggingface.co/t/announcement-all-model-cards-will-be-migrated-to-hf-co-model-repos/2755
Original file history: https://github.com/huggingface/transformers/commits/master/model_cards/squeezebert/squeezebert-mnli/README.md

Files changed (1) hide show
  1. README.md +67 -0
README.md ADDED
@@ -0,0 +1,67 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ language: en
2
+ license: bsd
3
+ datasets:
4
+ - bookcorpus
5
+ - wikipedia
6
+ ---
7
+
8
+ # SqueezeBERT pretrained model
9
+
10
+ This model, `squeezebert-mnli`, has been pretrained for the English language using a masked language modeling (MLM) and Sentence Order Prediction (SOP) objective and finetuned on the [Multi-Genre Natural Language Inference (MNLI)](https://cims.nyu.edu/~sbowman/multinli/) dataset.
11
+ SqueezeBERT was introduced in [this paper](https://arxiv.org/abs/2006.11316). This model is case-insensitive. The model architecture is similar to BERT-base, but with the pointwise fully-connected layers replaced with [grouped convolutions](https://blog.yani.io/filter-group-tutorial/).
12
+ The authors found that SqueezeBERT is 4.3x faster than `bert-base-uncased` on a Google Pixel 3 smartphone.
13
+
14
+
15
+ ## Pretraining
16
+
17
+ ### Pretraining data
18
+ - [BookCorpus](https://yknzhu.wixsite.com/mbweb), a dataset consisting of thousands of unpublished books
19
+ - [English Wikipedia](https://en.wikipedia.org/wiki/English_Wikipedia)
20
+
21
+ ### Pretraining procedure
22
+ The model is pretrained using the Masked Language Model (MLM) and Sentence Order Prediction (SOP) tasks.
23
+ (Author's note: If you decide to pretrain your own model, and you prefer to train with MLM only, that should work too.)
24
+
25
+ From the SqueezeBERT paper:
26
+ > We pretrain SqueezeBERT from scratch (without distillation) using the [LAMB](https://arxiv.org/abs/1904.00962) optimizer, and we employ the hyperparameters recommended by the LAMB authors: a global batch size of 8192, a learning rate of 2.5e-3, and a warmup proportion of 0.28. Following the LAMB paper's recommendations, we pretrain for 56k steps with a maximum sequence length of 128 and then for 6k steps with a maximum sequence length of 512.
27
+
28
+ ## Finetuning
29
+
30
+ The SqueezeBERT paper presents 2 approaches to finetuning the model:
31
+ - "finetuning without bells and whistles" -- after pretraining the SqueezeBERT model, finetune it on each GLUE task
32
+ - "finetuning with bells and whistles" -- after pretraining the SqueezeBERT model, finetune it on a MNLI with distillation from a teacher model. Then, use the MNLI-finetuned SqueezeBERT model as a student model to finetune on each of the other GLUE tasks (e.g. RTE, MRPC, …) with distillation from a task-specific teacher model.
33
+
34
+ A detailed discussion of the hyperparameters used for finetuning is provided in the appendix of the [SqueezeBERT paper](https://arxiv.org/abs/2006.11316).
35
+ Note that finetuning SqueezeBERT with distillation is not yet implemented in this repo. If the author (Forrest Iandola - forrest.dnn@gmail.com) gets enough encouragement from the user community, he will add example code to Transformers for finetuning SqueezeBERT with distillation.
36
+
37
+ This model, `squeezebert/squeezebert-mnli`, is the "trained with bells and whistles" MNLI-finetuned SqueezeBERT model.
38
+
39
+ ### How to finetune
40
+ To try finetuning SqueezeBERT on the [MRPC](https://www.microsoft.com/en-us/download/details.aspx?id=52398) text classification task, you can run the following command:
41
+ ```
42
+ ./utils/download_glue_data.py
43
+
44
+ python examples/text-classification/run_glue.py \
45
+ --model_name_or_path squeezebert-base-headless \
46
+ --task_name mrpc \
47
+ --data_dir ./glue_data/MRPC \
48
+ --output_dir ./models/squeezebert_mrpc \
49
+ --overwrite_output_dir \
50
+ --do_train \
51
+ --do_eval \
52
+ --num_train_epochs 10 \
53
+ --learning_rate 3e-05 \
54
+ --per_device_train_batch_size 16 \
55
+ --save_steps 20000
56
+
57
+ ```
58
+
59
+ ## BibTeX entry and citation info
60
+ ```
61
+ @article{2020_SqueezeBERT,
62
+ author = {Forrest N. Iandola and Albert E. Shaw and Ravi Krishna and Kurt W. Keutzer},
63
+ title = {{SqueezeBERT}: What can computer vision teach NLP about efficient neural networks?},
64
+ journal = {arXiv:2006.11316},
65
+ year = {2020}
66
+ }
67
+ ```