bert-tiny-ontonotes / README.md
arnabdhar's picture
Updated README.md
b02f94a unverified
---
language:
- en
license: mit
base_model: prajjwal1/bert-tiny
tags:
- pytorch
- BertForTokenClassification
- named-entity-recognition
- roberta-base
- generated_from_trainer
metrics:
- recall
- precision
- f1
- accuracy
model-index:
- name: bert-tiny-ontonotes
results:
- task:
type: token-classification
metrics:
- type: accuracy
value: 0.9476
name: accuracy
- type: precision
value: 0.6817
name: precision
- type: accuracy
value: 0.7193
name: recall
- type: accuracy
value: 0.7
name: F1
datasets:
- tner/ontonotes5
library_name: transformers
pipeline_tag: token-classification
---
<!-- This model card has been generated automatically according to the information the Trainer had access to. You
should probably proofread and complete it, then remove this comment. -->
# bert-tiny-ontonotes
This model is a fine-tuned version of [prajjwal1/bert-tiny](https://huggingface.co/prajjwal1/bert-tiny) on the [tner/ontonotes5](https://huggingface.co/datasets/tner/ontonotes5) dataset.
It achieves the following results on the evaluation set:
- Loss: 0.1917
- Recall: 0.7193
- Precision: 0.6817
- F1: 0.7000
- Accuracy: 0.9476
## How to use the Model
### Using pipeline
```python
from transformers import pipeline
import torch
# Initiate the pipeline
device = 0 if torch.cuda.is_available() else 'cpu'
ner = pipeline("token-classification", "arnabdhar/bert-tiny-ontonotes", device=device)
# use the pipeline
input_text = "My name is Clara and I live in Berkeley, California."
results = ner(input_text)
```
## Intended uses & limitations
This model is fine-tuned for **Named Entity Recognition** task and you can use the model as it is or can use this model as a base model for further fine tuning on your custom dataset.
The following entities were fine-tuned on:
CARDINAL, DATE, PERSON, NORP, GPE, LAW, PERCENT, ORDINAL, MONEY, WORK_OF_ART, FAC, TIME, QUANTITY, PRODUCT, LANGUAGE, ORG, LOC, EVENT
## Training and evaluation data
The dataset has 3 partitions, `train`, `validation` and `test`, all the 3 partitions were combined and then a 80:20 train-test split was made for finet uning process. The following `ID2LABEL` mapping was used.
```json
{
"0": "O",
"1": "B-CARDINAL",
"2": "B-DATE",
"3": "I-DATE",
"4": "B-PERSON",
"5": "I-PERSON",
"6": "B-NORP",
"7": "B-GPE",
"8": "I-GPE",
"9": "B-LAW",
"10": "I-LAW",
"11": "B-ORG",
"12": "I-ORG",
"13": "B-PERCENT",
"14": "I-PERCENT",
"15": "B-ORDINAL",
"16": "B-MONEY",
"17": "I-MONEY",
"18": "B-WORK_OF_ART",
"19": "I-WORK_OF_ART",
"20": "B-FAC",
"21": "B-TIME",
"22": "I-CARDINAL",
"23": "B-LOC",
"24": "B-QUANTITY",
"25": "I-QUANTITY",
"26": "I-NORP",
"27": "I-LOC",
"28": "B-PRODUCT",
"29": "I-TIME",
"30": "B-EVENT",
"31": "I-EVENT",
"32": "I-FAC",
"33": "B-LANGUAGE",
"34": "I-PRODUCT",
"35": "I-ORDINAL",
"36": "I-LANGUAGE"
}
```
## Training procedure
The model was finetuned on Google Colab with a __NVIDIA T4__ GPU with 15GB of VRAM. It took around 5 minutes to fine tune and evaluate the model with 6000 steps of total training steps. For more details, you can look into the [Weights & Biases](https://wandb.ai/2wb2ndur/NER-ontonotes/runs/d93imv8j/overview?workspace=user-2wb2ndur) log history.
### Training hyperparameters
The following hyperparameters were used during training:
- learning_rate: 8e-05
- train_batch_size: 32
- eval_batch_size: 160
- seed: 75241309
- optimizer: Adam with betas=(0.9,0.999) and epsilon=1e-08
- lr_scheduler_type: cosine
- training_steps: 6000
### Training results
| Training Loss | Epoch | Step | Validation Loss | Recall | Precision | F1 | Accuracy |
|:-------------:|:-----:|:----:|:---------------:|:------:|:---------:|:------:|:--------:|
| 0.4283 | 0.31 | 600 | 0.3864 | 0.4561 | 0.4260 | 0.4405 | 0.9058 |
| 0.3214 | 0.63 | 1200 | 0.2865 | 0.5865 | 0.5485 | 0.5669 | 0.9265 |
| 0.2886 | 0.94 | 1800 | 0.2439 | 0.6432 | 0.6165 | 0.6295 | 0.9354 |
| 0.2511 | 1.25 | 2400 | 0.2233 | 0.6765 | 0.6250 | 0.6497 | 0.9389 |
| 0.2224 | 1.56 | 3000 | 0.2088 | 0.6878 | 0.6642 | 0.6758 | 0.9433 |
| 0.2181 | 1.88 | 3600 | 0.2001 | 0.7105 | 0.6684 | 0.6888 | 0.9451 |
| 0.215 | 2.19 | 4200 | 0.1954 | 0.7140 | 0.6795 | 0.6963 | 0.9469 |
| 0.1907 | 2.5 | 4800 | 0.1934 | 0.7169 | 0.6776 | 0.6967 | 0.9470 |
| 0.209 | 2.82 | 5400 | 0.1918 | 0.7185 | 0.6812 | 0.6994 | 0.9475 |
| 0.2073 | 3.13 | 6000 | 0.1917 | 0.7193 | 0.6817 | 0.7000 | 0.9476 |
### Framework versions
- Transformers 4.36.2
- Pytorch 2.1.0+cu121
- Datasets 2.15.0
- Tokenizers 0.15.0