test.diff.binding {DBChIP} | R Documentation

## Test for differential binding

### Description

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

### Usage

    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`

[Package DBChIP version 1.31.0 Index]