README.md

---
datasets:
- multimolecule/ucsc-genome-browser
language: rna
library_name: multimolecule
license: agpl-3.0
mask_token: <mask>
pipeline_tag: fill-mask
tags:
- Biology
- RNA
- ncRNA
widget:
- example_title: microRNA 21
  mask_index: 11
  mask_index_1based: 12
  masked_char: A
  output:
  - label: U
    score: 0.063517
  - label: W
    score: 0.058752
  - label: <null>
    score: 0.054666
  - label: A
    score: 0.054344
  - label: D
    score: 0.053223
  pipeline_tag: fill-mask
  sequence_type: ncRNA
  task: fill-mask
  text: UAGCUUAUCAG<mask>CUGAUGUUGA
- example_title: microRNA 146a
  mask_index: 10
  mask_index_1based: 11
  masked_char: A
  output:
  - label: U
    score: 0.055108
  - label: K
    score: 0.053975
  - label: G
    score: 0.052865
  - label: D
    score: 0.052671
  - label: W
    score: 0.052574
  pipeline_tag: fill-mask
  sequence_type: ncRNA
  task: fill-mask
  text: UGAGAACUGA<mask>UUCCAUGGGUU
- example_title: microRNA 155
  mask_index: 15
  mask_index_1based: 16
  masked_char: A
  output:
  - label: U
    score: 0.069799
  - label: K
    score: 0.063501
  - label: G
    score: 0.057772
  - label: D
    score: 0.055561
  - label: W
    score: 0.054487
  pipeline_tag: fill-mask
  sequence_type: ncRNA
  task: fill-mask
  text: UUAAUGCUAAUCGUG<mask>UAGGGGUU
- example_title: metastasis associated lung adenocarcinoma transcript 1
  mask_index: 12
  mask_index_1based: 13
  masked_char: A
  output:
  - label: A
    score: 0.098452
  - label: W
    score: 0.089672
  - label: U
    score: 0.081675
  - label: I
    score: 0.06182
  - label: <null>
    score: 0.059404
  pipeline_tag: fill-mask
  sequence_type: ncRNA
  task: fill-mask
  text: AGGCAUUGAGGC<mask>GCCAGCGCAGGGGCUUCUGCUGAGGGGGCAGGCGGAGCUUGAGGAAA
- example_title: Pvt1 oncogene
  mask_index: 17
  mask_index_1based: 18
  masked_char: A
  output:
  - label: C
    score: 0.102147
  - label: S
    score: 0.074025
  - label: Y
    score: 0.06499
  - label: B
    score: 0.060964
  - label: G
    score: 0.053646
  pipeline_tag: fill-mask
  sequence_type: ncRNA
  task: fill-mask
  text: CCCGCGCUCCUCCGGGC<mask>GAGCGCGUGUGGCGGCCGAGCACAUGGGCCCGCGGGCCGGGC
- example_title: telomerase RNA component
  mask_index: 23
  mask_index_1based: 24
  masked_char: A
  output:
  - label: U
    score: 0.089432
  - label: W
    score: 0.072939
  - label: A
    score: 0.059487
  - label: <null>
    score: 0.056283
  - label: D
    score: 0.055847
  pipeline_tag: fill-mask
  sequence_type: ncRNA
  task: fill-mask
  text: GGGUUGCGGAGGGUGGGCCUGGG<mask>GGGGUGGUGGCCAUUUUUUGUCUAACCCUAACUGAG
- example_title: vault RNA 2-1
  mask_index: 12
  mask_index_1based: 13
  masked_char: A
  output:
  - label: G
    score: 0.068816
  - label: K
    score: 0.068541
  - label: U
    score: 0.068266
  - label: B
    score: 0.059282
  - label: S
    score: 0.055244
  pipeline_tag: fill-mask
  sequence_type: ncRNA
  task: fill-mask
  text: CGGGUCGGAGUU<mask>GCUCAAGCGGUUACCUCCUCAUGCCGGACUUUCUAUCUGUCCAUCUCUGUGCUGGGGUUCGAGACCCGCGGGUGCUUACUGACCCUUUUAUGCAA
