WhamDEFrom16s: workflow Hub for Automated Metagenomic Exploration (WHAM!)

Description Usage Arguments Value Examples

View source: R/Wham.core.R

Description

R package allowing for exploratory analysis of metagenomics and metatranscriptomic data. Includes visualization and statistical analysis on the gene family and taxa level. This package is developped based on package ALDEx2.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
WhamDEFrom16s(
  object = NULL,
  contrast,
  ref.contrast,
  All.contrast,
  taxa.level = c("k", "p", "o", "c", "f", "g", "s", "otu"),
  WhamTransformation = c("count", "WhamTransformation"),
  useMC = F,
  aldex.module = c("t.test", "anova"),
  anova.group
)

Arguments

object

required. Object generated from WhamFromBiobakery, WhamFromEBI or WhamFrom16s.

contrast

Specifying what comparison to extract from the WhamInput. a vector indicates the variable, numerator,and denominator. e.g. contrast = c("group","eye","mouth"). The argument contrast, ref.contrast, and All.contrast can't be declaimed at the same time. If none of three are declaimed, function will use last variable in design as the variable, the first element in the variable as the numerator, and the last element in the variable as the denominator.

ref.contrast

Specifying a reference element in the variable, All other elements in the variable will be processed one vs one comparison (vs reference variable). A vector indicates the variable, denominator. e.g. contrast = c("cytokine","Buffer"). The argument 'contrast', 'ref.contrast', and 'All.contrast' can't be declaimed at the same time. If none of three are declaimed, function will use last element in design as the variable, the first element in the variable as the numerator, and the last element in the variable as the denominator.

All.contrast

Specifying a variable. Every two elements in the variable will be processed one vs one comparison. a vector indicates the variable, denominator. e.g. contrast = c("cytokine"). The argument 'contrast', 'ref.contrast', and 'All.contrast' can't be declaimed at the same time. If none of three are declaimed, function will use last element in design as the variable, the first element in the variable as the numerator, and the last element in the variable as the denominator.

taxa.level

required, c("k","p","o","c","f","g","s"). Collapsing the count to provided taxonomic level. options are "k","p","c","o","f","g","s".Only need to declaimed when argument DE is setup as "taxa". Every taxonimic level has to have "k__","p__","c__","o__","f__","g__",or "s__"

WhamTransformation

c("count","WhamTransformation"). Default value is "count". Setting as "count" uses original count. Setting as WhamTransformation converts count to ratio(count divided by the total sum of each sample), and then times one million( x 1000,000)

useMC

use multicore by default(FALSE). Multi core processing will be attempted with the BiocParallel package, then the parallel package. If neither are installed, serial processing will be used.

aldex.module

c("t.test","anova"), Default value is t.test(Welch's t and Wilcoxon rank test). "anova" will perform glm and Kruskal Wallace tests for one-way ANOVA

anova.group

Specifying what variable in design to be performed anova analysis. if anova.group is NULL, the last variable in design will be used.

Value

a dataframe contains statistic results or a WhamResult object contains statistic results and contrast.

we.ep - Expected P value of Welch's t test

we.eBH - Expected Benjamini-Hochberg corrected P value of Welch's t test

wi.ep - Expected P value of Wilcoxon rank test

wi.eBH - Expected Benjamini-Hochberg corrected P value of Wilcoxon test

rab.all: a vector containing the median clr value for each feature

rab.win.conditionA: a vector containing the median clr value for each feature in condition A

rab.win.conditionB: a vector containing the median clr value for each feature in condition B

diff.btw: a vector containing the per-feature median difference between condition A and B

diff.win: a vector containing the per-feature maximum median difference between Dirichlet instances within conditions

effect: median effect size: diff.btw / max(diff.win) for all instances

overlap: proportion of effect size that overlaps 0 (i.e. no effect)

kw.ep a vector containing the expected p-value of the Kruskal-Wallis test for each feature

kw.eBH a vector containing the corresponding expected value of the Benjamini-Hochberg corrected p-value for each feature

glm.ep a vector containing the expected p-value of the glm ANOVA for each feature

glm.eBH a vector containing the corresponding expected value of the Benjamini-Hochberg corrected p-value for each feature

Examples

1
# see the vignette for more details

zc1286/Wham documentation built on May 14, 2021, 8 p.m.