Groovy Java R Shell
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
doc docs foc segm2fam Aug 16, 2018
src Main upd Aug 16, 2018
.gitignore gitignore upd Jan 6, 2015
.travis.yml cleanup Apr 2, 2018
LICENSE license upd Aug 16, 2018 fix doc link Jul 10, 2018
pom.xml Version upd Aug 16, 2018 Convert segments to families function Aug 16, 2018
vdjdb.test.txt Convert segments to families function Aug 16, 2018
vdjtools Version upd Aug 16, 2018

Build Status JitPack


A comprehensive analysis framework for T-cell and B-cell repertoire sequencing data. Compiled binaries are available from here. You can download them and execute as

java -jar vdjtools.jar ...

Make sure that you've specified the full/correct path to jar file. In case of Java Heap Space exception, you can increase the JVM memory limit by adding -Xmx20G (for extra 20G) after the -jar argument.

The software is cross-platform and requires Java v1.8+ to run and R to perform plotting.

Easy installation on MacOS/Linux via Homebrew or Linuxbrew:

brew tap homebrew/science
brew tap mikessh/repseq
brew install vdjtools
vdjtools CalcBasicStats ...

See homebrew-repseq for other RepSeq analysis software Homebrew installers.

List of features and detailed documentation can be found at ReadTheDocs.

Example datasets and shell scripts are provided in a separate repository.

Please cite VDJtools as:

Shugay M et al. VDJtools: Unifying Post-analysis of T Cell Receptor Repertoires. PLoS Comp Biol 2015; 11(11):e1004503-e1004503.

Some recent publications where VDJtools was used: