Update README.md
Browse files
README.md
CHANGED
|
@@ -11,7 +11,17 @@ tags:
|
|
| 11 |
|
| 12 |
## 📖 Model Overview
|
| 13 |
|
| 14 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 15 |
|
| 16 |
The system consists of two distinct models housed in this repository:
|
| 17 |
1. **Life Events Detection (`LE_detection`)**: A multi-label classifier that identifies 12 categories of life events from social media posts.
|
|
@@ -142,10 +152,25 @@ LE detection model performance on each life event category:
|
|
| 142 |
|
| 143 |
## Data Availability & Privacy Statement
|
| 144 |
|
| 145 |
-
This model was trained on a subset of the **[SMHD (Self-reported Mental Health Diagnoses)](https://aclanthology.org/C18-1126/)** dataset.
|
| 146 |
|
| 147 |
**Due to the strict Data Usage Agreement of SMHD, we are prohibited from publishing or sharing any proportion of the original dataset (including our annotated subset).** Researchers interested in reproducing this work or using the data must apply for access directly from the original creators of [SMHD (Cohan et al., 2018)](https://ir.cs.georgetown.edu/resources/). We only provide the model weights and inference code here.
|
| 148 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 149 |
### Citation
|
| 150 |
If you use this model or dataset, please cite our paper:
|
| 151 |
```bibtex
|
|
|
|
| 11 |
|
| 12 |
## 📖 Model Overview
|
| 13 |
|
| 14 |
+
**What is PsyEvent?**
|
| 15 |
+
|
| 16 |
+
**PsyEvent** is a specialized NLP tool designed to extract and analyze major life events from unstructured social media text. Unlike general sentiment analysis, it focuses on identifying specific, objective occurrences (e.g., career, health) that significantly impact mental health trajectories (see Figure 1).
|
| 17 |
+
|
| 18 |
+
<!--  -->
|
| 19 |
+
<div align="center">
|
| 20 |
+
<img src="./assets/example_post.jpg" width="600" alt="Model Architecture" />
|
| 21 |
+
<em>Figure 1: User post example.</em>
|
| 22 |
+
</div>
|
| 23 |
+
|
| 24 |
+
This repository contains the **PsyEvent** models described in the paper **["Tracking Life's Ups and Downs: Mining Life Events from Social Media Posts for Mental Health Analysis"](https://aclanthology.org/2025.acl-long.345/)** (ACL 2025).
|
| 25 |
|
| 26 |
The system consists of two distinct models housed in this repository:
|
| 27 |
1. **Life Events Detection (`LE_detection`)**: A multi-label classifier that identifies 12 categories of life events from social media posts.
|
|
|
|
| 152 |
|
| 153 |
## Data Availability & Privacy Statement
|
| 154 |
|
| 155 |
+
This model was trained on **PsyEvent**, a subset of the **[SMHD (Self-reported Mental Health Diagnoses)](https://aclanthology.org/C18-1126/)** dataset.
|
| 156 |
|
| 157 |
**Due to the strict Data Usage Agreement of SMHD, we are prohibited from publishing or sharing any proportion of the original dataset (including our annotated subset).** Researchers interested in reproducing this work or using the data must apply for access directly from the original creators of [SMHD (Cohan et al., 2018)](https://ir.cs.georgetown.edu/resources/). We only provide the model weights and inference code here.
|
| 158 |
|
| 159 |
+
|
| 160 |
+
## ⚠️ Ethical Considerations & Limitations
|
| 161 |
+
|
| 162 |
+
**1. No Clinical Diagnosis:**
|
| 163 |
+
This model is designed for **research purposes only**. It is not a clinical diagnostic tool and should not be used as a substitute for professional medical advice, diagnosis, or treatment.
|
| 164 |
+
|
| 165 |
+
**2. No Automated Decision Making:**
|
| 166 |
+
The model must **not** be used for automated decision-making in high-stakes scenarios, including but not limited to:
|
| 167 |
+
- Employment screening or hiring decisions.
|
| 168 |
+
- Insurance eligibility or claims processing.
|
| 169 |
+
- Legal assessment or administrative decision-making regarding individuals.
|
| 170 |
+
|
| 171 |
+
**3. Bias & Errors:**
|
| 172 |
+
Like all models trained on social media data, this model may reflect biases present in the training corpus. It may generate false positives or misinterpret metaphorical language. Users should critically evaluate the model's outputs.
|
| 173 |
+
|
| 174 |
### Citation
|
| 175 |
If you use this model or dataset, please cite our paper:
|
| 176 |
```bibtex
|