modelMatrixMeth {edgeR} | R Documentation

## Construct Design Matrix for edgeR Analysis of Methylation Count Data

### Description

Construct design matrix (aka model matrix) for edgeR analysis of methylation count data from sample level information.

### Usage

    modelMatrixMeth(object, ...)

### Arguments

`object` | a sample-level design matrix or model formula or terms object.
`...` | any other arguments are passed to `model.matrix`.

### Details

This function computes a design matrix for modeling methylated and unmethylated counts. The resulting design matrix can be input to `glmFit` when analysing BS-seq methylation data using edgeR.

In BS-seq methylation analysis, each DNA sample generates two counts, a count of methylated reads and a count of unmethylated reads, for each genomic locus for each sample. The function converts sample-level information about the treatment conditions to make an appropriate design matrix with two rows for each sample. Counts are assumed to be ordered as methylated and then unmethylated by sample.

If `design.treatments <- model.matrix(object,...)` has `nsamples` rows and `p` columns, then `modelMatrixMeth(object, ...)` has `2*nsamples` rows and `nsamples+p` columns. See Chen et al (2017) for more information.

### Value

A numeric design matrix. It has 2 rows for each sample and a column for each sample in addition to the columns generated by `model.matrix(object, ...)`.

### Author(s)

Gordon Smyth

### References

Chen, Y, Pal, B, Visvader, JE, Smyth, GK (2017). Differential methylation analysis of reduced representation bisulfite sequencing experiments using edgeR. F1000Research 6, 2055. https://f1000research.com/articles/6-2055

### See Also

`model.matrix` in the stats package.

### Examples

    Treatments <- gl(3,2,labels=c("A","B","C"))
    modelMatrixMeth(~Treatments)

    # Equivalent calling sequence:
    design.treatments <- model.matrix(~Treatments)
    modelMatrixMeth(design.treatments)

[Package edgeR version 3.22.5 Index]