Update README.md
Browse files
README.md
CHANGED
@@ -1,3 +1,88 @@
|
|
1 |
---
|
2 |
license: mit
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
3 |
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
---
|
2 |
license: mit
|
3 |
+
datasets:
|
4 |
+
- big_patent
|
5 |
+
language:
|
6 |
+
- en
|
7 |
+
metrics:
|
8 |
+
- rouge
|
9 |
+
tags:
|
10 |
+
- summarization
|
11 |
+
- summarizer
|
12 |
+
- text summarization
|
13 |
+
- abstractive summarization
|
14 |
---
|
15 |
+
|
16 |
+
[![Generic badge](https://img.shields.io/badge/STATUS-WIP-yellow.svg)](https://shields.io/)
|
17 |
+
|
18 |
+
> ⚠️ ATTENTION
|
19 |
+
>
|
20 |
+
> NOTE THAT FOR THE MODEL TO WORK AS INTENDED, YOU NEED TO APPEND THE 'summarize:' PREFIX BEFORE THE INPUT DATA
|
21 |
+
|
22 |
+
# Table of Contents
|
23 |
+
|
24 |
+
1. [Model Details](#model-details)
|
25 |
+
2. [Uses](#uses)
|
26 |
+
3. [Training Details](#training-details)
|
27 |
+
4. [Evaluation](#evaluation)
|
28 |
+
5. [How To Get Started With the Model](#how-to-get-started-with-the-model)
|
29 |
+
6. [Citation](#citation)
|
30 |
+
7. [Author](#model-card-authors)
|
31 |
+
|
32 |
+
# Model Details
|
33 |
+
|
34 |
+
This T5 model, named `KipperDev/t5_summarizer_model`, is fine-tuned specifically for the task of document summarization. It's based on the T5 architecture, renowned for its flexibility and efficiency across a wide range of NLP tasks, including summarization. This model aims to generate concise, coherent, and informative summaries from extensive text documents, leveraging the power of the T5's text-to-text approach.
|
35 |
+
|
36 |
+
# Uses
|
37 |
+
|
38 |
+
This model is intended for use in summarizing long-form documents into concise, informative abstracts. It's particularly useful for professionals and researchers who need to quickly grasp the essence of detailed reports, research papers, or articles without reading the entire text.
|
39 |
+
|
40 |
+
# Training Details
|
41 |
+
|
42 |
+
## Training Data
|
43 |
+
|
44 |
+
The model was trained using the [Big Patent Dataset](https://huggingface.co/datasets/big_patent), comprising 1.3 million US patent documents and their corresponding human-written summaries. This dataset was chosen for its rich language and complex structure, representative of the challenging nature of document summarization tasks. Training involved multiple subsets of the dataset to ensure broad coverage and robust model performance across varied document types.
|
45 |
+
|
46 |
+
## Training Procedure
|
47 |
+
|
48 |
+
Training was conducted over three rounds, with initial settings including a learning rate of 0.00002, batch size of 8, and 4 epochs. Subsequent rounds adjusted these parameters to refine model performance further. A linear decay learning rate schedule was applied to enhance model learning efficiency over time.
|
49 |
+
|
50 |
+
# Evaluation
|
51 |
+
|
52 |
+
Model performance was evaluated using the ROUGE metric, highlighting its capability to generate summaries closely aligned with human-written abstracts.
|
53 |
+
|
54 |
+
| **Metric** | **Value** |
|
55 |
+
|-----------------------------------------|-----------|
|
56 |
+
| Evaluation Loss (Eval Loss) | 1.9984 |
|
57 |
+
| Rouge-1 | 0.503 |
|
58 |
+
| Rouge-2 | 0.286 |
|
59 |
+
| Rouge-L | 0.3813 |
|
60 |
+
| Rouge-Lsum | 0.3813 |
|
61 |
+
| Average Generation Length (Gen Len) | 151.918 |
|
62 |
+
| Runtime (seconds) | 714.4344 |
|
63 |
+
| Samples per Second | 2.679 |
|
64 |
+
| Steps per Second | 0.336 |
|
65 |
+
|
66 |
+
|
67 |
+
# How to Get Started with the Model
|
68 |
+
|
69 |
+
Use the code below to get started with the model.
|
70 |
+
|
71 |
+
<details>
|
72 |
+
<summary> Click to expand </summary>
|
73 |
+
|
74 |
+
```python
|
75 |
+
from transformers import T5Tokenizer, T5ForConditionalGeneration
|
76 |
+
|
77 |
+
tokenizer = T5Tokenizer.from_pretrained("KipperDev/t5_summarizer_model")
|
78 |
+
model = T5ForConditionalGeneration.from_pretrained("KipperDev/t5_summarizer_model")
|
79 |
+
|
80 |
+
# Example usage
|
81 |
+
prefix = "summarize: "
|
82 |
+
input_text = "Your input text here."
|
83 |
+
input_ids = tokenizer.encode(prefix + input_text, return_tensors="pt")
|
84 |
+
summary_ids = model.generate(input_ids)
|
85 |
+
summary = tokenizer.decode(summary_ids[0], skip_special_tokens=True)
|
86 |
+
|
87 |
+
print(summary)
|
88 |
+
```
|