enrich.mrf: Detection of enriched and differentially bound regions for...

In enRich: Analysis of Multiple ChIP-Seq Data

Description

enrich.mrf returns the enriched regions or differentially bound regions using the mrf or the mrf.joint model, by controlling a given FDR level. enrich.mrf also calculates the IP efficiencies for each experiment.

Usage

enrich.mrf(object, analysis = "joint", differential = FALSE, 
    diff.vec = NULL, cr = 0.05, crdiff = 0.05)

Arguments

object	The output of mrf if analysis="separate" or of mrf.joint if analysis="joint".
analysis	A character variable. Default value is "joint" and the object should be the output of mrf.joint. If analysis="separate", then the object should be the output of mrf.
differential	A logical variable. If TRUE, the function will compute the posterior probability of differential binding of any two experiments or two conditions, as specified by diff.vec. Default value is FALSE.
diff.vec	A numeric vector. If differential = TRUE, diff.vec must be given to show which experiments are to be used in the comparison. At the moment, this is restricted to two conditions (e.g. two proteins at the same time point), so the value for diff.vec should be only 0, 1, 2, where 0 indicates which experiments are not to be used in the analysis, 1 and 2 stand for conditions 1 and 2, respectively. diff.vec should be of the same length as the number of experiments in object.
cr	A numeric variable. The level of FDR for identifying the enriched regions.
crdiff	A numeric variable. The level of FDR for identifying the differentially bound regions.

Value

enrich	The list of enriched regions for each condition at the chosen FDR. Note that there is only one list of enriched regions for replicates, if a joint model is used.
diffenrich1	The list of regions bound only by condition 1.
diffenrich2	The list of regions bound only by condition 2.
X	A n x p matrix of enrichment for each region and each condition, at the given FDR cutoff (1: enriched, 0: not-enriched).
diffprob1	A n-dimensional vector of posterior probabilities of differential binding for the two conditions under study; diffprob0=1-diffprob1.
diffX1	A n-dimensional index of regions bound only by condition 1 (0: not bound, 1: bound).
diffX2	A n-dimensional index of regions bound only by condition 2.
IPE	A p-dimensional vector of estimated IP efficiency values for each experiment.

Author(s)

Yanchun Bao and Veronica Vinciotti

References

Bao et al. Joint modelling of ChIP-seq data via a Markov random field model, Biostatistics 2014, 15(2):296-310 DOI:10.1093/biostatistics/kxt047.

See Also

See also mrf, mrf.joint

enRich documentation built on March 13, 2020, 2:46 a.m.