| Linux | Mac OSX | Windows | Unit tests |
|---|---|---|---|
PLAST stands for Parallel Local Sequence Alignment Search Tool and is was published in BMC Bioinformatics, 2009.
PLAST is a fast, accurate and NGS scalable bank-to-bank sequence similarity search tool providing significant accelerations of seeds-based heuristic comparison methods, such as the Blast suite of algorithms.
Relying on unique software architecture, PLAST takes full advantage of recent multi-core personal computers without requiring any additional hardware devices.
PLAST is a general purpose sequence comparison tool providing the following benefits:
- PLAST is a high-performance sequence comparison tool designed to compare two sets of sequences (query vs. reference),
- Reduces the processing time of sequences comparisons while providing highest quality results; i.e. PLAST is faster than BLAST and provides its quality,
- Contains a fully integrated data filtering engine capable of selecting relevant hits with user-defined criteria (E-Value, identity, coverage, alignment length, etc.),
- Does not require any additional hardware, since it is a software solution. It is easy to install, cost-effective, takes full advantage of multi-core processors and uses a small RAM footprint,
- Ready to be used on desktop computer, cluster, cloud as well as within distributed system running Hadoop.
PLAST Library is written in c++/11 and provides all the needed software components required for comparing two sequence databases with the PLAST algorithm.
As a library, it should not contain any 'main' function. However, to simplify the use of the library as a command-line tool the library provides:
- an API to setup new softwares relying on PLAST;
- a main class (tools::PlastCmd.cpp) to directly provide a ready-to-use PLAST command-line tool.
PLAST project resides at two locations:
- Inria Forge: the official git repository
- Github: this is a mirror of the Inria Forge repository
The Github repository is auto-updated from Inria GForge. So all commits have to be done by authorized users/developers on the Inria Forge. Otherwise, consider using "Github/pull request" for any update to be done on PLAST.
Use stable release: we always advise you to use the stable release of the software; we consider the master branch as a development branch, so it could be unstable. Recommended procedure:
git clone ...
git checkout stable
- C++/11 source code ('src' directory);
- CMake file to compile the project on various 64bit OS, such as Linux, MacOSX and Windows;
- API documentation ('doc' directory);
- sample code snippets illustrating the use of the API ('examples' directory);
- sample Fasta files to test the software ('test/db' directory);
The PLAST library can be compiled in a terminal with the CMake tool.
Requirements:
-
Hardware: Intel/AMD 64bit processor provising SSE2+ instructions set
-
Linux: kernel 2.6+ ; gcc 4.4+ ; cmake 2.8+
-
MacOS: OS 10.9+ ; cmake 2.8+ ; XCode and its command-line development tools (clang)
-
Windows: Seven+ ; cmake 2.8+ ; MinGW-64 environment (since gcc is required to compile PLAST)
Be aware that the more recent OS version you use, the more faster PLAST will be. Same for gcc/clang.
Once the source has been retrieved, one just has to do:
Linux:
cd plast-library
git checkout stable #see comment [1] below
mkdir build ; cd build ; cmake .. ; make -j8
MacOS:
cd plast-library
git checkout stable #see comment [1] below
set CC=gcc
set CXX=g++
mkdir build ; cd build ; cmake .. ; make -j8
Windows (use MinGW-MSYS to run a real Unix shell):
cd plast-library
git checkout stable #see comment [1] below
mkdir build ; cd build ; cmake -G "MSYS Makefiles" .. ; make -j8
As a result of source code compilation, one should get a dynamic library (in 'build/lib' directory) and a command-line tool (in 'build/bin' directory).
PlastCmd is a self-contained command-line tool: you can move it anywhere you want, even renaming it; for instance, the PLAST team from Inria provide pre-compiled PLAST binary renamed as 'plast'.
Comment [1] - We ALWAYS advise you to compile PLAST from its stable release:
-
Github users: after the "git clone", you should run "git checkout stable" before compiling the code. Indeed, compiling PLAST from the master branch is done at your own risk, since this is the development branch of PLAST. As a result, the software may be unstable. This is the reason why PLAST is always tagged with "stable", a tag corresponding to the latest available stable release.
-
"tar.gz" users: if you retrieve PLAST from its stable archive from PLAST web site, you do not have to run 'git checkout stable', since we provide you with a stable archive.
cd plast-library/build/bin
./PlastCmd -p plastp \
-i ../../test/db/query.fa \
-d ../../test/db/tursiops.fa \
-o result.txt
- -p: the comparison method
- -i: the query
- -d: the reference databank (can be a Fasta file or a Blast databank)
- -o: the result file
More options: see documentation...
To get PlastCmd inline help:
./PlastCmd -h
PLAST user documentation is here.
Developers can see how to use the PLAST c++ API through snippets provided with this project.
Snippets compilation is done as follows:
cd plast-library/build
make examples
Snippet binaries will be located in 'build/bin'.
Snippets documentation: http://plast.gforge.inria.fr/docs/cpp/snippets_page.html
This documentation is available at http://plast.gforge.inria.fr/docs/cpp/.
However, you can prepare a local documentation as follows (we suppose you already have compiled PLAST binary, see above):
cd plast-library/build
make doc-api
See http://plast.gforge.inria.fr/docs/cpp/.
Please, visit PLAST web site for more information and contact (questions regarding the use of PLAST, bug report, feature request, etc.).
PLAST is free software; you can redistribute it and/or modify it under the Affero GPL v3 license. See http://www.gnu.org/licenses/agpl-3.0.en.html