QIIME: Difference between revisions
No edit summary |
No edit summary |
||
| Line 5: | Line 5: | ||
<!--T:2--> | <!--T:2--> | ||
'''Note''': QIIME 2 has | '''Note''': QIIME 2 has replaced QIIME 1 as of January 1, 2018; version 1 is no longer supported. | ||
==Installation == <!--T:4--> | ==Installation == <!--T:4--> | ||
QIIME 2 can be installed in your home directory using conda. It is not possible to install this software using pip at this time. | QIIME 2 can be installed in your home directory using conda. It is not possible to install this software using pip at this time. | ||
The installation procedure depends on whether or not you | The installation procedure depends on whether or not you have a [https://www.anaconda.com/ conda] environment. | ||
===With a conda environment=== <!--T:5--> | ===With a conda environment=== <!--T:5--> | ||
Although we '''do not recommend''' using conda environments in an HPC environment, we provide the option to do so at your own peril | Although we '''do not recommend''' using conda environments in an HPC environment, we provide the option to do so at your own peril. | ||
<!--T:6--> | <!--T:6--> | ||
General installation instructions by the QIIME 2 developers are found [https://docs.qiime2.org/ here]. | General installation instructions by the QIIME 2 developers are found [https://docs.qiime2.org/ here]. Instructions adapted for Compute Canada systems are given here for version 2019.7. If a new version of the <tt>.yml</tt> file is released (check the link), use the newer version by updating the instructions below. | ||
</translate> | </translate> | ||
<pre> | <pre> | ||
| Line 29: | Line 29: | ||
<translate> | <translate> | ||
<!--T:7--> | <!--T:7--> | ||
Remember to log out and back in after the "conda init bash" step. | Remember to log out and log back in after the "conda init bash" step. | ||
<!--T:8--> | <!--T:8--> | ||
| Line 41: | Line 41: | ||
<translate> | <translate> | ||
===Without a conda environment (preferred)=== <!--T:9--> | ===Without a conda environment (preferred)=== <!--T:9--> | ||
Since we know that conda environments can create more problems that they solve in HPC systems, we provide EasyBuild packages that can be used with the <tt>eb</tt> command. To install version 2019.7, | Since we know that conda environments can create more problems that they solve in HPC systems, we provide EasyBuild packages that can be used with the <tt>eb</tt> command. To install version 2019.7, use | ||
</translate> | </translate> | ||
<pre> | <pre> | ||
Revision as of 21:33, 30 January 2020
QIIME (pronounced chime) stands for Quantitative Insights Into Microbial Ecology, is an open-source bioinformatics pipeline for performing microbiome analysis from raw DNA sequencing data. QIIME is designed to take users from raw sequencing data generated on Illumina or other platforms to publication-quality graphics and statistics. This includes demultiplexing and quality filtering, OTU picking, taxonomic assignment, phylogenetic reconstruction, diversity analyses and visualizations. QIIME has been applied to studies based on billions of sequences from tens of thousands of samples.
Note: QIIME 2 has replaced QIIME 1 as of January 1, 2018; version 1 is no longer supported.
Installation
QIIME 2 can be installed in your home directory using conda. It is not possible to install this software using pip at this time.
The installation procedure depends on whether or not you have a conda environment.
With a conda environment
Although we do not recommend using conda environments in an HPC environment, we provide the option to do so at your own peril.
General installation instructions by the QIIME 2 developers are found here. Instructions adapted for Compute Canada systems are given here for version 2019.7. If a new version of the .yml file is released (check the link), use the newer version by updating the instructions below.
eb Miniconda3-4.5.12.eb module load miniconda3 conda update conda wget https://data.qiime2.org/distro/core/qiime2-2019.7-py36-linux-conda.yml conda env create -n qiime2-2019.7 --file qiime2-2019.7-py36-linux-conda.yml conda init bash conda activate qiime2-2019.7
Remember to log out and log back in after the "conda init bash" step.
To run QIIME 2, use
module load miniconda3 conda activate qiime2-2019.7
Without a conda environment (preferred)
Since we know that conda environments can create more problems that they solve in HPC systems, we provide EasyBuild packages that can be used with the eb command. To install version 2019.7, use
eb --rebuild Miniconda3-4.7.10.eb QIIME2-2019.7.eb
This takes a while, but will provide you with the qiime/2019.7 module that you need to load before using QIIME 2.
module load qiime2/2019.7
References
QIIME homepage
EasyBuild documentation
Getting started with Conda