Fork me on GitHub

shuffle-groups: Shuffle values in a categorical sample metadata column.ΒΆ

Docstring:

Usage: qiime metadata shuffle-groups [OPTIONS]

  Create one or more categorical sample metadata columns by shuffling the
  values in an input metadata column. To avoid confusion, the column name and
  values will be derived from the provided prefixes. The number of different
  values (or groups), and the counts of each value, will match the input
  metadata column but the association of values with sample ids will be
  random. These data will be written to an artifact that can be used as sample
  metadata.

Parameters:
  --m-metadata-file METADATA
  --m-metadata-column COLUMN  MetadataColumn[Categorical]
                         Categorical metadata column to shuffle.    [required]
  --p-n-columns INTEGER  The number of shuffled metadata columns to create.
                                                                  [default: 3]
  --p-md-column-name-prefix TEXT
                         Prefix to use in naming the shuffled metadata
                         columns.              [default: 'shuffled.grouping.']
  --p-md-column-values-prefix TEXT
                         Prefix to use in naming the values in the shuffled
                         metadata columns.            [default: 'fake.group.']
  --p-encode-sample-size / --p-no-encode-sample-size
                         If true, the sample size of each metadata group will
                         be appended to the shuffled metadata column values.
                                                              [default: False]
Outputs:
  --o-shuffled-groups ARTIFACT SampleData[ArtificialGrouping]
                         Randomized metadata columns                [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.metadata.methods import shuffle_groups

Docstring:

Shuffle values in a categorical sample metadata column.

Create one or more categorical sample metadata columns by shuffling the
values in an input metadata column. To avoid confusion, the column name and
values will be derived from the provided prefixes. The number of different
values (or groups), and the counts of each value, will match the input
metadata column but the association of values with sample ids will be
random. These data will be written to an artifact that can be used as
sample metadata.

Parameters
----------
metadata : MetadataColumn[Categorical]
    Categorical metadata column to shuffle.
n_columns : Int, optional
    The number of shuffled metadata columns to create.
md_column_name_prefix : Str, optional
    Prefix to use in naming the shuffled metadata columns.
md_column_values_prefix : Str, optional
    Prefix to use in naming the values in the shuffled metadata columns.
encode_sample_size : Bool, optional
    If true, the sample size of each metadata group will be appended to the
    shuffled metadata column values.

Returns
-------
shuffled_groups : SampleData[ArtificialGrouping]
    Randomized metadata columns