meanEqualityTests.compareSignifFeatures: Return a contingency table for several tests with a...

Description Usage Arguments Details Value Author(s) Examples

Description

Compare the significant features returned by two or more tests in an object returned by meanEqualityTest(), and plot the result in the form of a Venn diagram.

Usage

1
2
3
meanEqualityTests.compareSignifFeatures(mnEqlT.result, selected.tests = NULL,
  signif.score = "fdr", alpha = 0.05, plot.venn = FALSE,
  plot.tree = FALSE, hclust.method = "average", plot.heatmap = FALSE, ...)

Arguments

mnEqlT.result

A result of stats4bioinfo::meanEqualityTests()

...

Additional arguments are passed to plot().

selected.tests=NULL

Tests to compare. If NULL, all available tests are compared.

signif.score="fdr"

Score on which the alpha threshold should be applied (Supported: fdr, p.value, e.value)

alpha=0.01

Significance threshold (will be applied on corrected p-values)

plot.venn=FALSE

Plot a Venn diagram with the result.

plot.tree=FALSE

Plot a hierarchical tree indicating relationships between tests.

hclust.method="average"

Hierarchical clustering method (passed to hclust).

plot.heatmap=FALSE

Plot a heatmap (in gray scale) highlighting the similarity between feature lists.

Details

First version: 2015-03 Last modification: 2015-03

Value

A list containing the following fields:

selected.per.test

A dataframe with Boolean values indicating the status (significant or not) for each row (feature) of the input dataset.

contingency

A contingency table indicating the number of features (rows) passing the significance threshold for each pair of tests. The diagonal of this contingency table indicates the number of significant features for each individual test.

Author(s)

Jacques van Helden (Jacques.van-Helden@univ-amu.fr)

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
## We forward to meanEqualityTests() for examples of utilization
example(meanEqualityTests)

## Compare 2-group mean equality test results with 1% threshold on FDR
test.compa.2groups <- meanEqualityTests.compareSignifFeatures(diff.results,
                                                    selected.tests=c("student", 
                                                                     "welch", 
                                                                     "wilcoxon"),
                                                    signif.score="fdr",
                                                    alpha=0.01,
                                                    plot.venn=TRUE)
summary(test.compa.2groups)
print(test.compa.2groups$contingency)

## Compare multi-group mean equality test results with a threshold of 1 on the 
## e-value (accept one false positive per analysis)
test.compa.ngroups <- meanEqualityTests.compareSignifFeatures(diff.results,
                                                    selected.tests=c("anova", 
                                                                     "kruskal"),
                                                    signif.score="e.value",
                                                    alpha=1)   
                                                    
## Compare all the mean equality test results with a threshold of 1 on the 
## e-value (accept one false positive per analysis)
test.compa <- meanEqualityTests.compareSignifFeatures(diff.results,
                                                      selected.tests=c("student", 
                                                                       "welch", 
                                                                       "wilcoxon",
                                                                       "anova", 
                                                                       "kruskal"),
                                                      signif.score="e.value",
                                                      alpha=1,
                                                      plot.venn=FALSE,
                                                      plot.tree=FALSE,
                                                      hclust.method="average",
                                                      main="Common significant probesets",
                                                      xlab="Differential method",
                                                      ylab="Jaccard distance",
                                                      plot.heatmap=TRUE)   
                                                      
                                                                                                                                                        )
summary(test.compa)
print(test.compa$contingency)

jvanheld/stats4bioinfo documentation built on May 20, 2019, 5:16 a.m.