Fork me on GitHub

beta-passthrough: Beta Passthrough (non-phylogenetic)ΒΆ

Docstring:

Usage: qiime diversity-lib beta-passthrough [OPTIONS]

  Computes a distance matrix for all pairs of samples in a feature table using
  the scikit-bio implementation of the selected beta diversity metric.

Inputs:
  --i-table ARTIFACT FeatureTable[Frequency]
                         The feature table containing the samples over which
                         beta diversity should be computed.         [required]
Parameters:
  --p-metric TEXT Choices('aitchison', 'canberra', 'canberra_adkins',
    'chebyshev', 'cityblock', 'correlation', 'cosine', 'dice', 'euclidean',
    'hamming', 'jensenshannon', 'matching', 'minkowski', 'rogerstanimoto',
    'russellrao', 'seuclidean', 'sokalmichener', 'sokalsneath', 'sqeuclidean',
    'yule')              The beta diversity metric to be computed.  [required]
  --p-pseudocount INTEGER
    Range(1, None)       A pseudocount to handle zeros for compositional
                         metrics. This is ignored for non-compositional
                         metrics.                                 [default: 1]
  --p-n-jobs NTHREADS    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]
Outputs:
  --o-distance-matrix ARTIFACT
    DistanceMatrix       The resulting distance matrix.             [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.

Examples:
  # ### example: run on one core (by default)
  qiime diversity-lib beta-passthrough \
    --i-table feature-table.qza \
    --p-metric euclidean \
    --o-distance-matrix euclidean-dm.qza

  # ### example: to run on n cores, replace 1 here with your preferred integer
  qiime diversity-lib beta-passthrough \
    --i-table feature-table.qza \
    --p-metric euclidean \
    --p-n-jobs 1 \
    --o-distance-matrix euclidean-dm.qza

  # ### example: use 'auto' to run on all of host system's available CPU cores
  # A default pseudocount of 1 is added to feature counts. Pseudocount is
  # ignored for non-compositional metrics.
  qiime diversity-lib beta-passthrough \
    --i-table feature-table.qza \
    --p-metric aitchison \
    --p-n-jobs auto \
    --o-distance-matrix aitchison-dm.qza

  # ### example: use 'pseudocount' to manually set a pseudocount for
  # compositional metrics
  qiime diversity-lib beta-passthrough \
    --i-table feature-table.qza \
    --p-metric aitchison \
    --p-n-jobs auto \
    --p-pseudocount 5 \
    --o-distance-matrix aitchison-dm.qza

Import:

from qiime2.plugins.diversity_lib.methods import beta_passthrough

Docstring:

Beta Passthrough (non-phylogenetic)

Computes a distance matrix for all pairs of samples in a feature table
using the scikit-bio implementation of the selected beta diversity metric.

Parameters
----------
table : FeatureTable[Frequency]
    The feature table containing the samples over which beta diversity
    should be computed.
metric : Str % Choices('aitchison', 'canberra', 'canberra_adkins', 'chebyshev', 'cityblock', 'correlation', 'cosine', 'dice', 'euclidean', 'hamming', 'jensenshannon', 'matching', 'minkowski', 'rogerstanimoto', 'russellrao', 'seuclidean', 'sokalmichener', 'sokalsneath', 'sqeuclidean', 'yule')
    The beta diversity metric to be computed.
pseudocount : Int % Range(1, None), optional
    A pseudocount to handle zeros for compositional metrics. This is
    ignored for non-compositional metrics.
n_jobs : Threads, optional
    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.

Returns
-------
distance_matrix : DistanceMatrix
    The resulting distance matrix.