- example_title: brain cytoplasmic RNA 1
  mask_index: 18
  mask_index_1based: 19
  masked_char: A
  output:
  - label: A
    score: 0.495927
  - label: R
    score: 0.093128
  - label: M
    score: 0.057066
  - label: W
    score: 0.046572
  - label: V
    score: 0.038474
  pipeline_tag: fill-mask
  sequence_type: ncRNA
  task: fill-mask
  text: GGCCGGGCGCGGUGGCUC<mask>CGCCUGUAAUCCCAGCUCUCAGGGAGGCUAAGAGGCGGGAGGAUAGCUUGAGCCCAGGAGUUCGAGACCUGCCUGGGCAAUAUAGCGAGACCCCGUUCUCCAGAAAAAGGAAAAAAAAAAACAAAAGACAAAAAAAAAAUAAGCGUAACUUCCCUCAAAGCAACAACCCCCCCCCCCCUUU
- example_title: HIV-1 TAR-WT
  mask_index: 13
  mask_index_1based: 14
  masked_char: A
  output:
  - label: G
    score: 0.096668
  - label: R
    score: 0.095311
  - label: A
    score: 0.093973
  - label: D
    score: 0.078185
  - label: K
    score: 0.071315
  pipeline_tag: fill-mask
  sequence_type: ncRNA
  task: fill-mask
  text: GGUCUCUCUGGUU<mask>GACCAGAUCUGAGCCUGGGAGCUCUCUGGCUAACUAGGGAACC
---

# SpliceBERT

Pre-trained model on messenger RNA precursor (pre-mRNA) using a masked language modeling (MLM) objective.

## Disclaimer

