Raw File
Tip revision: 40119043878d212d67385e23d0cfe1e27e99ca87 authored by fenderglass on 08 August 2014, 06:20:32 UTC
version 1.0
Tip revision: 4011904
Installation instructions for Ragout

Ragout was tested under Mac OS and Linux. While it should work
under Windows, we currently do not provide an official support.

Build requirements
* C++ compiler with C++0x support (GCC 4.6+ / Clang 3.2+ / Apple Clang 4.2+)
* GNU make / Cmake (for building Sibelia)

Runtime depenencies

* Python 2.7
* Sibelia [] or Progresssive Cactus []

Binary distribution

While we recommend to build Ragout from source on each machine, you also can
use pre-compiled binaries which are available for Linux and Mac OS from 
Releases page on Github:

In this case, you do not need any installation procedures. If you are unsure,
which version (binary or source) you have downloaded, you can check for
binary files in "lib" directory. If they exist - you have obtained a binary
version, otherwise it is source.


1. To build Ragout native modules, type:

2. To build and install Sibelia, use:

        python scripts/

If you already have Sibelia installed, you can skip second step.

After this, you can test your installation by running:

    python --help

If no errors occured, installation was successful and you can start using Ragout!


Ragout can use both Sibelia and Progressive Cactus for synteny block decomposition.
Cactus support is still in early stage, however you already can try it with genomes,
that are too big for Sibelia.

First, download and build Progressive Cactus:
Then set "CACTUS_INSTALL" environment variable pointing to Cactus installation directory:

    export CACTUS_INSTALL=path_to_cactus


Q: Tons of errors during compilation, possibly with 
"unrecognized command line option '-std=c++0x'" message:

A: Probably your compiler is too old and does not support C++0x. Minimum
versions of GCC and Clang are mentioned at the beginnig of this documtent.

Q: " version `CXXABI_1.3.5' not found" when running
or something similar

A: Ensure, that version of libc++ which was used to compile Ragout is similar
to one which is used to run it. You can specify an extra search path
to a specific library by setting "LD_LIBRARY_PATH" variable.
back to top