README.md

---
datasets:
- IteraTeR_full_sent
---

# IteraTeR RoBERTa model
This model was obtained by fine-tuning [roberta-large](https://huggingface.co/roberta-large) on [IteraTeR-human-sent](https://huggingface.co/datasets/wanyu/IteraTeR_human_sent) dataset.

Paper: [Understanding Iterative Revision from Human-Written Text](https://arxiv.org/abs/2203.03802) <br>
Authors: Wanyu Du, Vipul Raheja, Dhruv Kumar, Zae Myung Kim, Melissa Lopez, Dongyeop Kang

## Edit Intention Prediction Task
Given a pair of original sentence and revised sentence, our model can predict the edit intention for this revision pair.<br>
More specifically, the model will predict the probability of the following edit intentions:
<table>
  <tr>
    <th>Edit Intention</th>
    <th>Definition</th>
    <th>Example</th>
  </tr>
  <tr>
    <td>clarity</td>
    <td>Make the text more formal, concise, readable and understandable.</td>
    <td>
    Original: It's like a house which anyone can enter in it. <br>
    Revised: It's like a house which anyone can enter.
    </td>
  </tr>
  <tr>
    <td>fluency</td>
    <td>Fix grammatical errors in the text.</td>
    <td>
    Original: In the same year he became the Fellow of the Royal Society. <br>
    Revised: In the same year, he became the Fellow of the Royal Society.
    </td>
  </tr>
  <tr>
    <td>coherence</td>
    <td>Make the text more cohesive, logically linked and consistent as a whole.</td>
    <td>
    Original: Achievements and awards Among his other activities, he founded the Karachi Film Guild and Pakistan Film and TV Academy. <br>
    Revised: Among his other activities, he founded the Karachi Film Guild and Pakistan Film and TV Academy.
    </td>
  </tr>
  <tr>
    <td>style</td>
    <td>Convey the writer’s writing preferences, including emotions, tone, voice, etc..</td>
    <td>
    Original: She was last seen on 2005-10-22. <br>
    Revised: She was last seen on October 22, 2005.
    </td>
  </tr>
  <tr>
    <td>meaning-changed</td>
    <td>Update or add new information to the text.</td>
    <td>
    Original: This method improves the model accuracy from 64% to 78%. <br>
    Revised: This method improves the model accuracy from 64% to 83%.
    </td>
  </tr>
</table>



## Usage
```python
import torch
from transformers import AutoTokenizer, AutoModelForSequenceClassification

tokenizer = AutoTokenizer.from_pretrained("wanyu/IteraTeR-ROBERTA-Intention-Classifier")
model = AutoModelForSequenceClassification.from_pretrained("wanyu/IteraTeR-ROBERTA-Intention-Classifier")

id2label = {0: "clarity", 1: "fluency", 2: "coherence", 3: "style", 4: "meaning-changed"}

before_text = 'I likes coffee.'
after_text = 'I like coffee.'
model_input = tokenizer(before_text, after_text, return_tensors='pt')
model_output = model(**model_input)
softmax_scores = torch.softmax(model_output.logits, dim=-1)
pred_id = torch.argmax(softmax_scores)
pred_label = id2label[pred_id.int()]
```