Fork me on GitHub

beta-correlation: Beta diversity correlationΒΆ

Docstring:

Usage: qiime diversity beta-correlation [OPTIONS]

  Create a distance matrix from a numeric metadata column and apply a two-
  sided Mantel test to identify correlation between two distance matrices.
  Actions used internally: `distance-matrix` from q2-metadata and `mantel`
  from q2-diversity.

Inputs:
  --i-distance-matrix ARTIFACT
    DistanceMatrix        Matrix of distances between pairs of samples.
                                                                    [required]
Parameters:
  --m-metadata-file METADATA
  --m-metadata-column COLUMN  MetadataColumn[Numeric]
                          Numeric metadata column from which to compute
                          pairwise Euclidean distances              [required]
  --p-method TEXT Choices('spearman', 'pearson')
                          The correlation test to be applied in the Mantel
                          test.                          [default: 'spearman']
  --p-permutations INTEGER
    Range(0, None)        The number of permutations to be run when computing
                          p-values. Supplying a value of zero will disable
                          permutation testing and p-values will not be
                          calculated (this results in *much* quicker execution
                          time if p-values are not desired).    [default: 999]
  --p-intersect-ids / --p-no-intersect-ids
                          If supplied, IDs that are not found in both
                          distance matrices will be discarded before applying
                          the Mantel test. Default behavior is to error on any
                          mismatched IDs.                     [default: False]
  --p-label1 TEXT         Label for `distance-matrix` in the output
                          visualization.          [default: 'Distance Matrix']
  --p-label2 TEXT         Label for `metadata-distance-matrix` in the output
                          visualization.                 [default: 'Metadata']
Outputs:
  --o-metadata-distance-matrix ARTIFACT
    DistanceMatrix        The Distance Matrix produced from the metadata
                          column and used in the mantel test        [required]
  --o-mantel-scatter-visualization VISUALIZATION
                          Scatter plot rendering of the manteltest results
                                                                    [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 beta_correlation

Docstring:

Beta diversity correlation

Create a distance matrix from a numeric metadata column and apply a two-
sided Mantel test to identify correlation between two distance matrices.
Actions used internally: `distance-matrix` from q2-metadata and `mantel`
from q2-diversity.

Parameters
----------
distance_matrix : DistanceMatrix
    Matrix of distances between pairs of samples.
metadata : MetadataColumn[Numeric]
    Numeric metadata column from which to compute pairwise Euclidean
    distances
method : Str % Choices('spearman', 'pearson'), optional
    The correlation test to be applied in the Mantel test.
permutations : Int % Range(0, None), optional
    The number of permutations to be run when computing p-values. Supplying
    a value of zero will disable permutation testing and p-values will not
    be calculated (this results in *much* quicker execution time if
    p-values are not desired).
intersect_ids : Bool, optional
    If supplied, IDs that are not found in both distance matrices will be
    discarded before applying the Mantel test. Default behavior is to error
    on any mismatched IDs.
label1 : Str, optional
    Label for `distance_matrix` in the output visualization.
label2 : Str, optional
    Label for `metadata_distance_matrix` in the output visualization.

Returns
-------
metadata_distance_matrix : DistanceMatrix
    The Distance Matrix produced from the metadata column and used in the
    mantel test
mantel_scatter_visualization : Visualization
    Scatter plot rendering of the manteltest results