File: coverage-methods.Rd

package info (click to toggle)
r-bioc-summarizedexperiment 1.36.0%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 948 kB
  • sloc: makefile: 2
file content (80 lines) | stat: -rw-r--r-- 2,341 bytes parent folder | download | duplicates (5)
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}