# Qiime2 Amplicon 2023.9


{{< admonition success "Installed" true >}}
This software should be available with no extra configuration.
{{< /admonition >}}

## qiime2-amplicon-2023

QIIME 2 is a powerful, extensible, and decentralized microbiome analysis
package with a focus on data and analysis transparency. QIIME 2 enables
researchers to start an analysis with raw DNA sequence data and finish with
publication-quality figures and statistical results.

Key features:

* Integrated and automatic tracking of data provenance
* Semantic type system
* Plugin system for extending microbiome analysis functionality
* Support for multiple types of user interfaces (e.g. API, command line, graphical)

QIIME 2 is a complete redesign and rewrite of the [QIIME
1](https://qiime.org/) microbiome analysis pipeline. QIIME 2 will address many
of the limitations of QIIME 1, while retaining the features that makes QIIME 1
a powerful and widely-used analysis pipeline.

QIIME 2 currently supports an initial end-to-end microbiome analysis pipeline.
New functionality will regularly become available through QIIME 2 plugins. You
can view a list of plugins that are currently available on the QIIME 2
[plugin availability](https://docs.qiime2.org/2023.9/plugins/available/) page.
The [future plugins](https://docs.qiime2.org/2023.9/plugins/future/) page
lists plugins that are being developed.

-------------------------------------------------------------------------------

## Installation notes

QIIME 2 now has different
[distributions](https://docs.qiime2.org/2023.9/install/#qiime-2-2023-9-distributions).
This is the amplicon distrubtion. Other distributions will need to be
installed separately.

QIIME 2 is installed in a conda environment, but the environment does not need
to be activated prior to using the `qiime` command on the command-line.

If you need to activate the conda env for some reason, run these commands:

```console
bash
source /local/cluster/micromamba/envs/qiime2-amplicon-2023.9/activate.sh
```

## Location and version

```console
$ which qiime
/local/cluster/bin/qiime
$ qiime info
System versions
Python version: 3.8.15
QIIME 2 release: 2023.9
QIIME 2 version: 2023.9.2
q2cli version: 2023.9.1

Installed plugins
alignment: 2023.9.0
composition: 2023.9.0
cutadapt: 2023.9.0
dada2: 2023.9.0
deblur: 2023.9.0
demux: 2023.9.1
diversity: 2023.9.0
diversity-lib: 2023.9.0
emperor: 2023.9.0
feature-classifier: 2023.9.0
feature-table: 2023.9.0
fragment-insertion: 2023.9.0
longitudinal: 2023.9.1
metadata: 2023.9.0
phylogeny: 2023.9.0
quality-control: 2023.9.0
quality-filter: 2023.9.0
sample-classifier: 2023.9.0
taxa: 2023.9.0
types: 2023.9.0
vsearch: 2023.9.0
```

## help message

```console
$ qiime --help
Usage: qiime [OPTIONS] COMMAND [ARGS]...

  QIIME 2 command-line interface (q2cli)
  --------------------------------------

  To get help with QIIME 2, visit https://qiime2.org.

  To enable tab completion in Bash, run the following command or add it to
  your .bashrc/.bash_profile:

      source tab-qiime

  To enable tab completion in ZSH, run the following commands or add them to
  your .zshrc:

      autoload -Uz compinit && compinit
      autoload bashcompinit && bashcompinit
      source tab-qiime

Options:
  --version   Show the version and exit.
  --help      Show this message and exit.

Commands:
  info                Display information about current deployment.
  tools               Tools for working with QIIME 2 files.
  dev                 Utilities for developers and advanced users.
  alignment           Plugin for generating and manipulating alignments.
  composition         Plugin for compositional data analysis.
  cutadapt            Plugin for removing adapter sequences, primers, and
                      other unwanted sequence from sequence data.
  dada2               Plugin for sequence quality control with DADA2.
  deblur              Plugin for sequence quality control with Deblur.
  demux               Plugin for demultiplexing & viewing sequence quality.
  diversity           Plugin for exploring community diversity.
  diversity-lib       Plugin for computing community diversity.
  emperor             Plugin for ordination plotting with Emperor.
  feature-classifier  Plugin for taxonomic classification.
  feature-table       Plugin for working with sample by feature tables.
  fragment-insertion  Plugin for extending phylogenies.
  longitudinal        Plugin for paired sample and time series analyses.
  metadata            Plugin for working with Metadata.
  phylogeny           Plugin for generating and manipulating phylogenies.
  quality-control     Plugin for quality control of feature and sequence data.
  quality-filter      Plugin for PHRED-based filtering and trimming.
  sample-classifier   Plugin for machine learning prediction of sample
                      metadata.
  taxa                Plugin for working with feature taxonomy annotations.
  vsearch             Plugin for clustering and dereplicating with vsearch.
```

software ref: <https://docs.qiime2.org/2023.9/>  
research ref: <https://docs.qiime2.org/2023.9/citation/>  
research ref: <https://doi.org/10.1038/s41587-019-0209-9>