|
|
|
--- |
|
--- |
|
language: |
|
- es |
|
tags: |
|
- text-classification |
|
- pytorch |
|
metrics: |
|
- accuracy |
|
- f1-score |
|
--- |
|
# xlm-roberta-large-spanish-legislative-cap-v3 |
|
## Model description |
|
An `xlm-roberta-large` model fine-tuned on spanish training data containing legislative documents (bills, laws, motions, legislative decrees, hearings, resolutions) labeled with [major topic codes](https://www.comparativeagendas.net/pages/master-codebook) from the [Comparative Agendas Project](https://www.comparativeagendas.net/). |
|
|
|
## How to use the model |
|
This snippet prints the three most probable labels and their corresponding softmax scores: |
|
```python |
|
import torch |
|
from transformers import AutoModelForSequenceClassification, AutoTokenizer |
|
|
|
model = AutoModelForSequenceClassification.from_pretrained("poltextlab/xlm-roberta-large-spanish-legislative-cap-v3") |
|
tokenizer = AutoTokenizer.from_pretrained("xlm-roberta-large") |
|
|
|
sentence = "This is an example." |
|
|
|
inputs = tokenizer(sentence, |
|
return_tensors="pt", |
|
max_length=512, |
|
padding="do_not_pad", |
|
truncation=True |
|
) |
|
|
|
logits = model(**inputs).logits |
|
|
|
probs = torch.softmax(logits, dim=1).tolist()[0] |
|
probs = {model.config.id2label[index]: round(probability, 2) for index, probability in enumerate(probs)} |
|
top3_probs = dict(sorted(probs.items(), key=lambda item: item[1], reverse=True)[:3]) |
|
|
|
print(top3_probs) |
|
``` |
|
|
|
## Model performance |
|
The model was evaluated on a test set of 1638 examples.<br> |
|
Model accuracy is **0.85**. |
|
| label | precision | recall | f1-score | support | |
|
|:-------------|------------:|---------:|-----------:|----------:| |
|
| 0 | 0.86 | 0.87 | 0.86 | 110 | |
|
| 1 | 0.76 | 0.73 | 0.75 | 86 | |
|
| 2 | 0.85 | 0.87 | 0.86 | 71 | |
|
| 3 | 0.86 | 0.83 | 0.84 | 52 | |
|
| 4 | 0.84 | 0.88 | 0.86 | 135 | |
|
| 5 | 0.87 | 0.92 | 0.9 | 150 | |
|
| 6 | 0.88 | 0.88 | 0.88 | 42 | |
|
| 7 | 0.95 | 0.86 | 0.9 | 49 | |
|
| 8 | 0.8 | 0.44 | 0.57 | 9 | |
|
| 9 | 0.81 | 0.91 | 0.86 | 85 | |
|
| 10 | 0.84 | 0.9 | 0.87 | 157 | |
|
| 11 | 0.83 | 0.81 | 0.82 | 91 | |
|
| 12 | 0.86 | 0.77 | 0.81 | 31 | |
|
| 13 | 0.88 | 0.82 | 0.85 | 210 | |
|
| 14 | 0.91 | 0.89 | 0.9 | 56 | |
|
| 15 | 0.87 | 0.89 | 0.88 | 54 | |
|
| 16 | 0 | 0 | 0 | 4 | |
|
| 17 | 0.83 | 0.8 | 0.81 | 49 | |
|
| 18 | 0.84 | 0.83 | 0.83 | 156 | |
|
| 19 | 0.77 | 0.83 | 0.8 | 24 | |
|
| 20 | 0.84 | 0.94 | 0.89 | 17 | |
|
| macro avg | 0.81 | 0.79 | 0.8 | 1638 | |
|
| weighted avg | 0.85 | 0.85 | 0.85 | 1638 | |
|
|
|
### Fine-tuning procedure |
|
This model was fine-tuned with the following key hyperparameters: |
|
|
|
- **Number of Training Epochs**: 10 |
|
- **Batch Size**: 8 |
|
- **Learning Rate**: 5e-06 |
|
- **Early Stopping**: enabled with a patience of 2 epochs |
|
|
|
## Inference platform |
|
This model is used by the [CAP Babel Machine](https://babel.poltextlab.com), an open-source and free natural language processing tool, designed to simplify and speed up projects for comparative research. |
|
|
|
## Cooperation |
|
Model performance can be significantly improved by extending our training sets. We appreciate every submission of CAP-coded corpora (of any domain and language) at poltextlab{at}poltextlab{dot}com or by using the [CAP Babel Machine](https://babel.poltextlab.com). |
|
|
|
## Reference |
|
Sebők, M., Máté, Á., Ring, O., Kovács, V., & Lehoczki, R. (2024). Leveraging Open Large Language Models for Multilingual Policy Topic Classification: The Babel Machine Approach. Social Science Computer Review, 0(0). https://doi.org/10.1177/08944393241259434 |
|
|
|
## Debugging and issues |
|
This architecture uses the `sentencepiece` tokenizer. In order to use the model before `transformers==4.27` you need to install it manually. |
|
|
|
If you encounter a `RuntimeError` when loading the model using the `from_pretrained()` method, adding `ignore_mismatched_sizes=True` should solve the issue. |
|
|
