Version 1 (modified by r.w.w.brouwer@…, 3 years ago)


Installation instructions



Python (> 2,6) BASH R

GNU/Linux software

gzip pdflatex GCC (optional) libz (optional)

Bioinformatics tools

NARWHAL relies on a number of previously published Bioinformatics tools. These are all open-source and freely available. We have not tested Narwhal with all version of these tools, but we expect no problems with newer versions of these tools. However, to ensure proper operation of Narwhal explicitely compatible versions of these tools are listed below. Through the version control mechanisms present in the hosting websites, these versions should be still available available.

Tool Version Link Pubmed Bowtie 0.12.5 link 19261174 BWA 0.5.9 link 19451168 SAMtools 0.1.18 link 19505943 BAMtools (optional) 0.9 link 21493652 Instructions

NARWHAL can be easily installed on most UNIX(r) based operating systems. First download the tar-bundled NARWHAL installation from this link and unpack this in your directory of choice:

> cd $NARWHAL_dir
> wget 
> gunzip NARWHAL.tar.gz
> tar -xf Narhwal.tar

This procedure should create several files and directories in the directory similar to the following:

> ls
bin  conf  lib  src  tools

The tools used by NARWHAL should be present in the users PATH. As it may be undesirable to make the NARWHAL tools available to all users all the time, NARWHAL will add the tools directory to the PATH before running the tools. By placing symbolic links to tools in the tool directory that will be called by the NARWHAL.

> cd tools
> ln -S $path_to_bowtie bowtie
> ln -S $path_to_bwa bwa
> ln -S $path_to_samtools samtools
> ln -S $path_to_nice nice

In the tools directory precompiled versions of the data-processing tools are present. These need to be recompiled if your system is not 64-bit i386 compatible The sources of these tools can be found in ${NARWHAL_dir}/src/cpp directory. To recompile a tool type "make clean; make" in the tool root directory. After compilation, the new executable needs to be copied from the tool bin directory to ${NARWHAL_dir}/tools.

This procedure is outlined for the bamstats tool. For some tools the Bamtools libraries should be installed.

> cd ${NARWHAL_dir}/src/cpp/bamstats
> make clean
> make
# lots of make output
> cp bin/bamstats ${NARWHAL_dir}/tools/

During a NARWHAL run, the PYTHONPATH and NARWHAL_TOOLS environmental variables need to be set correctly. In normal use, these variables are set by the script based on the NARWHAL installation directory.

> export NARWHAL_TOOLS="${narwhal_dir}/tools"
> export PYTHONPATH=$PYTHONPATH:"${narwhal_dir}/tools/lib/python/"

NARWHAL should now be installed. To analyze data with NARWHAL, see the Quickstart guide