bigscience-workshop / biomedical

Tools for curating biomedical training data for large-scale language modeling
438 stars 111 forks source link

BigBIO: Biomedical Dataset Library

BigBIO (BigScience Biomedical) is an open library of biomedical dataloaders built using Huggingface's (πŸ€—) datasets library for data-centric machine learning.

Our goals include:

Currently BigBIO provides support for:

How to Use BigBIO

The preferred way to use these datasets is to access them from the Official BigBIO Hub.

Minimally, ensure you have the datasets library installed. Preferably, install the requirements as follows:

pip install -r requirements.txt.


You can access BigBIO datasets as follows:

from datasets import load_dataset
data = load_dataset("bigbio/biosses")

In most cases, scripts load the original schema of the dataset by default. You can also access the BigBIO split that streamlines access to key information in datasets given a particular task.


For example, the biosses dataset follows a pairs based schema, where text-based inputs (sentences, paragraphs) are assigned a "translated" pair.

from datasets import load_dataset
data = load_dataset("bigbio/biosses", name="biosses_bigbio_pairs")

Generally, you can load your datasets as follows:

# Load original schema
data = load_dataset("bigbio/<your_dataset>")

# Load BigBIO schema
data = load_dataset("bigbio/<your_dataset_here>", name="<your_dataset>_bigbio_<schema_name>")

Check the datacards on the Hub to see what splits are available to you. You can find more information about schemas in Documentation below.

Benchmark Support

BigBIO includes support for almost all datasets included in other popular English biomedical benchmarks.

Task Type Dataset BigBIO (ours) BLUE BLURB BoX DUA needed
NER BC2GM βœ“ βœ“ βœ“
NER BC5-chem βœ“ βœ“ βœ“ βœ“
NER BC5-disease βœ“ βœ“ βœ“ βœ“
NER EBM PICO βœ“ βœ“
NER JNLPBA βœ“ βœ“ βœ“
NER NCBI-disease βœ“ βœ“ βœ“
RE ChemProt βœ“ βœ“ βœ“ βœ“
RE DDI βœ“ βœ“ βœ“ βœ“
RE GAD βœ“ βœ“
QA PubMedQA βœ“ βœ“ βœ“
QA BioASQ βœ“ βœ“ βœ“ βœ“
DC HoC βœ“ βœ“ βœ“ βœ“
STS BIOSSES βœ“ βœ“ βœ“
STS MedSTS * βœ“ βœ“
NER n2c2 2010 βœ“ βœ“ βœ“ βœ“
NER ShARe/CLEF 2013 * βœ“ βœ“
NLI MedNLI βœ“ βœ“ βœ“
NER n2c2 deid 2006 βœ“ βœ“ βœ“
DC n2c2 RFHD 2014 βœ“ βœ“ βœ“
NER AnatEM βœ“ βœ“
NER BC4CHEMD βœ“ βœ“
NER BioNLP09 βœ“ βœ“
NER BioNLP11EPI βœ“ βœ“
NER BioNLP11ID βœ“ βœ“
NER BioNLP13CG βœ“ βœ“
NER BioNLP13GE βœ“ βœ“
NER BioNLP13PC βœ“ βœ“
NER CRAFT * βœ“
NER Ex-PTM βœ“ βœ“
NER Linnaeus βœ“ βœ“
POS GENIA * βœ“
SA Medical Drugs βœ“ βœ“
SR COVID private
SR Cooking private
SR HRT private
SR Accelerometer private
SR Acromegaly private

* denotes dataset implementation in-progress

Documentation

Tutorials

TBA - Links may not be applicable yet!

Contributing

BigBIO is an open source project - your involvement is warmly welcome! If you're excited to join us, we recommend the following steps:

Currently, only admins will be merging all accepted changes to the Hub.

Feel free to join our Discord!

Citing

If you use BigBIO in your work, please cite

@article{fries2022bigbio,
    title = {
        BigBIO: A Framework for Data-Centric Biomedical Natural Language
        Processing
    },
    author = {
        Fries, Jason Alan and Weber, Leon and Seelam, Natasha and Altay,
        Gabriel and Datta, Debajyoti and Garda, Samuele and Kang, Myungsun
        and Su, Ruisi and Kusa, Wojciech and Cahyawijaya, Samuel and others
    },
    journal = {arXiv preprint arXiv:2206.15076},
    year = 2022
}

Acknowledgements

BigBIO is a open source, community effort made possible through the efforts of many volunteers as part of BigScience and the Biomedical Hackathon.