File: installation.rst

package info (click to toggle)
nanopolish 0.14.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 11,760 kB
  • sloc: cpp: 22,200; ansic: 1,478; python: 814; makefile: 210; sh: 43; perl: 17
file content (45 lines) | stat: -rw-r--r-- 2,048 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
.. _installation:

Installation
=======================

Dependencies
-----------------------

A compiler that supports C++11 is needed to build nanopolish. Development of the code is performed using `gcc-4.8 <https://gcc.gnu.org/gcc-4.8/>`_.

By default, nanopolish will download and compile all of its required dependencies. Some users however may want to use system-wide versions of the libraries. To turn off the automatic installation of dependencies set `HDF5=noinstall`, `EIGEN=noinstall` or `HTS=noinstall` parameters when running `make` as appropriate. The current versions and compile options for the dependencies are:

* `libhdf5-1.8.14 <http://www.hdfgroup.org/HDF5/release/obtain5.html>`_ compiled with multi-threading support ``--enable-threadsafe``
* `eigen-3.2.5 <http://eigen.tuxfamily.org/>`_ 
* `htslib-1.4 <http://github.com/samtools/htslib>`_

Additionally the helper `scripts` require `biopython <http://biopython.org/>`_ and `pysam <http://pysam.readthedocs.io/en/latest/installation.html>`_.

Installing the latest code from github (recommended)
------------------------------------------------------
You can download and compile the latest code from github as follows ::

    git clone --recursive https://github.com/jts/nanopolish.git
    cd nanopolish
    make

Installing a particular release
------------------------------------------------------
When major features have been added or bugs fixed, we will tag and release a new version of nanopolish. If you wish to use a particular version, you can checkout the tagged version before compiling ::

    git clone --recursive https://github.com/jts/nanopolish.git
    cd nanopolish
    git checkout v0.7.1
    make

To run using docker
-------------------

First build the image from the dockerfile: ::

    docker build .

Note the uuid given upon successful build. Then you can run nanopolish from the image: ::

    docker run -v /path/to/local/data/data/:/data/ -it :image_id  ./nanopolish eventalign -r /data/reads.fa -b /data/alignments.sorted.bam -g /data/ref.fa