julien-c HF staff commited on
Commit
7c26f8e
1 Parent(s): 6e9557d

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/mrm8488/t5-base-finetuned-qasc/README.md

Files changed (1) hide show
  1. README.md +66 -0
README.md ADDED
@@ -0,0 +1,66 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ language: en
3
+ datasets:
4
+ - qasc
5
+ ---
6
+
7
+ # T5-base fine-tuned on QASC
8
+
9
+ [Google's T5](https://ai.googleblog.com/2020/02/exploring-transfer-learning-with-t5.html) fine-tuned on [QASC](https://allenai.org/data/qasc) for **QA** (via *sentence composition*) downstream task.
10
+
11
+ ## Details of T5
12
+
13
+ The **T5** model was presented in [Exploring the Limits of Transfer Learning with a Unified Text-to-Text Transformer](https://arxiv.org/pdf/1910.10683.pdf) by *Colin Raffel, Noam Shazeer, Adam Roberts, Katherine Lee, Sharan Narang, Michael Matena, Yanqi Zhou, Wei Li, Peter J. Liu* in Here the abstract:
14
+
15
+ Transfer learning, where a model is first pre-trained on a data-rich task before being fine-tuned on a downstream task, has emerged as a powerful technique in natural language processing (NLP). The effectiveness of transfer learning has given rise to a diversity of approaches, methodology, and practice. In this paper, we explore the landscape of transfer learning techniques for NLP by introducing a unified framework that converts every language problem into a text-to-text format. Our systematic study compares pre-training objectives, architectures, unlabeled datasets, transfer approaches, and other factors on dozens of language understanding tasks. By combining the insights from our exploration with scale and our new “Colossal Clean Crawled Corpus”, we achieve state-of-the-art results on many benchmarks covering summarization, question answering, text classification, and more. To facilitate future work on transfer learning for NLP, we release our dataset, pre-trained models, and code.
16
+
17
+ ![model image](https://i.imgur.com/jVFMMWR.png)
18
+
19
+
20
+ ## Details of the dataset 📚
21
+
22
+ **Question Answering via Sentence Composition** (QASC) is a question-answering dataset with a focus on sentence composition. It consists of 9,980 8-way multiple-choice questions about grade school science (8,134 train, 926 dev, 920 test), and comes with a corpus of 17M sentences.
23
+
24
+
25
+ ## Model fine-tuning 🏋️‍
26
+
27
+ The training script is a slightly modified version of [this awesome one](https://colab.research.google.com/github/patil-suraj/exploring-T5/blob/master/T5_on_TPU.ipynb) by [Suraj Patil](https://twitter.com/psuraj28). The **context** passed to the *encoder* is the combination of the 2 *facts* (`fact1` and `fact2`). The **question** is just the `formatted_question` field. The **answer** passed to the *decoder* is the`text` right answer instead of the `label` (A, B, C... See `choices` field). More details about the dataset format/fields [here](https://huggingface.co/nlp/viewer/?dataset=qasc)
28
+
29
+ ## Metrics on validation set 📋
30
+
31
+ | Metric | Score |
32
+ |--------|-------|
33
+ |Accuracy (EM) | **97.73**|
34
+
35
+
36
+ ## Model in Action 🚀
37
+
38
+ ```python
39
+ from transformers import AutoModelWithLMHead, AutoTokenizer
40
+
41
+ tokenizer = AutoTokenizer.from_pretrained("mrm8488/t5-base-finetuned-qasc")
42
+ model = AutoModelWithLMHead.from_pretrained("mrm8488/t5-base-finetuned-qasc")
43
+
44
+ def get_response(question, context, max_length=64):
45
+ input_text = 'question: %s context: %s' % (question, context)
46
+ features = tokenizer([input_text], return_tensors='pt')
47
+
48
+ output = model.generate(input_ids=features['input_ids'],
49
+ attention_mask=features['attention_mask'],
50
+ max_length=max_length)
51
+
52
+ return tokenizer.decode(output[0])
53
+
54
+ fact_1 = 'a watch is used for measuring time'
55
+ fact_2 = 'Times are measured in seconds.'
56
+ context = fact_1 + ' ' + fact_2
57
+ question = 'What can be used to measure seconds? (A) Watch (B) seconds (C) fluid (D) Ruler (E) goggles (F) glasses (G) Drill (H) Scale'
58
+
59
+ get_response(question, context)
60
+
61
+ # output: 'Watch'
62
+ ```
63
+
64
+ > Created by [Manuel Romero/@mrm8488](https://twitter.com/mrm8488) | [LinkedIn](https://www.linkedin.com/in/manuel-romero-cs/)
65
+
66
+ > Made with <span style="color: #e25555;">&hearts;</span> in Spain