View source: R/countGroupedDirection.R
countGroupedDirection | R Documentation |
Count the number of grouped tests that are significant and changing in each direction. Each group of tests is defined according to a grouping factor.
countGroupedDirection(
p.values,
grouping,
effects,
p.threshold = 0.05,
effect.threshold = 0,
method = c("BH", "holm"),
log.p = FALSE
)
p.values |
A numeric vector containing p-values for individual tests. |
grouping |
A vector or factor of length equal to Alternatively, an rle object where each run corresponds to a group and specifies the entries of |
effects |
A numeric vector of length equal to |
p.threshold |
Numeric scalar defining the adjusted p-value threshold at which test is significant. |
effect.threshold |
Numeric scalar defining the threshold at which an effect is “"up"” or “"down"”. |
method |
String specifying how the multiple testing correction within each group is to be performed. |
log.p |
Logical scalar indicating whether the |
We apply a multiple testing correction within each group and define all significant tests as those with adjusted p-values below p.threshold
.
We then count the number of tests with effects greater than effect.threshold
(i.e., going up) or less than the threshold (i.e., going down).
This allows us to quantify the direction of change across the group into two counts.
The output of this function is simpler to interpret than the summarize*Direction
functions.
However, p.threshold
has no clear relationship to the significance threshold applied to the combined p-values.
Groups with many low p-values will have milder multiplicity corrections, resulting in more non-zero counts for both the up
and down
tests;
this often complicates matters by introducing mixed directions of effect, even when the most significant changes in the group are in one direction.
Note that, if log.p=TRUE
, the function will automatically handle the log-transformation of p.threshold
.
A list with the "up"
and "down"
entries.
Both are integer vectors of length equal to the number of groups,
containing the number of significant tests changing each each direction in each group.
Aaron Lun
summarizeGroupedDirection
, for another way to summarize the overall direction into a single string.
countParallelDirection
, for the equivalent function operating on parallel tests.
p <- rbeta(100, 0.5, 1)
eff <- rnorm(100)
g <- sample(20, 100, replace=TRUE)
(dirs <- countGroupedDirection(p, g, eff))
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.