Xlmr Formality Classifier

🚀 文本正式程度分类模型

本模型用于文本正式程度分类，基于XLM - Roberta架构，在多语言数据集上训练，能有效识别不同语言文本的正式或非正式程度，为自然语言处理相关任务提供支持。

🚀 快速开始

本模型是论文 "Detecting Text Formality: A Study of Text Classification Approaches" 中所提出的模型。它是一个基于XLM - Roberta的分类器，在 XFORMAL 多语言正式程度分类数据集上进行训练。

✨ 主要特性

• 多语言支持：支持英语（en）、法语（fr）、意大利语（it）和葡萄牙语（pt）等多种语言。
• 正式程度分类：能够对文本进行正式或非正式的分类。

📦 安装指南

使用本模型前，需要安装transformers库，可使用以下命令进行安装：

pip install transformers

💻 使用示例

基础用法

from transformers import XLMRobertaTokenizerFast, XLMRobertaForSequenceClassification

# 加载分词器和模型权重
tokenizer = XLMRobertaTokenizerFast.from_pretrained('s-nlp/xlmr_formality_classifier')
model = XLMRobertaForSequenceClassification.from_pretrained('s-nlp/xlmr_formality_classifier')

id2formality = {0: "formal", 1: "informal"}
texts = [
    "I like you. I love you",
    "Hey, what's up?",
    "Siema, co porabiasz?",
    "I feel deep regret and sadness about the situation in international politics.",
]

# 准备输入
encoding = tokenizer(
    texts,
    add_special_tokens=True,
    return_token_type_ids=True,
    truncation=True,
    padding="max_length",
    return_tensors="pt",
)

# 推理
output = model(**encoding)

formality_scores = [
    {id2formality[idx]: score for idx, score in enumerate(text_scores.tolist())}
    for text_scores in output.logits.softmax(dim=1)
]
print(formality_scores)

运行上述代码后，输出结果如下：

[{'formal': 0.993225634098053, 'informal': 0.006774314679205418},
 {'formal': 0.8807966113090515, 'informal': 0.1192033663392067},
 {'formal': 0.936184287071228, 'informal': 0.06381577253341675},
 {'formal': 0.9986615180969238, 'informal': 0.0013385231141000986}]

📚 详细文档

模型评估结果

所有语言

英语（EN）

法语（FR）

意大利语（IT）

葡萄牙语（PT）

📄 许可证

本模型采用OpenRAIL++许可证，该许可证支持开发服务于公共利益的各类技术，包括工业和学术领域的技术。

📖 引用信息

如果您使用了本模型，请引用以下论文：

@inproceedings{dementieva-etal-2023-detecting,
    title = "Detecting Text Formality: A Study of Text Classification Approaches",
    author = "Dementieva, Daryna  and
      Babakov, Nikolay  and
      Panchenko, Alexander",
    editor = "Mitkov, Ruslan  and
      Angelova, Galia",
    booktitle = "Proceedings of the 14th International Conference on Recent Advances in Natural Language Processing",
    month = sep,
    year = "2023",
    address = "Varna, Bulgaria",
    publisher = "INCOMA Ltd., Shoumen, Bulgaria",
    url = "https://aclanthology.org/2023.ranlp-1.31",
    pages = "274--284",
    abstract = "Formality is one of the important characteristics of text documents. The automatic detection of the formality level of a text is potentially beneficial for various natural language processing tasks. Before, two large-scale datasets were introduced for multiple languages featuring formality annotation{---}GYAFC and X-FORMAL. However, they were primarily used for the training of style transfer models. At the same time, the detection of text formality on its own may also be a useful application. This work proposes the first to our knowledge systematic study of formality detection methods based on statistical, neural-based, and Transformer-based machine learning methods and delivers the best-performing models for public usage. We conducted three types of experiments {--} monolingual, multilingual, and cross-lingual. The study shows the overcome of Char BiLSTM model over Transformer-based ones for the monolingual and multilingual formality classification task, while Transformer-based classifiers are more stable to cross-lingual knowledge transfer.",
}