Base Installation with Anaconda

Introduction

If you are not planning on running any of the analyses which require you to pick-OTU's or process any of the raw sequencing data, you can install the base version of QIIME, which contains only the scripts required to analyze a processed OTU table. These scripts are the base install for QIIME and will only allow yo to perform post-processing analysis.


Step 1. Download and Install Anaconda

Anaconda is a comprehensive and easy to use package manager for Python (among other things). Anaconda is meant to replace your current Python installation with one that has more features and is modular, so you can delete it without any damage to your system. MacQIIME is actually just a bundled version of Anaconda with all the required tools pre-installed. The easiest way to install Anaconda is to use their packaged installer.

Download

https://repo.continuum.io/archive/Anaconda2-4.2.0-MacOSX-x86_64.pkg

Be sure to select the option to add Anaconda to the system PATH

Anaconda Install


Step 2. Create a new virtual environment and install the required tools.

After Anaconda has been installed, we can now proceed to create a virtual environment which will allow you to keep tools and dependencies separate from your systems so you do not cause any conflicts with other programs. See http://qiime.org/install/install.html for more information.

Step 2a: Once Anaconda has been installed, restart Terminal and run the command below to verify that Anaconda was properly installed.

anaconda --version
#> anaconda Command line client (version 1.4.0)

Step 2b: Download a conda virtual environment with a pre-configured environment that has all the tools necessary to analyze OTU data. By default, the name of the environment will be qiime191. The download and installation can take ~5 minutes.

conda env create --yes twbattaglia/qiime191

Step 2c: To gain acces to all of the qiime commands and scripts, you must first run the command below. This is similar to the macqiime command which initializes the environment.

# Activate environment
source activate qiime191

Extra: If you would like to type out a single command to start the environment, similar to macqiime in Terminal, you can run the command below which will add a shortcut to you system. Once you run the command, close and restart Terminal to u

# Add a shortcut to qiime191 
echo "alias macqiime='source activate qiime191'" >> $HOME/.bash_profile

# Source profile
source $HOME/.bash_profile

Step 3. Test the installation

Once all the tools are installed, you can run the internal qiime command to test the installation. If the installation was sucessfull, you should seen an OK, at the end of the output.

# Start QIIME
source activate qiime191

# Print QIIME configuration
print_qiime_config.py -t

results matching ""

    No results matching ""