The Alakazam package


alakazam in a member of the Immcantation framework of tools and serves five main purposes:

  • Providing core functionality for other R packages in Immcantation. This includes common tasks such as file I/O, basic DNA sequence manipulation, and interacting with V(D)J segment and gene annotations.
  • Providing an R interface for interacting with the output of the pRESTO and Change-O tool suites.
  • Performing clonal abundance and diversity analysis on lymphocyte repertoires.
  • Performing lineage reconstruction on clonal populations of immunoglobulin (Ig) sequences.
  • Performing physicochemical property analyses of lymphocyte receptor sequences.

For additional details regarding the use of the alakazam package see the vignettes: browseVignettes("alakazam")

File I/O

Sequence cleaning

Lineage reconstruction

Lineage topology analysis

  • tableEdges: Tabulate annotation relationships over edges.
  • testEdges: Significance testing of annotation edges.
  • testMRCA: Significance testing of MRCA annotations.
  • summarizeSubtrees: Various summary statistics for subtrees.
  • plotSubtrees: Plot distributions of summary statistics for a population of trees.

Diversity analysis

Ig and TCR sequence annotation

Sequence distance calculation

  • seqDist: Calculate Hamming distance between two sequences.
  • seqEqual: Test two sequences for equivalence.
  • pairwiseDist: Calculate a matrix of pairwise Hamming distances for a set of sequences.
  • pairwiseEqual: Calculate a logical matrix of pairwise equivalence for a set of sequences.

Amino acid propertes


  1. Vander Heiden JA, Yaari G, et al. pRESTO: a toolkit for processing high-throughput sequencing raw reads of lymphocyte receptor repertoires. Bioinformatics. 2014 30(13):1930-2.
  2. Stern JNH, Yaari G, Vander Heiden JA, et al. B cells populating the multiple sclerosis brain mature in the draining cervical lymph nodes. Sci Transl Med. 2014 6(248):248ra107.
  3. Wu Y-CB, et al. Influence of seasonal exposure to grass pollen on local and peripheral blood IgE repertoires in patients with allergic rhinitis. J Allergy Clin Immunol. 2014 134(3):604-12.
  4. Gupta NT, Vander Heiden JA, et al. Change-O: a toolkit for analyzing large-scale B cell immunoglobulin repertoire sequencing data. Bioinformatics. 2015 Oct 15;31(20):3356-8.