metadata

language:
  - es
tags:
  - text-classification
  - pytorch
metrics:
  - accuracy
  - f1-score

xlm-roberta-large-spanish-parlspeech-cap-v3

Model description

An xlm-roberta-large model fine-tuned on spanish training data containing parliamentary speeches (oral questions, interpellations, bill debates, other plenary speeches, urgent questions) labeled with major topic codes from the Comparative Agendas Project.

How to use the model

This snippet prints the three most probable labels and their corresponding softmax scores:

import torch
from transformers import AutoModelForSequenceClassification, AutoTokenizer

model = AutoModelForSequenceClassification.from_pretrained("poltextlab/xlm-roberta-large-spanish-parlspeech-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 17401 examples.
Model accuracy is 0.39.

label	precision	recall	f1-score	support
0	0.39	0.46	0.42	526
1	0.32	0.19	0.24	562
2	0.37	0.46	0.41	827
3	0.38	0.4	0.39	778
4	0.37	0.43	0.4	725
5	0.33	0.27	0.29	713
6	0.25	0.14	0.17	473
7	0.39	0.67	0.49	333
8	0.43	0.25	0.31	1227
9	0.42	0.45	0.43	1881
10	0.43	0.59	0.5	1017
11	0.68	0.65	0.66	827
12	0.3	0.13	0.19	559
13	0.26	0.21	0.24	557
14	0.41	0.65	0.51	473
15	0.36	0.45	0.4	702
16	0.36	0.32	0.34	761
17	0.4	0.53	0.46	850
18	0.44	0.43	0.44	891
19	0.34	0.27	0.3	1283
20	0.37	0.57	0.45	132
21	0.33	0.32	0.33	1304
macro avg	0.38	0.4	0.38	17401
weighted avg	0.39	0.39	0.38	17401

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, 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.

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.