-
Notifications
You must be signed in to change notification settings - Fork 13
1. Installation
Basta can be installed using the conda package manager. Once you have conda installed, do the following:
On OSX/mac:
conda env create -f environment_osx.yml
source activate py27
On Linux:
conda env create -f environment_linux.yml
source activate py27
BASTA depends on LevelDB and the python wrapper Plyvel as well as a few non-standard python libraries which can easily be installed using pip.
- gzip
- hashlib
The easiest way to install the libraries is using the python package manager pip
pip install gzip hashlib
The easiest way to install BASTA on MacOSX is through homebrew (https://brew.sh/) and pip.
brew install leveldb
pip install Plyvel
NOTE Often MacOSX can't find the leveldb header files. If so try:
pip install --global-option=build_ext --global-option="-I/usr/local/include" --global-option="-L/usr/local/lib" Plyvel
LevelDB can be installed using aptitude:
sudo apt-get update
sudo apt-get install python-leveldb
pip install Plyvel
Currently, BASTA uses levelDB (https://github.com/google/leveldb) for storage of NCBI taxonomies and mapping files. The reason is that the otherwise preferred database system SQLite can lead to locking errors when used on infrastructure that mounts hard drives using Network File System (NFS) which is often the case on compute clusters.
BASTA is written in python, i.e., it doesn't have to be compiled. You only need to download it and are ready to go. To download BASTA either
- download the latest release (https://github.com/timkahlke/BASTA/releases) and extract the files
- use git to clone the directory by typing
git clone https://github.com/timkahlke/BASTAon the command line
BASTA provides a custom script to create Krona plots (https://github.com/marbl/Krona/wiki) from annotation files. To install KronaTools please follow the Krona installation guide.