Code Monkey home page Code Monkey logo

sambamba's Introduction

Sambamba

Sambamba is a high performance modern robust and fast tool (and library), written in the D programming language, for working with SAM and BAM files. Current parallelised functionality is an important subset of samtools functionality, including view, index, sort, markdup, and depth.

Because of efficient use of modern multicore CPUs, usually sambamba is much faster than samtools. For example, indexing a 2.5 Gb BAM file (fully cached into RAM) on a 8 core machine utilizes all cores at 64% CPU:

time sambamba index merged_NIT20120138_F3_20130715.bam -t8

  real    0m17.398s
  user    1m25.841s
  sys     0m3.752s

meanwhile samtools is 4x slower:

time samtools index merged_NIT20120138_F3_20130715.bam

  real    1m8.083s
  user    1m6.640s
  sys     0m1.448s

In practice, the speedup is usually smaller since I/O becomes a bottleneck. Even so, it makes a big difference, shifting the focus to I/O optimization, i.e. less temporary files, more UNIX pipes, faster disk storage, tweaking filesystem, etc. Most tools in sambamba support piping: just specify /dev/stdin or /dev/stdout as filenames.

Notice that samtools implements parallel BAM compression in sort and merge, but sambamba should be faster for these tasks (given same amount of memory) due to more cache-friendly approach to parallelization. If it is not the case for you, please file a bug.

Sambamba is free and open source software, licensed under GPLv2+. See manual pages online to know more about what is available and how to use it.

For more information on Sambamba you can contact Artem Tarasov and Pjotr Prins.

Binaries

See Github releases

Compiling Sambamba

The preferred method for compiling Sambamba is with the LDC compiler which targets LLVM.

Compiling for Mac OS X

(The Dropbox archive differs from the official LDC release in that it also contains rdmd executable from DMD distribution.)

wget https://dl.dropboxusercontent.com/u/7916095/ldc2-0.13.0-osx-x86_64.tar.bz2
tar xjf ldc2-0.13.0-osx-x86_64.tar.bz2
git clone --recursive https://github.com/lomereiter/sambamba.git
cd sambamba
export PATH=../ldc2-0.13.0-osx-x86_64/bin:$PATH
make sambamba-ldmd2-64

Compiling for Linux using Docker

Use the Docker image which contains all binaries necessary for compilation:

docker pull lomereiter/centos-ldc
docker run -i -t lomereiter/centos-ldc /bin/bash
$ git clone --recursive https://github.com/lomereiter/sambamba.git
$ cd sambamba && make sambamba-ldmd2-64
$ ^D
docker cp `docker ps -l -q`:/sambamba/build/sambamba /usr/local/bin/

Development

Sambamba development and issue tracker is on github. Developer documentation can be found in the source code and the development documentation.

Copyright

Sambamba is distributed under GNU Public License v2+.

sambamba's People

Contributors

csw avatar lomereiter avatar pjotrp avatar rernst avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.