Options for choose_filter_thresholds(). More...

#include <choose_filter_thresholds.hpp>

Public Attributes
bool	lower = true

bool	upper = true

double	num_mads = 3

double	min_diff = 0

bool	log = false

Detailed Description

Options for choose_filter_thresholds().

Member Data Documentation

◆ lower

bool scran_qc::ChooseFilterThresholdsOptions::lower = true

Should low values be considered as potential outliers? If false, no lower threshold is applied when defining outliers.

◆ upper

bool scran_qc::ChooseFilterThresholdsOptions::upper = true

Should high values be considered as potential outliers? If false, no upper threshold is applied when defining outliers.

◆ num_mads

double scran_qc::ChooseFilterThresholdsOptions::num_mads = 3

Number of MADs to use to define outliers. Larger values result in more relaxed thresholds. By default, we require 3 MADs, which is motivated by the low probability (less than 1%) of obtaining such a value for normally distributed data.

◆ min_diff

double scran_qc::ChooseFilterThresholdsOptions::min_diff = 0

Minimum difference from the median to define outliers. This enforces a more relaxed threshold in cases where the MAD may be too small. If ChooseFilterThresholdsOptions::log = true, this difference is interpreted as a unit on the natural log-scale.

◆ log

bool scran_qc::ChooseFilterThresholdsOptions::log = false

Whether the median and MAD should computed on the log-scale, i.e., FindMedianMadOptions::log = true. (Or, for the overload that accepts a FindMedianMadResult, whether the median and MAD were already computed the log-scale.)

Using a log-transformation instructs the outlier definition to focus on the fold-change from the median. In practice, this is useful for metrics that are always positive and have right-skewed distributions, as the log-transformation symmetrizes the distribution and makes it more normal-like such that the ChooseFilterThresholdsOptions::num_mads interpretation can be applied. It also ensures that the defined threshold is always positive.

If this is true, the reported thresholds are still converted back to the original scale of the metrics.

The documentation for this struct was generated from the following file:

scran_qc/choose_filter_thresholds.hpp