For more information contact us at


If you use BreakSeq2 in your work, please cite the following:
Alexej Abyzov, Shantao Li, Daniel Rhee Kim, Marghoob Mohiyuddin, Adrian M. St├╝tz, Nicholas F. Parrish, Xinmeng Jasmine Mu, Wyatt Clark, Ken Chen, Matthew Hurles, Jan O. Korbel, Hugo Y. K. Lam, Charles Lee and Mark B. Gerstein
Analysis of deletion breakpoints from 1,092 humans reveals details of mutation mechanisms
Nature CommunicationsBioinformatics published June 1, 2015

Download BreakSeq2

Latest version:

For other versions, see "releases".

System Requirements

The following Python packages must be installed:

In addition, paths to the following tools must be provided as BreakSeq2 arguments:

Installing BreakSeq2

BreakSeq2 is a python package and can be installed using pip. To install type pip install The current version of BreakSeq2 is 2.2. In general, the install source would be

Running BreakSeq2

The following is the list of required options for BreakSeq2

Below are some examples of running BreakSeq2

Running with breakpoint library as GFF --reference b37.fasta --bams bwamem.bam --work work --bwa bwa-0.7.12/bwa --samtools samtools-0.1.19/samtools --bplib_gff bplib.gff --nthreads 4 --sample NA12878

Note that the sample name is not a required option. If it is missing, then the unique sample name is inferred from the BAMs. If there is no unique sample name and none is specified on the command-line, BreakSeq2 will fail. In the above example, since the breakpoint library was specified as a GFF, the insertion sequence file bplib.ins must also be present. BreakSeq2 will use the directory work for all the intermediate as well as the final output. Internally, BreakSeq2 uses the breakpoint library in FASTA format, so the conversion from GFF to FASTA is done before the actual processing. BreakSeq2 uses parallelism whenever possible for best performance-in this case, 4 threads will be used for some steps of the processing.

Running with breakpoint library as FASTA --reference b37.fasta --bams bwamem.bam --work work --bwa bwa-0.7.12/bwa --samtools samtools-0.1.19/samtools --bplib bplib.fa --nthreads 4

Note that since the breakpoint library was specified as a FASTA file, bplib.ins is not required here since the insertion sequences are already accounted for in the FASTA.

In general, type -h for a list of all command-line options.