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… 👴👵
biplot: Visualize and Interact with Principal Coordinates Analysis Biplot¶
Docstring:
Usage: qiime emperor biplot [OPTIONS] Generates an interactive ordination biplot where the user can visually integrate sample and feature metadata. Vectors representing the n most important features are then plotted in the emperor visualization (5 largest, by default). Inputs: --i-biplot ARTIFACT PCoAResults % Properties('biplot') The principal coordinates matrix to be plotted. [required] Parameters: --m-sample-metadata-file METADATA... (multiple The sample metadata arguments will be merged) [required] --m-feature-metadata-file METADATA... (multiple The feature metadata (useful to manipulate the arguments will be arrows in the plot). merged) [optional] --p-ignore-missing-samples / --p-no-ignore-missing-samples This will suppress the error raised when the coordinates matrix contains samples that are not present in the metadata. Samples without metadata are included by setting all metadata values to: "This sample has no metadata". This flag is only applied if at least one sample is present in both the coordinates matrix and the metadata. [default: False] --p-invert / --p-no-invert If specified, the point and arrow coordinates will be swapped. [default: False] --p-number-of-features INTEGER Range(1, None) The number of most important features (arrows) to display in the ordination. “Importance” is calculated for each feature based on the vector’s magnitude (euclidean distance from origin). [default: 5] Outputs: --o-visualization VISUALIZATION [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). --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.emperor.visualizers import biplot
Docstring:
Visualize and Interact with Principal Coordinates Analysis Biplot Generates an interactive ordination biplot where the user can visually integrate sample and feature metadata. Vectors representing the n most important features are then plotted in the emperor visualization (5 largest, by default). Parameters ---------- biplot : PCoAResults % Properties('biplot') The principal coordinates matrix to be plotted. sample_metadata : Metadata The sample metadata feature_metadata : Metadata, optional The feature metadata (useful to manipulate the arrows in the plot). ignore_missing_samples : Bool, optional This will suppress the error raised when the coordinates matrix contains samples that are not present in the metadata. Samples without metadata are included by setting all metadata values to: "This sample has no metadata". This flag is only applied if at least one sample is present in both the coordinates matrix and the metadata. invert : Bool, optional If specified, the point and arrow coordinates will be swapped. number_of_features : Int % Range(1, None), optional The number of most important features (arrows) to display in the ordination. “Importance” is calculated for each feature based on the vector’s magnitude (euclidean distance from origin). Returns ------- visualization : Visualization