model update

README.md

@@ -0,0 +1,232 @@
+---
+datasets:
+- relbert/semeval2012_relational_similarity_v2
+model-index:
+- name: relbert/relbert-roberta-large-semeval2012-v2-average-prompt-e-nce
+  results:
+  - task:
+      name: Relation Mapping
+      type: sorting-task
+    dataset:
+      name: Relation Mapping
+      args: relbert/relation_mapping
+      type: relation-mapping
+    metrics:
+    - name: Accuracy
+      type: accuracy
+      value: 0.8932936507936508
+  - task:
+      name: Analogy Questions (SAT full)
+      type: multiple-choice-qa
+    dataset:
+      name: SAT full
+      args: relbert/analogy_questions
+      type: analogy-questions
+    metrics:
+    - name: Accuracy
+      type: accuracy
+      value: 0.6096256684491979
+  - task:
+      name: Analogy Questions (SAT)
+      type: multiple-choice-qa
+    dataset:
+      name: SAT
+      args: relbert/analogy_questions
+      type: analogy-questions
+    metrics:
+    - name: Accuracy
+      type: accuracy
+      value: 0.6053412462908012
+  - task:
+      name: Analogy Questions (BATS)
+      type: multiple-choice-qa
+    dataset:
+      name: BATS
+      args: relbert/analogy_questions
+      type: analogy-questions
+    metrics:
+    - name: Accuracy
+      type: accuracy
+      value: 0.754863813229572
+  - task:
+      name: Analogy Questions (Google)
+      type: multiple-choice-qa
+    dataset:
+      name: Google
+      args: relbert/analogy_questions
+      type: analogy-questions
+    metrics:
+    - name: Accuracy
+      type: accuracy
+      value: 0.886
+  - task:
+      name: Analogy Questions (U2)
+      type: multiple-choice-qa
+    dataset:
+      name: U2
+      args: relbert/analogy_questions
+      type: analogy-questions
+    metrics:
+    - name: Accuracy
+      type: accuracy
+      value: 0.5570175438596491
+  - task:
+      name: Analogy Questions (U4)
+      type: multiple-choice-qa
+    dataset:
+      name: U4
+      args: relbert/analogy_questions
+      type: analogy-questions
+    metrics:
+    - name: Accuracy
+      type: accuracy
+      value: 0.6273148148148148
+  - task:
+      name: Lexical Relation Classification (BLESS)
+      type: classification
+    dataset:
+      name: BLESS
+      args: relbert/lexical_relation_classification
+      type: relation-classification
+    metrics:
+    - name: F1
+      type: f1
+      value: 0.9255687810757872
+    - name: F1 (macro)
+      type: f1_macro
+      value: 0.9223987715298315
+  - task:
+      name: Lexical Relation Classification (CogALexV)
+      type: classification
+    dataset:
+      name: CogALexV
+      args: relbert/lexical_relation_classification
+      type: relation-classification
+    metrics:
+    - name: F1
+      type: f1
+      value: 0.8396713615023474
+    - name: F1 (macro)
+      type: f1_macro
+      value: 0.6696257351833762
+  - task:
+      name: Lexical Relation Classification (EVALution)
+      type: classification
+    dataset:
+      name: BLESS
+      args: relbert/lexical_relation_classification
+      type: relation-classification
+    metrics:
+    - name: F1
+      type: f1
+      value: 0.6803900325027086
+    - name: F1 (macro)
+      type: f1_macro
+      value: 0.6668423343702814
+  - task:
+      name: Lexical Relation Classification (K&H+N)
+      type: classification
+    dataset:
+      name: K&H+N
+      args: relbert/lexical_relation_classification
+      type: relation-classification
+    metrics:
+    - name: F1
+      type: f1
+      value: 0.9586840091813313
+    - name: F1 (macro)
+      type: f1_macro
+      value: 0.876302193283041
+  - task:
+      name: Lexical Relation Classification (ROOT09)
+      type: classification
+    dataset:
+      name: ROOT09
+      args: relbert/lexical_relation_classification
+      type: relation-classification
+    metrics:
+    - name: F1
+      type: f1
+      value: 0.9019116264493889
+    - name: F1 (macro)
+      type: f1_macro
+      value: 0.9004696301895015
+
+---
+# relbert/relbert-roberta-large-semeval2012-v2-average-prompt-e-nce
+
+RelBERT fine-tuned from [roberta-large](https://huggingface.co/roberta-large) on  
+[relbert/semeval2012_relational_similarity_v2](https://huggingface.co/datasets/relbert/semeval2012_relational_similarity_v2).
+Fine-tuning is done via [RelBERT](https://github.com/asahi417/relbert) library (see the repository for more detail).
+It achieves the following results on the relation understanding tasks:
+- Analogy Question ([dataset](https://huggingface.co/datasets/relbert/analogy_questions), [full result](https://huggingface.co/relbert/relbert-roberta-large-semeval2012-v2-average-prompt-e-nce/raw/main/analogy.json)):
+    - Accuracy on SAT (full): 0.6096256684491979 
+    - Accuracy on SAT: 0.6053412462908012
+    - Accuracy on BATS: 0.754863813229572
+    - Accuracy on U2: 0.5570175438596491
+    - Accuracy on U4: 0.6273148148148148
+    - Accuracy on Google: 0.886
+- Lexical Relation Classification ([dataset](https://huggingface.co/datasets/relbert/lexical_relation_classification), [full result](https://huggingface.co/relbert/relbert-roberta-large-semeval2012-v2-average-prompt-e-nce/raw/main/classification.json)):
+    - Micro F1 score on BLESS: 0.9255687810757872
+    - Micro F1 score on CogALexV: 0.8396713615023474
+    - Micro F1 score on EVALution: 0.6803900325027086
+    - Micro F1 score on K&H+N: 0.9586840091813313
+    - Micro F1 score on ROOT09: 0.9019116264493889
+- Relation Mapping ([dataset](https://huggingface.co/datasets/relbert/relation_mapping), [full result](https://huggingface.co/relbert/relbert-roberta-large-semeval2012-v2-average-prompt-e-nce/raw/main/relation_mapping.json)):
+    - Accuracy on Relation Mapping: 0.8932936507936508 
+
+
+### Usage
+This model can be used through the [relbert library](https://github.com/asahi417/relbert). Install the library via pip   
+```shell
+pip install relbert
+```
+and activate model as below.
+```python
+from relbert import RelBERT
+model = RelBERT("relbert/relbert-roberta-large-semeval2012-v2-average-prompt-e-nce")
+vector = model.get_embedding(['Tokyo', 'Japan'])  # shape of (1024, )
+```
+
+### Training hyperparameters
+
+The following hyperparameters were used during training:
+ - model: roberta-large
+ - max_length: 64
+ - mode: average
+ - data: relbert/semeval2012_relational_similarity_v2
+ - template_mode: manual
+ - template: I wasn’t aware of this relationship, but I just read in the encyclopedia that <obj>  is <subj>’s <mask>
+ - loss_function: nce_logout
+ - temperature_nce_constant: 0.05
+ - temperature_nce_rank: {'min': 0.01, 'max': 0.05, 'type': 'linear'}
+ - epoch: 29
+ - batch: 128
+ - lr: 5e-06
+ - lr_decay: False
+ - lr_warmup: 1
+ - weight_decay: 0
+ - random_seed: 0
+ - exclude_relation: None
+ - n_sample: 640
+ - gradient_accumulation: 8
+
+The full configuration can be found at [fine-tuning parameter file](https://huggingface.co/relbert/relbert-roberta-large-semeval2012-v2-average-prompt-e-nce/raw/main/trainer_config.json).
+
+### Reference
+If you use any resource from RelBERT, please consider to cite our [paper](https://aclanthology.org/2021.eacl-demos.7/).
+
+```
+
+@inproceedings{ushio-etal-2021-distilling-relation-embeddings,
+    title = "{D}istilling {R}elation {E}mbeddings from {P}re-trained {L}anguage {M}odels",
+    author = "Ushio, Asahi  and
+      Schockaert, Steven  and
+      Camacho-Collados, Jose",
+    booktitle = "EMNLP 2021",
+    year = "2021",
+    address = "Online",
+    publisher = "Association for Computational Linguistics",
+}
+
+```