
[![Generic badge](https://img.shields.io/badge/STATUS-WIP-yellow.svg)](https://shields.io/)

[![Open in Collab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1Dz6P-Sbrsav3Fd48F3ApdmOnoFSy_msQ?usp=sharing)

# Table of Contents

1. [Model Details](#model-details)
2. [Usage](#usage)
3. [Training Details](#training-details)
4. [Training Results](#training-results)
5. [Citation](#citation)
6. [Author](#model-card-authors)

# Model Details

This variant of the [t5-small](https://huggingface.co/google-t5/t5-small) model, is fine-tuned specifically for the task of text 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.

# Usage

This model is intended for use in summarizing long-form texts 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. 

## Get Started

Install with `pip`:

```bash
pip install transformers
```

Use in python:

```python
from transformers import pipeline
from transformers import AutoTokenizer
from transformers import AutoModelForSeq2SeqLM

model_name = "KipperDev/t5_summarizer_model"

tokenizer = AutoTokenizer.from_pretrained(model_name)
model = AutoModelForSeq2SeqLM.from_pretrained(model_name)
summarizer = pipeline("summarization", model=model, tokenizer=tokenizer)

# Example usage
prefix = "summarize: "
input_text = "Your input text here."
input_ids = tokenizer.encode(prefix + input_text, return_tensors="pt")
summary_ids = model.generate(input_ids)
summary = tokenizer.decode(summary_ids[0], skip_special_tokens=True)

print(summary)
```

**NOTE THAT FOR THE MODEL TO WORK AS INTENDED, YOU NEED TO APPEND THE 'summarize:' PREFIX BEFORE THE INPUT DATA**

# Training Details

## Training Data

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.

## Training Procedure

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, for respectively 0.0003, 8 and 12. As well, a linear decay learning rate schedule was applied to enhance model learning efficiency over time.

# Training results

Model performance was evaluated using the ROUGE metric, highlighting its capability to generate summaries closely aligned with human-written abstracts.

| **Metric**                              | **Value** |
|-----------------------------------------|-----------|
| Evaluation Loss (Eval Loss)             | 1.9984    |
| Rouge-1                                 | 0.503     |
| Rouge-2                                 | 0.286     |
| Rouge-L                                 | 0.3813    |
| Rouge-Lsum                              | 0.3813    |
| Average Generation Length (Gen Len)     | 151.918   |
| Runtime (seconds)                       | 714.4344  |
| Samples per Second                      | 2.679     |
| Steps per Second                        | 0.336     |


# Citation

**BibTeX:**

```bibtex
@article{kipper_t5_summarizer,
 // SOON
}
```

# Authors

This model card was written by [Fernanda Kipper](https://www.fernandakipper.com/)
{"language": ["en"], "license": "mit", "tags": ["summarization", "summarizer", "text summarization", "abstractive summarization"], "datasets": ["big_patent"], "metrics": ["rouge"], "pipeline_tag": "summarization"}
transformers tensorboard safetensors t5 text2text-generation summarization summarizer text summarization abstractive summarization en dataset:big_patent license:mit autotrain_compatible endpoints_compatible text-generation-inference region:us