1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80
|
\name{coverage-methods}
\alias{coverage-methods}
\alias{coverage}
\alias{coverage,RangedSummarizedExperiment-method}
\title{Coverage of a RangedSummarizedExperiment object}
\description{
This man page documents the \code{coverage} method for
\link{RangedSummarizedExperiment} objects.
}
\usage{
\S4method{coverage}{RangedSummarizedExperiment}(x, shift=0L, width=NULL, weight=1L,
method=c("auto", "sort", "hash"))
}
\arguments{
\item{x}{
A \link{RangedSummarizedExperiment} object.
}
\item{shift, width, weight, method}{
See \code{?\link[GenomicRanges]{coverage}} in the \pkg{GenomicRanges}
package.
}
}
\details{
This method operates on the \code{rowRanges} component of the
\link{RangedSummarizedExperiment} object, which can be a
\link[GenomicRanges]{GenomicRanges} or \link[GenomicRanges]{GRangesList}
object.
More precisely, on \link{RangedSummarizedExperiment} object \code{x},
\code{coverage(x, ...)} is equivalent to \code{coverage(rowRanges(x), ...)}.
See \code{?\link[GenomicRanges]{coverage}} in the \pkg{GenomicRanges}
package for the details of how \code{coverage} operates on a
\link[GenomicRanges]{GenomicRanges} or \link[GenomicRanges]{GRangesList}
object.
}
\value{
See \code{?\link[GenomicRanges]{coverage}} in the \pkg{GenomicRanges}
package.
}
\seealso{
\itemize{
\item \link{RangedSummarizedExperiment} objects.
\item The \link[GenomicRanges]{coverage} man page in the
\pkg{GenomicRanges} package where the \code{coverage} methods
for \link[GenomicRanges]{GenomicRanges} and
\link[GenomicRanges]{GRangesList} objects are documented.
}
}
\examples{
nrows <- 20; ncols <- 6
counts <- matrix(runif(nrows * ncols, 1, 1e4), nrows)
rowRanges <- GRanges(rep(c("chr1", "chr2"), c(5, 15)),
IRanges(sample(1000L, 20), width=100),
strand=Rle(c("+", "-"), c(12, 8)),
seqlengths=c(chr1=1800, chr2=1300))
colData <- DataFrame(Treatment=rep(c("ChIP", "Input"), 3),
row.names=LETTERS[1:6])
rse <- SummarizedExperiment(assays=SimpleList(counts=counts),
rowRanges=rowRanges, colData=colData)
cvg <- coverage(rse)
cvg
stopifnot(identical(cvg, coverage(rowRanges(rse))))
}
\keyword{methods}
\keyword{utilities}
|