Serghei Mangul edited this page Nov 19, 2017 · 39 revisions


Quick Start

ImReP is a method for rapid and accurate profiling of the adaptive immune repertoires from regular RNA-Seq data

Download ImReP using

git clone

Install ImReP from the base directory

cd imrep

Run ImReP analysis by a single command for the BAM file with mapped and unmapped reads (preferred). BAM file needs to be indexed (.bai file). Forgot to save unmapped reads, we got you covered. Learn more here

python --bam example/toyExample.bam example/toyExample.cdr3

Find ImReP analysis in toyExample directory. Learn more here

ImReP Tutorial

Use the sidebar on the right to navigate ImReP tutorial. Get started with a toy example of 200 RNA-Seq reads (example/toyExample.bam) distributed with ImRep package

What is ImReP

ImReP is a method to quantify individual immune response based on a recombination landscape of genes encoding B and T cell receptors (BCR and TCR). ImReP is able to efficiently extract TCR and BCR reads from the RNA-Seq data and assemble clonotypes (defined as clones with identical CDR3 amino acid sequences) and detect corresponding V(D)J recombinations. Using CAST clustering technique, ImReP is able to correct assembled clonotypes for PCR and sequencing errors.


Mangul, Serghei, et al. "Profiling adaptive immune repertoires across multiple human tissues by RNA Sequencing" bioRxiv (2016): 089235.


Slides from my talk at ISMB 2017 (HiTSeq 2017) are available here

The Atlas of Immune Repertoires (TheAIR)

Using ImReP we have created the Atlas of Immunoglobilin Repertoires (TheAIR). The AIR is a collection of CDR3 from Immunoglobulin (Ig) receptor repetoires. CDR3s are assembled from 8,555 human RNA-seq samples across 544 individuals from 53 tissues from the Genotype-Tissue Expression (GTEx v6) project using ImReP.The AIR has one of the largest collection of CDR3 sequences (n=3.6 million) and tissue types (n=53). TheAIR is freely available at :


This software was developed by Igor Mandric and Serghei Mangul. Please do not hesitate to contact us (, if you have any comments, suggestions, or clarification requests regarding the tutorial or if you would like to contribute to this resource.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.