jointLRTTestWrapper: Wrapper function to test for equality of mean or variance by...

In diffMeanVar: Detecting Gene Probes with Different Means or Variances Between Two Groups

Description

Wrapper function to test for equality of mean or variance by using likelihood ratio test for whole genome.

Usage

jointLRTTestWrapper(
  es, 
  grpVar = "group", 
  esFlag = "es", 
  pvalAdjMethod = "fdr", 
  alpha = 0.05, 
  nTop = 20, 
  probeID.var = "ProbeID", 
  gene.var = "Symbol", 
  chr.var = "Chromosome", 
  applier = lapply, 
  verbose = FALSE)

Arguments

es	An ExpressionSet object storing gene expression/DNA methylation data, phenotype data, and feature annotation.
grpVar	character string. The name of the phenotype variable indicating arrays' group membership. 0 means control and 1 means case.
esFlag	character string. Indicating if es is an ExpressionSet object or MethylSet object. The program will use exprs function to extract gene expression data or use betas function to extract methylation data.
pvalAdjMethod	character string. Indicating which p-value adjustment will be used to control for multiple testing.
alpha	numeric. Cutoff for p-value or adjusted p-value to determine if a probe is diferentially variable.
nTop	integer. Specifying the number of top probes to be displayed if verbose=TRUE
probeID.var	character string. Feature annotation variable indicating probe ID.
gene.var	character string. Feature annotation variable indicating gene symbol.
chr.var	character string. Feature annotation variable indicating chromosome number.
applier	function name to do apply operation.
verbose	logical. Indicating if intermediate results should be output to screen.

Value

A list of 2 elements. The first element frame is unsorted data frame; the second element frame.s is a sorted data frame object storing the analysis results and containing the following columns: probe (probe id), stat (test statistic), pval (raw p-value), p.adj (adjusted p-value), gene (gene symbol), chr (chromosome number), and pos (position of a probe in unsorted data frame).

The data frame is sorted based on the descending order of the absolute value of the test statistic.

Author(s)

Xuan Li <[e-mail]>, Weiliang Qiu <[e-mail]>, Yuejiao Fu <[e-mail]>, Xiaogang Wang <[e-mail]>

References

Li X, Qiu W, Morrow J, DeMeo DL, Weiss ST, Fu Y, Wang X. (2015) A Comparative Study of Tests for Homogeneity of Variances with Application to DNA Methylation Data. PLoS ONE 10(12): e0145295. PMID: 26683022

Qiu W, Li X, Morrow J, DeMeo DL, Weiss ST, Wang X, Fu Y. New Score Tests for Equality of Variances in the Application of DNA Methylation Data Analysis [Version 2]. Insights Genet Genomics. (2017) 1: 3.2

Li X, Qiu W, Fu Y, Wang X. (2017) Robust Joint Score Tests in the Application of DNA Methylation Data Analysis. In submission.

Examples

  
    # generate simulated data set from t distribution
    set.seed(1234567)
    es.sim = genSimData.tDistr(nCpGs = 100, nCases = 20, nControls = 20,
      df0 = 10, ncp0 = 0, df1 = 6, ncp1 = 2.393, testPara = "both",
      eps = 1.0e-3, applier = lapply) 
    print(es.sim)
    
    res.jointLRTTestWrapper = jointLRTTestWrapper(
      es = es.sim,
      grpVar = "memSubj",
      esFlag = "es", 
      pvalAdjMethod = "fdr",
      alpha = 0.05,
      nTop = 20,
      probeID.var = "probe",
      gene.var = "gene",
      chr.var = "chr",
      applier=lapply,
      verbose=TRUE)

  

diffMeanVar documentation built on May 2, 2019, 2:54 a.m.