Spoa

Spoa (SIMD POA) is a c++ implementation of the partial order alignment (POA) algorithm (as described in 10.1093/bioinformatics/18.3.452) which is used to generate consensus sequences (as described in 10.1093/bioinformatics/btg109). It supports three alignment modes: local (Smith-Waterman), global (Needleman-Wunsch) and semi-global alignment (overlap), and three gap modes: linear, affine and convex (piecewise affine). It supports Intel SSE4.1+ and AVX2 vectorization (marginally faster due to high latency shifts).

Dependencies

Linux

Application uses following software:

gcc 4.8+ or clang 3.4+
cmake 3.2+

Installation

CmakeLists is provided in the project root folder. By running the following commands:

git clone --recursive https://github.com/rvaser/spoa spoa
cd spoa
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make

a library named libspoa.a will appear in the build/lib directory.

Various options can be enabled while running cmake:

spoa_optimize_for_native: builds with -march=native
spoa_optimize_for_portability: builds with -msse4.1
spoa_use_simde: builds with SIMDe for porting vectorized code
spoa_use_simde_nonvec: uses SIMDe library for nonvectorized code
spoa_use_simde_openmp: uses SIMDe support for OpenMP SIMD
spoa_generate_dispatch: uses SIMDe to generate x86 dispatch

If you want the spoa executable, run the following two commands:

cmake -DCMAKE_BUILD_TYPE=Release -Dspoa_build_executable=ON ..
make

which will place an executable named spoa in build/bin directory.

Optionally, you can run sudo make install to install spoa library (and executable) to your machine.

Note: if you omitted --recursive from git clone, run git submodule init and git submodule update before proceeding with compilation.

To build unit tests add -Dspoa_build_tests=ON while running cmake. After installation, an executable named spoa_test will be created in build/bin.

Usage

Usage of spoa is as following:

spoa [options ...] <sequences>

    <sequences>
        input file in FASTA/FASTQ format (can be compressed with gzip)
        containing sequences

    options:
        -m <int>
            default: 5
            score for matching bases
        -n <int>
            default: -4
            score for mismatching bases
        -g <int>
            default: -8
            gap opening penalty (must be non-positive)
        -e <int>
            default: -6
            gap extension penalty (must be non-positive)
        -q <int>
            default: -10
            gap opening penalty of the second affine function
            (must be non-positive)
        -c <int>
            default: -4
            gap extension penalty of the second affine function
            (must be non-positive)
        -l, --algorithm <int>
            default: 0
            alignment mode:
                0 - local (Smith-Waterman)
                1 - global (Needleman-Wunsch)
                2 - semi-global
        -r, --result <int>
            default: 0
            result mode:
                0 - consensus
                1 - multiple sequence alignment
                2 - 0 & 1
        -G, --gfa
            write GFA on stdout
        -C, --gfa-with-consensus
            write GFA with consensus on stdout
        -d, --dot <file>
            output file for the final POA graph in DOT format
        --version
            prints the version number
        -h, --help
            prints the usage

    gap mode:
        linear if g >= e
        affine if g <= q or e >= c
        convex otherwise (default)

Library

Simple library usage can be seen in the following example.cpp file. This code shows how to get consensus and multiple sequence alignment for a set of sequences without quality values.

#include "spoa/spoa.hpp"

int main(int argc, char** argv) {

    std::vector<std::string> sequences = {
        "CATAAAAGAACGTAGGTCGCCCGTCCGTAACCTGTCGGATCACCGGAAAGGACCCGTAAAGTGATAATGAT",
        "ATAAAGGCAGTCGCTCTGTAAGCTGTCGATTCACCGGAAAGATGGCGTTACCACGTAAAGTGATAATGATTAT",
        "ATCAAAGAACGTGTAGCCTGTCCGTAATCTAGCGCATTTCACACGAGACCCGCGTAATGGG",
        "CGTAAATAGGTAATGATTATCATTACATATCACAACTAGGGCCGTATTAATCATGATATCATCA",
        "GTCGCTAGAGGCATCGTGAGTCGCTTCCGTACCGCAAGGATGACGAGTCACTTAAAGTGATAAT",
        "CCGTAACCTTCATCGGATCACCGGAAAGGACCCGTAAATAGACCTGATTATCATCTACAT"
    };

    auto alignment_engine = spoa::createAlignmentEngine(static_cast<spoa::AlignmentType>(atoi(argv[1])),
        atoi(argv[2]), atoi(argv[3]), atoi(argv[4]), atoi(argv[5]));

    auto graph = spoa::createGraph();

    for (const auto& it: sequences) {
        auto alignment = alignment_engine->align(it, graph);
        graph->add_alignment(alignment, it);
    }

    std::string consensus = graph->generate_consensus();

    fprintf(stderr, "Consensus (%zu)\n", consensus.size());
    fprintf(stderr, "%s\n", consensus.c_str());

    std::vector<std::string> msa;
    graph->generate_multiple_sequence_alignment(msa);

    fprintf(stderr, "Multiple sequence alignment\n");
    for (const auto& it: msa) {
        fprintf(stderr, "%s\n", it.c_str());
    }

    return 0;
}

This code can be compiled from spoa root directory with:

g++ example.cpp -std=c++11 -Iinclude/ -Lbuild/lib/ -lspoa -o example

or with the following command if spoa was installed beforehand:

g++ example.cpp -std=c++11 -lspoa -o example

The executable can be run with:

./example 0 5 -4 -8 -6

On the other hand, if you are using cmake you can add spoa to your project by adding commands add_subdirectory(vendor/spoa EXCLUDE_FROM_ALL) and target_link_libraries(your_exe spoa) to your main CMakeLists file.

Contact information

For additional information, help and bug reports please send an email to: robert.vaser@fer.hr, mile.sikic@fer.hr.

Acknowledgement

This work has been supported in part by Croatian Science Foundation under the project UIP-11-2013-7353.

arun-sub/spoa