Installation
This installation guide assumes the use of the BASH Unix shell and a 64-bit Linux system. Neptune may either be installed directly or as a Bioconda package. Neptune may either be run on a single machine or a computing cluster. Neptune achieves maximum parallelization when submitting jobs through a DRMAA-compliant cluster computing scheduler. The installation and configuration of a DRMAA-compliant scheduler will require a significant understanding of Unix. However, it is possible to run Neptune in parallel on a single machine without DRMAA. Neptune is known to be compatible with the SGE and Slurm schedulers.
Bioconda
The simpliest way to install Neptune is using the Bioconda channel for the conda package management system. We recommend installing conda with the Miniconda package. There are two variants of the Miniconda installer: Python 2.7 and Python 3.6. However, the choice of Miniconda only affects the Python version in root environment. We recommend installing Miniconda using Python 2.7 64-bit Linux installer. Otherwise, you will need to explicitly use Neptune within a conda environment.
Overview
The Bioconda-based Neptune installation involves the following:
- Installing Bioconda
- Installing the "neptune" Bioconda package (
conda install neptune
).
We provide detailed instructions below.
Miniconda (Python 2.7)
Bioconda requires conda to be installed and we recommend using the Miniconda package. Miniconda may be installed with the follow instructions:
wget https://repo.continuum.io/miniconda/Miniconda2-latest-Linux-x86_64.sh
chmod 755 Miniconda2-latest-Linux-x86_64.sh
./Miniconda2-latest-Linux-x86_64.sh
You will likely want Miniconda to append the install location to your PATH and will need to select this option during the installation process. After installation, you will then need to either open a new terminal or source your bashrc file in the current terminal for Miniconda to become available on the PATH:
source ~/.bashrc
You can check if your Miniconda installation was successful with the following:
conda --version
Bioconda
You will need to add the following channels to conda. They must be added in this order so that priority is set correctly.
conda config --add channels conda-forge
conda config --add channels defaults
conda config --add channels r
conda config --add channels bioconda
Neptune (Miniconda 2.7)
The following instructions assume you are using Miniconda with Python 2.7, as described above. After enabling Bioconda, Neptune may be installed as a Bioconda package with the following:
conda install neptune
You can check if Neptune was installed correctly with the following:
neptune --version
Neptune (Miniconda 3.6)
The follwing instructions assume you are using the Python 3.6 version of Miniconda. In this circumstance, we need to install Neptune within a Python 2.7 environment:
conda create --name neptune python=2.7 neptune
This Neptune environment can be activated with the following:
source activate neptune
You can check if Neptune was installed correctly with the following:
neptune --version
The current environment may be deactivated with the following:
source deactivate
It is important to note that this Neptune Bioconda environment will need to be activated in order to run the Neptune application. However, the benefit is that your system will be shielded from the Python 2.7 installation required by Neptune.
Direct
The following instructions describe how to install Neptune directly. These instructions will likely require administrative privilages.
Overview
The direct Neptune installation involves the following:
- Installing Python 2.7
- Installing dependencies (Ubuntu:
sudo neptune/install/debian_dependencies.sh
) - Installing Neptune (
neptune/INSTALL.sh
)
We provide more detailed instructions below.
Python
Neptune requires Python 2.7. Note that Python 2.7 is provided with many major distributions of Linux. The following may check your Python version:
python --version
Dependencies
Debian-Based Installation
This section assumes the user has the APT package manager. This is common to the Ubuntu operating system. However, this section should be compatible with any 64-bit Debian distribution. The following operation will automatically install Neptune's dependencies and require security privileges (sudo) to install the dependencies:
sudo neptune/install/debian_dependencies.sh
Manual Installation
If you cannot install the dependencies using the above script, the following dependencies must be manually installed, if necessary, by the user:
- pip
- virtualenv
- build-essential
- python-dev
- NCBI BLAST+
Neptune
Neptune will be installed using pip into its own Python virtual environment. The following will install Neptune locally into the source directory and will not require security privileges:
neptune/INSTALL.sh
Alternatively, you may specify an install location, PREFIX, such as /usr/local/. Neptune will create the directories PREFIX/lib and PREFIX/bin. This may require security privileges:
neptune/INSTALL.sh PREFIX