calour.amplicon_experiment.AmpliconExperiment.downsample¶

AmpliconExperiment.downsample(field, axis=0, num_keep=None, inplace=False, random_state=None)[source]¶

Downsample the data set.

This down samples all the samples/features to have the same number of samples/features for each categorical value of the field in sample_metadata or feature_metadata.

Parameters:	field (str) – The name of the column in samples metadata table. This column should has categorical values axis (0, 1, 's', or 'f', optional) – 0 or ‘s’ (default) to filter samples; 1 or ‘f’ to filter features num_keep (int or None, optional) – None (default) to downsample to minimal group size. int : downsample to num_keep samples/features per group, drop values with < num_keep inplace (bool, optional) – False (default) to do the filtering on a copy. True to do the filtering on the original `Experiment`
Returns:
Return type:	Experiment