# QIIME 2 2017.7 release is now live!

**URL:** https://forum.qiime2.org/t/qiime-2-2017-7-release-is-now-live/753
**Category:** Announcements
**Tags:** release
**Created:** [June 26, 2017, 10:52pm UTC](https://forum.qiime2.org/t/qiime-2-2017-7-release-is-now-live/753 "2017-06-26T22:52:09Z")
**Posts on this page:** 2
**Page:** 1

<div class="post-metadata">

### Author: ![thermokarst](https://forum.qiime2.org/letter_avatar_proxy/v4/letter/t/8e7dd6/32.png) [@thermokarst](https://forum.qiime2.org/u/thermokarst)
#### Post date: [June 26, 2017, 10:52pm UTC](https://forum.qiime2.org/t/qiime-2-2017-7-release-is-now-live/753/1 "2017-06-26T22:52:09Z")

</div>

The QIIME 2 2017.7 release is now live! There are lots of exciting new changes packed into this release, and we anticipate having **monthly releases** moving forward while we are in alpha development. Since this is alpha development software, we highly recommend staying up-to-date with the latest releases. We will only provide support for the latest monthly release of QIIME 2 while in alpha development.

Check out the [QIIME 2 2017.7 docs](https://docs.qiime2.org/2017.7/) for details on installing or upgrading/updating your QIIME 2 release, as well as tutorials and other resources. Get in touch on the [QIIME 2 forum](https://forum.qiime2.org) if you run into any issues!

Moving forward, we will provide official conda builds on release day. Virtual machine builds such as AWS and Docker will be released within the following week (we will post a follow-up announcement here when those builds become available).

We recommend checking out `q2-gneiss`, a new plugin added in this release that supports novel methods for differential abundance testing. [A draft tutorial for `q2-gneiss` is now available on the QIIME 2 forum](https://forum.qiime2.org/t/gneiss-tutorial/932). ~~The plugin `q2-composition` has been removed from QIIME 2 as part of this release (this plugin included the ANCOM method).~~ We had initially removed the `q2-composition` plugin in favor `q2-gneiss` in this release, but due to popular demand we have brought `q2-composition` back. [A revised `q2-composition` tutorial is now provided on the QIIME 2 forum](https://forum.qiime2.org/t/ancom-tutorial-moving-pictures-of-the-human-microbiome-dataset/921).

Here's the highlights of the release:

- QIIME 2's homepage has been completely [redesigned](https://qiime2.org)!
- @Yong-Xin_Liu has been working on a community translation of the [QIIME 2 documents](https://forum.qiime2.org/t/qiime2-chinese-manual/838)! Thanks @Yong-Xin_Liu! 🎉
- [QIIME 2 framework](https://github.com/qiime2/qiime2)
  - Comments and blank lines are now supported in the [QIIME 2 metadata file format](https://docs.qiime2.org/2017.7/tutorials/metadata/), along with backwards-compatible support for QIIME 1 mapping files (where the header is a comment).
  - Optional input artifacts are now supported. They must have a default value of `None` (similar to optional parameters).
  - There is no longer a required ordering for method/visualization parameters beyond what Python 3 requires. Interfaces are still free to make any decision about ordering they wish. This should only impact plugin developers.
  - `qiime2.core.typing.Signature.defaults` has been removed in favor of using the `ParameterSpec` objects. This should only impact interface developers.
  - Action docstrings now match the [numpydoc](https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt) standard. This provides the equivalent of `--help` to the Artifact API when users of the Jupyter ecosystem use the `?` command.

- [docs](https://docs.qiime2.org/2017.7/)
  - The importing tutorial now clarifies that `.fastq` files may be provided for the "fastq manifest" formats in addition to `.fastq.gz` files.
  - The QIIME 2 [Native Installation](https://docs.qiime2.org/2017.7/install/native/) document now features interactive platform-specific instructions.
  - The QIIME 2 Studio interface document includes more explicit instructions for installation.
  - Clarified AWS upgrade instructions.
  - Fixed outdated even sampling depth suggestion in the [Moving Pictures](https://docs.qiime2.org/2017.7/tutorials/moving-pictures/) tutorial.
  - Minor typo fixes in the [Moving Pictures](https://docs.qiime2.org/2017.7/tutorials/moving-pictures/) tutorial.
  - Clarified some requirements on the metadata format in the [Metadata](https://docs.qiime2.org/2017.7/tutorials/metadata/) tutorial.

- [q2-alignment](https://docs.qiime2.org/2017.7/plugins/available/alignment/)
  - Added support for running `mafft` with multiple threads.

- [q2-demux](https://docs.qiime2.org/2017.7/plugins/available/demux/)
  - Fixed a bug which would show only the first segment of sample IDs that had an underscore in the `summarize` visualization.

- [q2-dada2](https://docs.qiime2.org/2017.7/plugins/available/dada2/)
  - Fixed a bug which prevented `trunc_len` of `0` from actually being used in `denoise-single` and `denoise-paired`.
  - Improved clarity of error message when an error occurs in the R DADA2 scripts invoked by `q2-dada2`.

- [q2-feature-table](https://docs.qiime2.org/2017.7/plugins/available/feature-table/)
  - Methods `rarefy` and `relative-frequency` no longer create feature tables with the `uniform-sampling` property (see related note below on q2-diversity for details).

- [q2-feature-classifier](https://docs.qiime2.org/2017.7/plugins/available/feature-classifier/)
  - Removed the `num-threads` parameter from `classify-consensus-blast` as it had no effect with the mode that `blastn` is invoked in (i.e. with a subject provided).

- [q2-diversity](https://docs.qiime2.org/2017.7/plugins/available/diversity/)
  - Added an `--exclude-ids` option to `filter-distance-matrix` to exclude (instead of retain) samples selected by `metadata` or `where` parameters.
  - Fixed a bug in the `alpha-correlation` plots that caused x-axis tickmarks to behave poorly.
  - Single quotes are now properly escaped in `alpha-group-significance` visualizations. Previously, metadata values containing single quotes would cause the visualization to break.
  - Methods `alpha`, `alpha-phylogenetic`, `beta`, and `beta-phylogenetic` no longer require the input `FeatureTable[Frequency]` to have the `uniform-sampling` property. This requirement excluded non-uniform sampling effort feature tables. It is desirable to support these types of feature tables in certain cases when downstream multivariate statistical analyses account for uniform sampling effort.

- [q2-taxa](https://docs.qiime2.org/2017.7/plugins/available/taxa/)
  - Removed `qiime taxa tabulate` in favor of `qiime metadata tabulate` (see the [metadata tutorial](https://docs.qiime2.org/2017.7/tutorials/metadata/) for examples).
  - Added the ability to export a CSV of the data from the `barplot` visualization.
  - The `barplot` visualization now has scroll bars on the barplot and the legend.
  - The `barplot` visualization's legend and barplot can now be downloaded as `svg` individually.
  - The `barplot` visualization no longer has a tooltip, instead that information is displayed in a fixed location at the top of the barplot.

- [q2-gneiss](https://docs.qiime2.org/2017.7/plugins/available/gneiss/)
  - This new plugin provides a new set of compositionally aware statistical techniques using balances. This includes different clustering algorithms, visualizations and regression statistics to identify differentially abundant feature partitions. Thanks @mortonjt for putting this plugin together! 🎉
  - Dropped `q2-composition` in favor of this plugin (the method `add-psuedocount` was ported to `q2-gneiss`).

- [q2studio](https://docs.qiime2.org/2017.7/interfaces/q2studio/)
  - Fixed a regression that allowed actions to be run without specifying an output file (we didn't actually want this to happen).
  - Fixed a bug that prevent the listing of plugins from showing up in alphabetical order.

- [q2-types](https://docs.qiime2.org/2017.7/plugins/available/types/)
  - Comments and blank lines are now supported in "per-sample sequence" manifest formats, including sniffers and transformers.
  - Duplicate samples are now additionally detected and disallowed in "relative path" manifest formats (previously this validation only happened in the "absolute path" manifest formats).
  - Error messages reported by transformers are both more precise and accurate regarding the "per-sample" formats.
  - Refactored sniffer and transformer code to reduce redundancy and perform consistent validation and parsing in all sniffers/transformers regarding the "per-sample" formats.
  - Added unit tests, increased coverage to 100% for "per-sample sequence" formats, and made existing unit tests and test data more robust.

- Miscellaneous
  - Enhancements to QIIME 2 developer tools to ensure consistency across QIIME 2 packages (e.g. licensing, required packages, etc.) and to streamline interactive visualization development.

Happy QIIME-ing! 🌞

---

<div class="post-metadata">

### Author: ![thermokarst](https://forum.qiime2.org/letter_avatar_proxy/v4/letter/t/8e7dd6/32.png) [@thermokarst](https://forum.qiime2.org/u/thermokarst)
#### Post date: [August 3, 2017, 4:34pm UTC](https://forum.qiime2.org/t/qiime-2-2017-7-release-is-now-live/753/28 "2017-08-03T16:34:27Z")

</div>

The QIIME 2 2017.7 Virtual Machines are now live! 🎉