This is an UNOFFICIAL implementation of the [Self-supervised learning on millions of pre-mRNA sequences improves sequence-based RNA splicing prediction](https://doi.org/10.1101/2023.01.31.526427) by Ken Chen, et al.

The OFFICIAL repository of SpliceBERT is at [chenkenbio/SpliceBERT](https://github.com/chenkenbio/SpliceBERT).

> [!TIP]
> The MultiMolecule team has confirmed that the provided model and checkpoints are producing the same intermediate representations as the original implementation.

**The team releasing SpliceBERT did not write this model card for this model so this model card has been written by the MultiMolecule team.**

## Model Details

SpliceBERT is a [bert](https://huggingface.co/google-bert/bert-base-uncased)-style model pre-trained on a large corpus of messenger RNA precursor sequences in a self-supervised fashion. This means that the model was trained on the raw nucleotides of RNA sequences only, with an automatic process to generate inputs and labels from those texts. Please refer to the [Training Details](#training-details) section for more information on the training process.

### Variants

- **[multimolecule/splicebert](https://huggingface.co/multimolecule/splicebert)**: The SpliceBERT model.
- **[multimolecule/splicebert.510](https://huggingface.co/multimolecule/splicebert.510)**: The intermediate SpliceBERT model.
- **[multimolecule/splicebert-human.510](https://huggingface.co/multimolecule/splicebert-human.510)**: The intermediate SpliceBERT model pre-trained on human data only.

### Model Specification

<table>
<thead>
  <tr>
    <th>Variants</th>
    <th>Num Layers</th>
    <th>Hidden Size</th>
    <th>Num Heads</th>
    <th>Intermediate Size</th>
    <th>Num Parameters (M)</th>
    <th>FLOPs (G)</th>
    <th>MACs (G)</th>
    <th>Max Num Tokens</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td>splicebert</td>
    <td rowspan="3">6</td>
    <td rowspan="3">512</td>
    <td rowspan="3">16</td>
    <td rowspan="3">2048</td>
    <td>19.72</td>
    <td rowspan="3">5.04</td>
    <td rowspan="3">2.52</td>
    <td>1024</td>
  </tr>
  <tr>
    <td>splicebert.510</td>
    <td rowspan="2">19.45</td>
    <td rowspan="2">510</td>
  </tr>
  <tr>
    <td>splicebert-human.510</td>
  </tr>
</tbody>
</table>

### Links

- **Code**: [multimolecule.splicebert](https://github.com/DLS5-Omics/multimolecule/tree/master/multimolecule/models/splicebert)
- **Data**: [UCSC Genome Browser](https://genome.ucsc.edu)
- **Paper**: [Self-supervised learning on millions of pre-mRNA sequences improves sequence-based RNA splicing prediction](https://doi.org/10.1101/2023.01.31.526427)
- **Developed by**: Ken Chen, Yue Zhou, Maolin Ding, Yu Wang, Zhixiang Ren, Yuedong Yang
- **Model type**: [BERT](https://huggingface.co/google-bert/bert-base-uncased) - [FlashAttention](https://huggingface.co/docs/text-generation-inference/en/conceptual/flash_attention)
- **Original Repository**: [chenkenbio/SpliceBERT](https://github.com/chenkenbio/SpliceBERT)

## Usage

The model file depends on the [`multimolecule`](https://multimolecule.danling.org) library. You can install it using pip:

```bash
pip install multimolecule
```

### Direct Use

#### Masked Language Modeling

You can use this model directly with a pipeline for masked language modeling:

```python
import multimolecule  # you must import multimolecule to register models
from transformers import pipeline

predictor = pipeline("fill-mask", model="multimolecule/splicebert")
output = predictor("gguc<mask>cucugguuagaccagaucugagccu")
```

### Downstream Use

#### Extract Features

Here is how to use this model to get the features of a given sequence in PyTorch:

```python
from multimolecule import RnaTokenizer, SpliceBertModel


tokenizer = RnaTokenizer.from_pretrained("multimolecule/splicebert")
model = SpliceBertModel.from_pretrained("multimolecule/splicebert")

text = "UAGCUUAUCAGACUGAUGUUG"
input = tokenizer(text, return_tensors="pt")

output = model(**input)
```

#### Sequence Classification / Regression

> [!NOTE]
> This model is not fine-tuned for any specific task. You will need to fine-tune the model on a downstream task to use it for sequence classification or regression.

Here is how to use this model as backbone to fine-tune for a sequence-level task in PyTorch:

```python
import torch
from multimolecule import RnaTokenizer, SpliceBertForSequencePrediction


tokenizer = RnaTokenizer.from_pretrained("multimolecule/splicebert")
model = SpliceBertForSequencePrediction.from_pretrained("multimolecule/splicebert")

text = "UAGCUUAUCAGACUGAUGUUG"
input = tokenizer(text, return_tensors="pt")
label = torch.tensor([1])

output = model(**input, labels=label)
```

#### Token Classification / Regression

> [!NOTE]
> This model is not fine-tuned for any specific task. You will need to fine-tune the model on a downstream task to use it for token classification or regression.

Here is how to use this model as backbone to fine-tune for a nucleotide-level task in PyTorch:

```python
import torch
from multimolecule import RnaTokenizer, SpliceBertForTokenPrediction


tokenizer = RnaTokenizer.from_pretrained("multimolecule/splicebert")
model = SpliceBertForTokenPrediction.from_pretrained("multimolecule/splicebert")

text = "UAGCUUAUCAGACUGAUGUUG"
input = tokenizer(text, return_tensors="pt")
label = torch.randint(2, (len(text), ))

output = model(**input, labels=label)
```

#### Contact Classification / Regression

> [!NOTE]
> This model is not fine-tuned for any specific task. You will need to fine-tune the model on a downstream task to use it for contact classification or regression.

Here is how to use this model as backbone to fine-tune for a contact-level task in PyTorch:

```python
import torch
from multimolecule import RnaTokenizer, SpliceBertForContactPrediction


tokenizer = RnaTokenizer.from_pretrained("multimolecule/splicebert")
model = SpliceBertForContactPrediction.from_pretrained("multimolecule/splicebert")

text = "UAGCUUAUCAGACUGAUGUUG"
input = tokenizer(text, return_tensors="pt")
label = torch.randint(2, (len(text), len(text)))

output = model(**input, labels=label)
```

## Training Details

SpliceBERT used Masked Language Modeling (MLM) as the pre-training objective: taking a sequence, the model randomly masks 15% of the tokens in the input then runs the entire masked sentence through the model and has to predict the masked tokens. This is comparable to the Cloze task in language modeling.

### Training Data

The SpliceBERT model was pre-trained on messenger RNA precursor sequences from [UCSC Genome Browser](https://genome.ucsc.edu).
UCSC Genome Browser provides visualization, analysis, and download of comprehensive vertebrate genome data with aligned annotation tracks (known genes, predicted genes, ESTs, mRNAs, CpG islands, etc.).

SpliceBERT collected reference genomes and gene annotations from the UCSC Genome Browser for 72 vertebrate species. It applied [bedtools getfasta](https://bedtools.readthedocs.io/en/latest/content/tools/getfasta.html) to extract pre-mRNA sequences from the reference genomes based on the gene annotations. The pre-mRNA sequences are then used to pre-train SpliceBERT. The pre-training data contains 2 million pre-mRNA sequences with a total length of 65 billion nucleotides.

Note [`RnaTokenizer`][multimolecule.RnaTokenizer] will convert "T"s to "U"s for you, you may disable this behaviour by passing `replace_T_with_U=False`.

### Training Procedure

#### Preprocessing

SpliceBERT used masked language modeling (MLM) as the pre-training objective. The masking procedure is similar to the one used in BERT:

- 15% of the tokens are masked.
- In 80% of the cases, the masked tokens are replaced by `<mask>`.
- In 10% of the cases, the masked tokens are replaced by a random token (different) from the one they replace.
- In the 10% remaining cases, the masked tokens are left as is.

#### Pre-training

The model was trained on 8 NVIDIA V100 GPUs.

- Optimizer: AdamW
- Learning rate: 1e-4
- Learning rate scheduler: ReduceLROnPlateau(patience=3)

SpliceBERT trained model in a two-stage training process:

1. Pre-train with sequences of a fixed length of 510 nucleotides.
2. Pre-train with sequences of a variable length between 64 and 1024 nucleotides.

The intermediate model after the first stage is available as `multimolecule/splicebert.510`.

SpliceBERT also pre-trained a model on human data only to validate the contribution of multi-species pre-training. The intermediate model after the first stage is available as `multimolecule/splicebert-human.510`.

## Citation

```bibtex
@article {chen2023self,
	author = {Chen, Ken and Zhou, Yue and Ding, Maolin and Wang, Yu and Ren, Zhixiang and Yang, Yuedong},
	title = {Self-supervised learning on millions of pre-mRNA sequences improves sequence-based RNA splicing prediction},
	elocation-id = {2023.01.31.526427},
	year = {2023},
	doi = {10.1101/2023.01.31.526427},
	publisher = {Cold Spring Harbor Laboratory},
	abstract = {RNA splicing is an important post-transcriptional process of gene expression in eukaryotic cells. Predicting RNA splicing from primary sequences can facilitate the interpretation of genomic variants. In this study, we developed a novel self-supervised pre-trained language model, SpliceBERT, to improve sequence-based RNA splicing prediction. Pre-training on pre-mRNA sequences from vertebrates enables SpliceBERT to capture evolutionary conservation information and characterize the unique property of splice sites. SpliceBERT also improves zero-shot prediction of variant effects on splicing by considering sequence context information, and achieves superior performance for predicting branchpoint in the human genome and splice sites across species. Our study highlighted the importance of pre-training genomic language models on a diverse range of species and suggested that pre-trained language models were promising for deciphering the sequence logic of RNA splicing.Competing Interest StatementThe authors have declared no competing interest.},
	URL = {https://www.biorxiv.org/content/early/2023/05/09/2023.01.31.526427},
	eprint = {https://www.biorxiv.org/content/early/2023/05/09/2023.01.31.526427.full.pdf},
	journal = {bioRxiv}
}
```

> [!NOTE]
> The artifacts distributed in this repository are part of the MultiMolecule project.
> If you use MultiMolecule in your research, you must cite the MultiMolecule project as follows:

```bibtex
@software{chen_2024_12638419,
  author    = {Chen, Zhiyuan and Zhu, Sophia Y.},
  title     = {MultiMolecule},
  doi       = {10.5281/zenodo.12638419},
  publisher = {Zenodo},
  url       = {https://doi.org/10.5281/zenodo.12638419},
  year      = 2024,
  month     = may,
  day       = 4
}
```

## Contact

Please use GitHub issues of [MultiMolecule](https://github.com/DLS5-Omics/multimolecule/issues) for any questions or comments on the model card.

Please contact the authors of the [SpliceBERT paper](https://doi.org/10.1101/2023.01.31.526427) for questions or comments on the paper/model.

## License

This model is licensed under the [GNU Affero General Public License](license.md).

For additional terms and clarifications, please refer to our [License FAQ](license-faq.md).

```spdx
SPDX-License-Identifier: AGPL-3.0-or-later
```