Skip to contents

Add sequence context around positions of interest to a SummarizedExperiment.

Source: R/seqContext.R
addSeqContext.Rd

Convenience function to extract sequence context around positions of interest (the rowRanges of a RangedSummarizedExperiment) and add them the the SummarizedExperiment's row data (rowData(se)$sequence.context). The extracted sequences will correspond to the regions defined as resize(rowRanges(x), width = sequence.context.width, fix = "center". Sequence contexts are extracted using extractSeqContext.

Usage

addSeqContext(x, sequence.context.width, sequence.reference)

Arguments

x

A RangedSummarizedExperiment.

sequence.context.width

A numeric scalar giving the width of the sequence context to be extracted from the reference (sequence.reference argument). This must be an odd number so that the sequence can be centered on the modified base. If sequence.context.width = 0 (the default), no sequence context will be extracted.

sequence.reference

A BSgenome object, or a character scalar giving the path to a fasta formatted file with reference sequences, or a DNAStringSet object. The sequence context (see sequence.context.width argument) will be extracted from these sequences.

Value

A RangedSummarizedExperiment object with sequence contexts added as a DNAStringSet object to rowData(x)$sequence.context.

See also

extractSeqContext

Author

Michael Stadler

Examples

# load package
library(SummarizedExperiment)

# file with sequence in fasta format of length 6957060
reffile <- system.file("extdata", "reference.fa.gz", package = "footprintR")

# define some regions at the end of the reference sequence
se <- SummarizedExperiment(
          assays = matrix(1:3, ncol=1),
          rowRanges = GRanges(
              "chr1", IRanges(start = 6957060 - c(4, 2, 0),
              width = 1, names = c("a","b","c")),
              strand = "-"))

# add sequence context (note the padding with N's)
rowRanges(se)
#> GRanges object with 3 ranges and 0 metadata columns:
#>     seqnames    ranges strand
#>        <Rle> <IRanges>  <Rle>
#>   a     chr1   6957056      -
#>   b     chr1   6957058      -
#>   c     chr1   6957060      -
#>   -------
#>   seqinfo: 1 sequence from an unspecified genome; no seqlengths
se <- addSeqContext(se, 7, reffile)
rowRanges(se)
#> GRanges object with 3 ranges and 1 metadata column:
#>     seqnames    ranges strand | sequence.context
#>        <Rle> <IRanges>  <Rle> |   <DNAStringSet>
#>   a     chr1   6957056      - |          CCCCTTT
#>   b     chr1   6957058      - |          TCCCCTN
#>   c     chr1   6957060      - |          TCCCNNN
#>   -------
#>   seqinfo: 1 sequence from an unspecified genome; no seqlengths