model update

README.md

@@ -0,0 +1,232 @@
+---
+datasets:
+- relbert/semeval2012_relational_similarity
+model-index:
+- name: relbert/relbert-roberta-large-semeval2012-average-prompt-d-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: 95.0
+  - 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.7165775401069518
+  - 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.7151335311572701
+  - 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.8126737076153419
+  - 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.964
+  - 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.7192982456140351
+  - 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.6921296296296297
+  - 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.9251167696248305
+    - name: F1 (macro)
+      type: f1_macro
+      value: 0.9196346516032302
+  - 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.8607981220657277
+    - name: F1 (macro)
+      type: f1_macro
+      value: 0.7029050751301971
+  - 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.6841820151679306
+    - name: F1 (macro)
+      type: f1_macro
+      value: 0.6749077706444823
+  - 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.9595882312026153
+    - name: F1 (macro)
+      type: f1_macro
+      value: 0.8789234569786473
+  - 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.9103729238483234
+    - name: F1 (macro)
+      type: f1_macro
+      value: 0.9076447549069412
+
+---
+# relbert/relbert-roberta-large-semeval2012-average-prompt-d-nce
+
+RelBERT fine-tuned from [roberta-large](https://huggingface.co/roberta-large) on  
+[relbert/semeval2012_relational_similarity](https://huggingface.co/datasets/relbert/semeval2012_relational_similarity).
+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-average-prompt-d-nce/raw/main/analogy.json)):
+    - Accuracy on SAT (full): 0.7165775401069518 
+    - Accuracy on SAT: 0.7151335311572701
+    - Accuracy on BATS: 0.8126737076153419
+    - Accuracy on U2: 0.7192982456140351
+    - Accuracy on U4: 0.6921296296296297
+    - Accuracy on Google: 0.964
+- Lexical Relation Classification ([dataset](https://huggingface.co/datasets/relbert/lexical_relation_classification), [full result](https://huggingface.co/relbert/relbert-roberta-large-semeval2012-average-prompt-d-nce/raw/main/classification.json)):
+    - Micro F1 score on BLESS: 0.9251167696248305
+    - Micro F1 score on CogALexV: 0.8607981220657277
+    - Micro F1 score on EVALution: 0.6841820151679306
+    - Micro F1 score on K&H+N: 0.9595882312026153
+    - Micro F1 score on ROOT09: 0.9103729238483234
+- Relation Mapping ([dataset](https://huggingface.co/datasets/relbert/relation_mapping), [full result](https://huggingface.co/relbert/relbert-roberta-large-semeval2012-average-prompt-d-nce/raw/main/relation_mapping.json)):
+    - Accuracy on Relation Mapping: 95.0 
+
+
+### 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-average-prompt-d-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
+ - template_mode: manual
+ - template: I wasn’t aware of this relationship, but I just read in the encyclopedia that <subj> is the <mask> of <obj>
+ - 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-average-prompt-d-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",
+}
+
+```