Update README.md

README.md

@@ -41,14 +41,15 @@ model-index:
       name: Metric
 ---
 
-# SetFit with TurkuNLP/bert-base-finnish-cased-v1
+# Detect Actions in Asynchronous Conversation Comments
 
-This is a [SetFit](https://github.com/huggingface/setfit) model that can be used for Text Classification. This SetFit model uses [TurkuNLP/bert-base-finnish-cased-v1](https://huggingface.co/TurkuNLP/bert-base-finnish-cased-v1) as the Sentence Transformer embedding model. A [LogisticRegression](https://scikit-learn.org/stable/modules/generated/sklearn.linear_model.LogisticRegression.html) instance is used for classification.
+## SetFit with TurkuNLP/bert-base-finnish-cased-v1
 
+This is a SetFit model that can be used for Text Classification of actions in asynchronous conversation. This particular model detects if a comment includes a statement or not. The configuration of the model is that the model is based on only one annotator's annotations (annotator A2). Metric evaluations are based on conservative ground truth (see paper). This SetFit model uses TurkuNLP/bert-base-finnish-cased-v1 as the Sentence Transformer embedding model (using word embeddings). A LogisticRegression instance is used for classification.
 The model has been trained using an efficient few-shot learning technique that involves:
 
-1. Fine-tuning a [Sentence Transformer](https://www.sbert.net) with contrastive learning.
-2. Training a classification head with features from the fine-tuned Sentence Transformer.
+1.	Fine-tuning a Sentence Transformer with contrastive learning.
+2.	Training a classification head with features from the fine-tuned Sentence Transformer.
 
 ## Model Details
 
@@ -64,14 +65,13 @@ The model has been trained using an efficient few-shot learning technique that i
 
 ### Model Sources
 
-- **Repository:** [SetFit on GitHub](https://github.com/huggingface/setfit)
-- **Paper:** [Efficient Few-Shot Learning Without Prompts](https://arxiv.org/abs/2209.11055)
-- **Blogpost:** [SetFit: Efficient Few-Shot Learning Without Prompts](https://huggingface.co/blog/setfit)
-
+- **Repository:** [GitHub](https://github.com/henniina/Detecting-paired-actions)
+- **Paper:** Paakki, H., Toivanen, P. and Kajava K. (2025). Implicit and Indirect: Detecting Face-threatening and Paired Actions in Asynchronous Online Conversations. Northern European Journal of Language Technology (NEJLT), 11(1), pp. 58-83.
+- 
 ### Model Labels
 | Label | Examples                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 |:------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| 0     | <ul><li>'Etunimi Sukunimi herra senkun aloittaa keräyksen♥️'</li><li>'Etunimi Sukunimi venäjän syy hintojen nousu vai syytätkö sodastakin Suomen hallitusta ? 😖'</li><li>'Etunimi Etunimi Alkkiomäki, mikä on vastaus sössöttäjille, mahtava kuulla vastauksesi??'</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                    |
+| 0     | <ul><li>'Etunimi Sukunimi herra senkun aloittaa keräyksen♥️'</li><li>'Etunimi Sukunimi venäjän syy hintojen nousu vai syytätkö sodastakin Suomen hallitusta ? 😖'</li><li>'Etunimi Etunimi Sukunimi, mikä on vastaus sössöttäjille, mahtava kuulla vastauksesi??'</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                    |
 | 1     | <ul><li>'Etunimi Sukunimi Olikhaan se virve'</li><li>'Etunimi Sukunimi onneks sentään ryyppäämään pääsee, eikä tule siihen ikäviä taukoja'</li><li>'EU-maan ja länteen kallellaan olevan Suomen kimppuun käyminen olisi poliittisesti liian riskaapeliä jopa Putinille, kun Venäjällä on sisäisiäkin ongelmia ihan riittävästi. Täällä on tehty selväksi ettei mikään venäläisten "sotilaallinen apu" ole tervetullutta, eikä Suomen poliittinen tilanne uhkaa Venäjää millään lailla. Valko-Venäjä (eli Lukashenka) on jonkin sortin valtioliitossa Venäjän kanssa ja Ukraina ei kuulu mihinkään valtioliittoon. Ne ovat olleet siis ns. vapaata riistaa Venäjälle.'</li></ul> |
 
 ## Evaluation
@@ -79,7 +79,7 @@ The model has been trained using an efficient few-shot learning technique that i
 ### Metrics
 | Label   | Metric |
 |:--------|:-------|
-| **all** | 0.8975 |
+| **all** | 0.84 |
 
 ## Uses
 
@@ -102,23 +102,20 @@ model = SetFitModel.from_pretrained("Finnish-actions/SetFit-FinBERT1-A2-statemen
 preds = model("Etunimi Sukunimi 🙋‍♀️")
 ```
 
-<!--
+
 ### Downstream Use
 
-*List how someone could finetune this model on their own dataset.*
--->
+NB. This model has been trained on data coming from Finnish language asynchronous conversations under crisis related news on Facebook. This specific model has been trained to detect whether a comment includes a question or not. It reflects only one of our annotators' label interpretations, so the best use of our models (see our paper) would be to combine a set of models we provide on our Huggingface (Finnish-actions), and use a model ensemble to provide label predictions. It needs to be noted also that the model may not be well applicable outside of its empirical context, so in downstream applications, one should always conduct an evaluation of the model applicability using manually annotated data from that specific context (see our paper for annotation instructions).
 
-<!--
 ### Out-of-Scope Use
 
-*List how the model may foreseeably be misused and address what users ought not to do with the model.*
--->
+Please use this model only for action detection and analysis. Uses of this model and the involved data for generative purposes (e.g. NLG) is prohibited.
 
-<!--
 ## Bias, Risks and Limitations
 
-*What are the known or foreseeable issues stemming from this model? You could also flag here known failure cases or weaknesses of the model.*
--->
+Note that the model may produce errors. Due to the size of the training dataset, model may not generalize very well even for other novel topics within the same context. Note that model predictions should not be regarded as final judgments e.g. for online moderation purposes, but each case should also be regarded individually if using model predictions to support moderation. Also, the annotations only reflect three (though experienced) annotators' interpretations, so there might be perspectives on data intepretation that have not been taken into account here.
+If model is used to support moderation on social media, we recommend that final judgments should always be left for human moderators.
+
 
 <!--
 ### Recommendations
@@ -158,6 +155,7 @@ preds = model("Etunimi Sukunimi 🙋‍♀️")
 - eval_max_steps: -1
 - load_best_model_at_end: False
 
+<!--
 ### Training Results
 | Epoch  | Step | Training Loss | Validation Loss |
 |:------:|:----:|:-------------:|:---------------:|
@@ -223,7 +221,7 @@ preds = model("Etunimi Sukunimi 🙋‍♀️")
 | 3.8728 | 2800 | 0.0           | -               |
 | 3.9419 | 2850 | 0.0           | -               |
 | 4.0    | 2892 | -             | 0.2617          |
-
+-->
 ### Framework Versions
 - Python: 3.11.9
 - SetFit: 1.1.3
@@ -235,18 +233,21 @@ preds = model("Etunimi Sukunimi 🙋‍♀️")
 
 ## Citation
 
+If you use this model, please cite the following work:
+
 ### BibTeX
 ```bibtex
-@article{https://doi.org/10.48550/arxiv.2209.11055,
-    doi = {10.48550/ARXIV.2209.11055},
-    url = {https://arxiv.org/abs/2209.11055},
-    author = {Tunstall, Lewis and Reimers, Nils and Jo, Unso Eun Seo and Bates, Luke and Korat, Daniel and Wasserblat, Moshe and Pereg, Oren},
-    keywords = {Computation and Language (cs.CL), FOS: Computer and information sciences, FOS: Computer and information sciences},
-    title = {Efficient Few-Shot Learning Without Prompts},
-    publisher = {arXiv},
-    year = {2022},
-    copyright = {Creative Commons Attribution 4.0 International}
+@article{paakki-implicit-indirect,
+    doi = {https://doi.org/10.3384/nejlt.2000-1533.2025.5980},
+    url = {https://nejlt.ep.liu.se/article/view/5980},
+    author = {Paakki, Henna and Toivanen, Pihla and Kajava, Kaisla},
+    title = {Implicit and Indirect: Detecting Face-threatening and Paired Actions in Asynchronous Online Conversations},
+    publisher = {Northern European Journal of Language Technology (NEJLT)},
+    volume= {11},
+    number= {1},
+    year = {2025}
 }
+
 ```
 
 <!--