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 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 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. The plugin We had initially removed the q2-composition
has been removed from QIIME 2 as part of this release (this plugin included the ANCOM method).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.
Here’s the highlights of the release:
- QIIME 2’s homepage has been completely redesigned!
- @Yong-Xin_Liu has been working on a community translation of the QIIME 2 documents! Thanks @Yong-Xin_Liu!
-
QIIME 2 framework
- Comments and blank lines are now supported in the QIIME 2 metadata file format, 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 theParameterSpec
objects. This should only impact interface developers. - Action docstrings now match the numpydoc standard. This provides the equivalent of
--help
to the Artifact API when users of the Jupyter ecosystem use the?
command.
-
docs
- 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 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 tutorial.
- Minor typo fixes in the Moving Pictures tutorial.
- Clarified some requirements on the metadata format in the Metadata tutorial.
- The importing tutorial now clarifies that
-
q2-alignment
- Added support for running
mafft
with multiple threads.
- Added support for running
-
q2-demux
- Fixed a bug which would show only the first segment of sample IDs that had an underscore in the
summarize
visualization.
- Fixed a bug which would show only the first segment of sample IDs that had an underscore in the
-
q2-dada2
- Fixed a bug which prevented
trunc_len
of0
from actually being used indenoise-single
anddenoise-paired
. - Improved clarity of error message when an error occurs in the R DADA2 scripts invoked by
q2-dada2
.
- Fixed a bug which prevented
-
q2-feature-table
- Methods
rarefy
andrelative-frequency
no longer create feature tables with theuniform-sampling
property (see related note below on q2-diversity for details).
- Methods
-
q2-feature-classifier
- Removed the
num-threads
parameter fromclassify-consensus-blast
as it had no effect with the mode thatblastn
is invoked in (i.e. with a subject provided).
- Removed the
-
q2-diversity
- Added an
--exclude-ids
option tofilter-distance-matrix
to exclude (instead of retain) samples selected bymetadata
orwhere
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
, andbeta-phylogenetic
no longer require the inputFeatureTable[Frequency]
to have theuniform-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.
- Added an
-
q2-taxa
- Removed
qiime taxa tabulate
in favor ofqiime metadata tabulate
(see the metadata tutorial 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 assvg
individually. - The
barplot
visualization no longer has a tooltip, instead that information is displayed in a fixed location at the top of the barplot.
- Removed
-
q2-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 methodadd-psuedocount
was ported toq2-gneiss
).
-
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
- 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!