pMTnet Omni: pan-MHC and cross-Species Prediction of T Cell Receptor-Antigen Binding

pMTnet Omni is a deep learning algorithm for affinity prediction based on TCR Va, Vb, CDR3a, CDR3b sequences, peptide sequence, and MHC allele types. The predictions can be made for human and mouse alleles, and for both CD8 T cells/MHC class I and CD4 T cells/MHC class II.

Here is a quick overview of the structure of the model:

For a more detailed exploration of our model, please refer to our paper:

@article {Han2023.12.01.569599,
     author = {Yi Han and Yuqiu Yang and Yanhua Tian and Farjana J. Fattah and Mitchell S. von Itzstein and Minying Zhang and Xiongbin Kang and Donghan M. Yang and Jialiang Liu and Yaming Xue and Chaoying Liang and Indu Raman and Chengsong Zhu and Olivia Xiao and Yifei Hu and Jonathan E. Dowell and Jade Homsi and Sawsan Rashdan and Shengjie Yang and Mary E. Gwin and David Hsiehchen and Yvonne Gloria-McCutchen and Ke Pan and Fangjiang Wu and Don Gibbons and Xinlei Wang and Cassian Yee and Junzhou Huang and Alexandre Reuben and Chao Cheng and Jianjun Zhang and David E. Gerber and Tao Wang},
     title = {pan-MHC and cross-Species Prediction of T Cell Receptor-Antigen Binding},
     elocation-id = {2023.12.01.569599},
     year = {2023},
     doi = {10.1101/2023.12.01.569599},
     publisher = {Cold Spring Harbor Laboratory},
     URL = {https://www.biorxiv.org/content/early/2023/12/12/2023.12.01.569599},
     eprint = {https://www.biorxiv.org/content/early/2023/12/12/2023.12.01.569599.full.pdf},
     journal = {bioRxiv}
}

DBAI

To try out pMTnet Omni, we recommend our online tool hosted on DBAI where you can upload your own dataset and we will crunch the numbers for you.

Note

Just upload the data that conforms with our input requirements to our server and it will curate the data and crunch the numbers for you. No need to use pMTnet_Omni_Document for curation.

DIY

This documentation, however, could be helpful for you to make sure that the input format conforms with our software. Just remember to upload the original data onto the server and not the pMTnet_Omni_Document curated data.

Input Format: A series of detailed explanations as well as functions will be provided to help you organize your dataset so that the input can be correctly recognized by pMTnet Omni.
Input Parameters: pMTnet Omni can be configured in a various ways to suit your own need. We will walk through the parameters you can use to alter the behaviors of our algorithm.

Dependencies

The dependencies of pMTnet Omni Document is fairly standard for a deep learning-based application

Dependencies
Package	Version
python	`>=3.9,<3.11`
numpy	`==1.22.4`
pandas	`==1.5.2`
tqdm	`==4.64.1`
torch	`==1.13.1`
fair-esm	`==2.0.0`

Installation

Note

We highly recommend creating a virtual environment before proceeding to installing the package. For how to manage virtual environment via conda, check out their tutorial.

pip install pMTnet_Omni_Document

To quickly test if it has been installed:

python -m pMTnet_Omni_Document --version

User Guide / Tutorial

Get Started

Quick Start Guide

Input Format

Input File Format

Detailed Tutorials

API Reference

API Reference