Warning
This site has been replaced by the new QIIME 2 “amplicon distribution” documentation, as of the 2025.4 release of QIIME 2. You can still access the content from the “old docs” here for the QIIME 2 2024.10 and earlier releases, but we recommend that you transition to the new documentation at https://amplicon-docs.qiime2.org. Content on this site is no longer updated and may be out of date.
Are you looking for:
the QIIME 2 homepage? That’s https://qiime2.org.
learning resources for microbiome marker gene (i.e., amplicon) analysis? See the QIIME 2 amplicon distribution documentation.
learning resources for microbiome metagenome analysis? See the MOSHPIT documentation.
installation instructions, plugins, books, videos, workshops, or resources? See the QIIME 2 Library.
general help? See the QIIME 2 Forum.
Old content beyond this point… 👴👵
core-metrics: Core diversity metrics (non-phylogenetic)¶
Docstring:
Usage: qiime diversity core-metrics [OPTIONS] Applies a collection of diversity metrics (non-phylogenetic) to a feature table. Inputs: --i-table ARTIFACT FeatureTable[Frequency] The feature table containing the samples over which diversity metrics should be computed. [required] Parameters: --p-sampling-depth INTEGER Range(1, None) The total frequency that each sample should be rarefied to prior to computing diversity metrics. [required] --m-metadata-file METADATA... (multiple arguments The sample metadata to use in the emperor plots. will be merged) [required] --p-with-replacement / --p-no-with-replacement Rarefy with replacement by sampling from the multinomial distribution instead of rarefying without replacement. [default: False] --p-n-jobs NTHREADS [beta methods only] - The number of concurrent jobs to use in performing this calculation. May not exceed the number of available physical cores. If n-jobs = 'auto', one job will be launched for each identified CPU core on the host. [default: 1] --p-ignore-missing-samples / --p-no-ignore-missing-samples If set to `True` samples and features without metadata are included by setting all metadata values to: "This element has no metadata". By default an exception will be raised if missing elements are encountered. Note, this flag only takes effect if there is at least one overlapping element. [default: False] Outputs: --o-rarefied-table ARTIFACT FeatureTable[Frequency] The resulting rarefied feature table. [required] --o-observed-features-vector ARTIFACT SampleData[AlphaDiversity] Vector of Observed Features values by sample. [required] --o-shannon-vector ARTIFACT SampleData[AlphaDiversity] Vector of Shannon diversity values by sample. [required] --o-evenness-vector ARTIFACT SampleData[AlphaDiversity] Vector of Pielou's evenness values by sample. [required] --o-jaccard-distance-matrix ARTIFACT DistanceMatrix Matrix of Jaccard distances between pairs of samples. [required] --o-bray-curtis-distance-matrix ARTIFACT DistanceMatrix Matrix of Bray-Curtis distances between pairs of samples. [required] --o-jaccard-pcoa-results ARTIFACT PCoAResults PCoA matrix computed from Jaccard distances between samples. [required] --o-bray-curtis-pcoa-results ARTIFACT PCoAResults PCoA matrix computed from Bray-Curtis distances between samples. [required] --o-jaccard-emperor VISUALIZATION Emperor plot of the PCoA matrix computed from Jaccard. [required] --o-bray-curtis-emperor VISUALIZATION Emperor plot of the PCoA matrix computed from Bray-Curtis. [required] Miscellaneous: --output-dir PATH Output unspecified results to a directory --verbose / --quiet Display verbose output to stdout and/or stderr during execution of this action. Or silence output if execution is successful (silence is golden). --recycle-pool TEXT Use a cache pool for pipeline resumption. QIIME 2 will cache your results in this pool for reuse by future invocations. These pool are retained until deleted by the user. If not provided, QIIME 2 will create a pool which is automatically reused by invocations of the same action and removed if the action is successful. Note: these pools are local to the cache you are using. --no-recycle Do not recycle results from a previous failed pipeline run or save the results from this run for future recycling. --parallel Execute your action in parallel. This flag will use your default parallel config. --parallel-config FILE Execute your action in parallel using a config at the indicated path. --example-data PATH Write example data and exit. --citations Show citations and exit. --use-cache DIRECTORY Specify the cache to be used for the intermediate work of this action. If not provided, the default cache under $TMP/qiime2/will be used. IMPORTANT FOR HPC USERS: If you are on an HPC system and are using parallel execution it is important to set this to a location that is globally accessible to all nodes in the cluster. --help Show this message and exit.
Import:
from qiime2.plugins.diversity.pipelines import core_metrics
Docstring:
Core diversity metrics (non-phylogenetic) Applies a collection of diversity metrics (non-phylogenetic) to a feature table. Parameters ---------- table : FeatureTable[Frequency] The feature table containing the samples over which diversity metrics should be computed. sampling_depth : Int % Range(1, None) The total frequency that each sample should be rarefied to prior to computing diversity metrics. metadata : Metadata The sample metadata to use in the emperor plots. with_replacement : Bool, optional Rarefy with replacement by sampling from the multinomial distribution instead of rarefying without replacement. n_jobs : Threads, optional [beta methods only] - The number of concurrent jobs to use in performing this calculation. May not exceed the number of available physical cores. If n_jobs = 'auto', one job will be launched for each identified CPU core on the host. ignore_missing_samples : Bool, optional If set to `True` samples and features without metadata are included by setting all metadata values to: "This element has no metadata". By default an exception will be raised if missing elements are encountered. Note, this flag only takes effect if there is at least one overlapping element. Returns ------- rarefied_table : FeatureTable[Frequency] The resulting rarefied feature table. observed_features_vector : SampleData[AlphaDiversity] Vector of Observed Features values by sample. shannon_vector : SampleData[AlphaDiversity] Vector of Shannon diversity values by sample. evenness_vector : SampleData[AlphaDiversity] Vector of Pielou's evenness values by sample. jaccard_distance_matrix : DistanceMatrix Matrix of Jaccard distances between pairs of samples. bray_curtis_distance_matrix : DistanceMatrix Matrix of Bray-Curtis distances between pairs of samples. jaccard_pcoa_results : PCoAResults PCoA matrix computed from Jaccard distances between samples. bray_curtis_pcoa_results : PCoAResults PCoA matrix computed from Bray-Curtis distances between samples. jaccard_emperor : Visualization Emperor plot of the PCoA matrix computed from Jaccard. bray_curtis_emperor : Visualization Emperor plot of the PCoA matrix computed from Bray-Curtis.