The QIIME 2 2017.8 release is now live! There are lots of exciting new changes packed into this release that are described below. Through the end of 2017 we will have monthly releases. We highly recommend staying up-to-date with the latest releases to get access to new features, bug fixes, documentation, etc. We will only provide user support for the latest monthly release of QIIME 2 as these monthly releases continue through the end of 2017.
QIIME 2 will succeed QIIME 1 on January 1, 2018. QIIME 1 will no longer be supported at that time, as development and support effort for QIIME will be focused entirely on QIIME 2. We recommend that existing QIIME users begin transitioning from QIIME 1 to QIIME 2 now.
Check out the QIIME 2 2017.8 docs for details on installing the latest QIIME 2 release, as well as tutorials and other resources. Get in touch on the QIIME 2 forum if you run into any issues!
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.
Here’s the highlights of the release:
-
QIIME 2 Framework
- Added validation to
Metadata
andMetadataCategory
to disallow empty/null IDs or column labels. Also added type-checking of inputs to constructors.
- Added validation to
-
docs
- Added a differential-abundance testing with q2-gneiss tutorial. This tutorial was ported from a community tutorial written by @mortonjt.
- The ANCOM section of the moving pictures tutorial has been re-added and reformulated to meet the assumptions of ANCOM better.
- Removed the “upgrading/updating” page from the install docs as it was causing confusion with users, and the page isn’t necessary until we provide longer-running releases with patches. To upgrade/update to the latest version of QIIME 2, follow the install instructions appropriate for your computing environment.
- Added a tip to the native install docs about running
conda clean
when troubleshooting installation issues.
-
q2-sample-classifier
- This new plugin supports machine learning prediction of sample data - check out the new tutorial to learn how it works!
-
q2-longitudinal
- This new plugin supports statistical and visual comparisons of longitudinal study designs and paired samples - check out the new tutorial to learn how it works!
-
q2-feature-table
- Added a new
core-features
visualizer for identifying features that are shared among some user-defined fraction of samples. This visualizer is analogous to QIIME 1’scompute_core_microbiome.py
script. - Added a new
group
method for grouping samples or features in a feature-table based on values in a metadata category. This method is analogous to QIIME 1’scollapse_samples.py
script. - The
merge
method now allows basic handling of overlapping axes. Currently you can either allow for overlapping samples, or overlapping features, but not both. We will expand this in the future to support other overlapping methods. - Fixed a bug that prevented users from being able to download their sequences from the
tabulate-seqs
visualization when viewing at view.qiime2.org.
- Added a new
-
q2-diversity
- A new visualizer
alpha-rarefaction
was added which allows you to view an alpha-diversity metric as a rarefaction curve alongside sample metadata for a given range of sampling depths. Thanks for this new visualizer @Max_von_Hippel! - Added new
beta-rarefaction
visualizer, which provides a heatmap showing the correlation between beta diversity distance matrices computed by repeatedly rarefying at a given sampling depth. Thanks for this new visualizer @Kleptobismol! -
beta
,beta-phylogenetic
, andcore-metrics
now have ann-jobs
parameter to turn on parallelism (default is no parallelism).
- A new visualizer
-
q2-taxa
- Fixed a bug where changing the default color scheme would not update colors in the legend.
-
q2-gneiss
- Fixed a bug in
dendrogram-heatmap
when there are tree tips that are not present in the feature table. - Fixed a bug in
dendrogram-heatmap
andgradient-clustering
when there are samples in the metadata that are not present in the feature table.
- Fixed a bug in
-
q2-alignment
- Fixed a bug where MAFFT would truncate very long sequence IDs (~250 characters in length). This was a problem for users who chose not to hash their sequence IDs during denoising (or otherwise imported them, e.g. from running DADA2 in R).
-
q2view
- Fixed a bug that caused q2view to become extremely unresponsive in Firefox 55.
- Fixed a bug that cause a Protocol Violation error in Firefox 55 when following a link in a fresh session.
- Links to files with an unknown extension how default to a download dialog.
-
q2-feature-classifier
- Updated plugin to work with scikit-learn 0.19.0 and later.
-
q2cli
- The debug log’s filepath (printed when an error is encountered) no longer has a trailing period, making it easier to copy.
-
q2templates
-
Plugin developers: if you’re using
DataFrame.to_html
in your code, you might want to check this out! Addedq2templates.df_to_html
function, which wrapsDataFrame.to_html
to avoid truncation of cell contents in the output HTML. Default pandas behavior is to truncate cell contents that exceed 50 characters. The function also uses different default parameters thanDataFrame.to_html
to give uniform styling to HTML tables that are compatible with q2template themes. These defaults can be overridden.
-
Plugin developers: if you’re using
-
q2-types
- Removed
q2_types.per_sample_sequences.PerSampleDNAIterators
andq2_types.per_sample_sequences.PerSamplePairedDNAIterators
view types, along with their corresponding transformers. We discovered that these view types never actually worked and weren’t being used anywhere, so this change shouldn’t affect users or plugin/interface developers.
- Removed
- Miscellaneous
- Various enhancements to QIIME 2 developer tools to ensure consistency across QIIME 2 packages and to streamline development.
Happy QIIME-ing!