No Description

Dean a4d61031c2 Added try on colab badge 3 months ago
.dvc 095918344d Initial dvc commit, add dataset 4 months ago
datasets
embedding c4f4d26d8a initial commit 6 months ago
named-entity-recognition 4336332bb4 removed tmp files and added relation extraction task preprocessed data 3 months ago
output
preprocessed_datasets
question-answering c4f4d26d8a initial commit 6 months ago
relation-extraction 4336332bb4 removed tmp files and added relation extraction task preprocessed data 3 months ago
.dvcignore 095918344d Initial dvc commit, add dataset 4 months ago
.gitignore 7f7a7969b3 Tracking preprocessing folder as an entire directory 3 months ago
BioBERT_DAGsHub.ipynb e06c7c003f Update Notebook with bugfix 3 months ago
LICENSE c4f4d26d8a initial commit 6 months ago
README.md a4d61031c2 Added try on colab badge 3 months ago
datasets.dvc 095918344d Initial dvc commit, add dataset 4 months ago
download.sh c4f4d26d8a initial commit 6 months ago
metrics.csv 4f824f622c Simplify inference interface 4 months ago
output.dvc 4f824f622c Simplify inference interface 4 months ago
params.yaml 4f824f622c Simplify inference interface 4 months ago
preprocessed_datasets.dvc 4336332bb4 removed tmp files and added relation extraction task preprocessed data 3 months ago
requirements-mac.txt 5363b9c148 Simplified the DVC pipeline for the project 3 months ago
requirements.txt 51fdefb5e8 added requirement 4 months ago

Data Pipeline

Legend
DVC Managed File
Git Managed File
Metric
Stage File
External File

README.md

BioBERT-PyTorch

Try BioBERT on Google Colab: Open In Colab

This repository provides the PyTorch implementation of BioBERT. You can easily use BioBERT with transformers. This project is supported by the members of DMIS-Lab @ Korea University including Jinhyuk Lee, Wonjin Yoon, Minbyul Jeong, Mujeen Sung, and Gangwoo Kim.

Installation

# Install requirements
pip install -r requirements

# Download all the data using dvc
dvc pull

Note that you should also install torch (see download instruction) to use transformers.

Models

We provide following versions of BioBERT in PyTorch (click here to see all). You can use BioBERT in transformers by setting --model_name_or_path as one of them (see example below).

  • dmis-lab/biobert-base-cased-v1.1: BioBERT-Base v1.1 (+ PubMed 1M)
  • dmis-lab/biobert-large-cased-v1.1: BioBERT-Large v1.1 (+ PubMed 1M)
  • dmis-lab/biobert-base-cased-v1.1-mnli: BioBERT-Base v1.1 pre-trained on MNLI
  • dmis-lab/biobert-base-cased-v1.1-squad: BioBERT-Base v1.1 pre-trained on SQuAD

For other versions of BioBERT or for Tensorflow, please see the README in the original BioBERT repository. You can convert any version of BioBERT into PyTorch with this.

Example

For instance, to train BioBERT on the NER dataset (NCBI-disease), run as:

# Pre-process NER datasets
cd named-entity-recognition
./preprocess.sh

# Choose dataset and run
export DATA_DIR=../datasets/NER
export ENTITY=NCBI-disease
python run_ner.py \
    --data_dir ${DATA_DIR}/${ENTITY} \
    --labels ${DATA_DIR}/${ENTITY}/labels.txt \
    --model_name_or_path dmis-lab/biobert-base-cased-v1.1 \
    --output_dir output/${ENTITY} \
    --max_seq_length 128 \
    --num_train_epochs 3 \
    --per_device_train_batch_size 32 \
    --save_steps 1000 \
    --seed 1 \
    --do_train \
    --do_eval \
    --do_predict \
    --overwrite_output_dir

Please see each directory for different examples. Currently, we provide

Most examples are modifed from examples in Hugging Face transformers.

Citation

@article{10.1093/bioinformatics/btz682,
    author = {Lee, Jinhyuk and Yoon, Wonjin and Kim, Sungdong and Kim, Donghyeon and Kim, Sunkyu and So, Chan Ho and Kang, Jaewoo},
    title = "{BioBERT: a pre-trained biomedical language representation model for biomedical text mining}",
    journal = {Bioinformatics},
    year = {2019},
    month = {09},
    issn = {1367-4803},
    doi = {10.1093/bioinformatics/btz682},
    url = {https://doi.org/10.1093/bioinformatics/btz682},
}

License and Disclaimer

Please see the LICENSE file for details. Downloading data indicates your acceptance of our disclaimer.

Contact

For help or issues using BioBERT-PyTorch, please create an issue.