test.diff.binding: Test for differential binding

Description Usage Arguments Details Value Author(s) References See Also

View source: R/DBChIP.R

Description

A null hypothesis of non-differential binding is tested at each consensus site.

Usage

1
test.diff.binding(dat, lib.size = NULL, dispersion = NULL, common.disp = TRUE, prior.n = 10, two.sample.method = "composite.null", allowable.FC = 1.5, collapsed.quant = 0.5)

Arguments

dat

a list with the item site.count, which is a matrix of read counts at binding sites.

lib.size

a vector of library size of each ChIP sample.

dispersion

The dispersion parameter in Negative Binomial distribution. Could be a numerical value or a vector with a length of the number of consensus sites.

common.disp

logical, TRUE (use common dispersion parameter for all sites) or FALSE (use site-specific dispersion).

prior.n

a parameter regulate the degree of pooling when using site-specific dispersion (common.disp=FALSE).

two.sample.method

the method to use when comparing two condition with no replicates. The default is to test a composite null that allow certain fold change allowable.FC. Otherwise user should provide a dispersion parameter.

allowable.FC

allowable fold change when testing a composite null. Default value 1.5.

collapsed.quant

the quantile to use when testing more than two conditions without replicates. Default value is 0.5, the median.

Details

Users are recommended to study the histogram of the $p$-values for model checking. More specifically, the $p$-values between 0.5 and 1 should be roughly uniform. When many replicates are available, users can also randomly split biological replicates of the same condition and perform comparisons through DBChIP using the estimated dispersion parameter to check whether the $p$-values look uniform.

Value

This function return the incoming dat with new field

test.stat

a data.frame of test statistics for testing non-differential binding at each site, include p-values and fold changes.

Author(s)

Kun Liang, kliang@stat.wisc.edu

References

Liang, K and Keles, S (2012) Detecting differential binding of transcription factors with ChIP-seq, 28, 121-122.

See Also

DBChIP


DBChIP documentation built on Nov. 8, 2020, 8:27 p.m.