Update README.md

README.md

@@ -1,3 +1,61 @@
 ---
-license: cc-by-nc-4.0
+language: en
+license: cc-by-4.0
+base_model: hkunlp/instructor-large
+tags:
+  - questionnaire-harmonization
+  - sentence-transformers
+  - prototype-learning
+  - impulse-control
+pipeline_tag: text-classification
 ---
+
+# HarmoniCA — Impulse Control Model
+
+Part of the **HarmoniCA** collection for harmonising psychiatric questionnaire items across studies.
+This model assigns items from impulse control questionnaires to one of six theoretically motivated symptom dimensions.
+
+## Dimensions
+
+| ID | Label | Description |
+|----|-------|-------------|
+| 1 | Pathological Gambling | preoccupation with gambling, difficulty controlling gambling urges, time and money spent on gambling |
+| 2 | Hypersexuality | preoccupation with sex, difficulty controlling sexual urges, time and money spent on sexual activities |
+| 3 | Compulsive Buying | preoccupation with buying, difficulty controlling buying urges, excessive spending |
+| 4 | Compulsive Eating | preoccupation with eating, difficulty controlling eating urges, overeating |
+| 5 | Punding & Hobbyism | stereotyped or repetitive behaviors, excessive engagement with hobbies, purposeless repetitive activities |
+| 6 | Dopamine Dysregulation Syndrome | compulsive use of dopaminergic medication beyond therapeutic need |
+
+Items rated as not belonging to the impulse control construct are assigned dimension **-1** (Does not fit).
+
+## Model Architecture
+
+- **Type:** PrototypeModel (prototype-based learning with a fine-tuned sentence transformer)
+- **Base encoder:** [hkunlp/instructor-large](https://huggingface.co/hkunlp/instructor-large)
+- **Inference:** Fine-tuned encoder with learned class prototypes
+
+The PrototypeModel learns a single prototype embedding per dimension. At inference, items are assigned to the nearest prototype in the fine-tuned embedding space.
+
+## Training Data
+
+- **Training items:** 58 expert-labeled questionnaire items
+- **Questionnaires:** QUIP-C, QUIP-RS
+- **Labels:** Expert consensus from two rounds of surveys (psychiatrists/neurologists)
+
+## Evaluation
+
+Evaluated on 124 held-out items from unseen questionnaires against expert labels.
+
+| Cohen's κ | Accuracy |
+|-----------|----------|
+| **0.884** | **90.3%** |
+
+## Limitations
+
+- Trained on QUIP-RS and QUIP-C; generalization to questionnaires that frame items very differently may be limited.
+- Dopamine Dysregulation Syndrome (dimension 6) is Parkinson's-specific and may not be applicable in non-PD contexts.
+- Dimension structure reflects theoretical consensus among a specific expert panel and may not match all theoretical frameworks.
+
+## Citation
+
+in preparation