1 Basics

1.1 Install brainflowprobes

R is an open-source statistical environment which can be easily modified to enhance its functionality via packages. brainflowprobes is an R package available via the Bioconductor repository for packages. R can be installed on any operating system from CRAN after which you can install brainflowprobes by using the following commands in your R session:

if (!requireNamespace("BiocManager", quietly = TRUE)) {
    install.packages("BiocManager")
}

BiocManager::install("brainflowprobes")

## Check that you have a valid Bioconductor installation
BiocManager::valid()

## If you want to force the installation of the development version, you can
## do so by running. However, we suggest that you wait for Bioconductor to
## run checks and build the latest release.
BiocManager::install("LieberInstitute/brainflowprobes")

1.2 Required knowledge

brainflowprobes is based on many other packages, particularly GenomicRanges, derfinder, and derfinderPlot. A brainflowprobes user is not expected to deal with those packages directly, but may find their manuals useful.

If you are asking yourself the question “How do I start using Bioconductor?” you might be interested in this blog post.

1.3 Asking for help

The blog post quoted above mentions some options, but we would like to highlight the Bioconductor support site as the main resource for getting help: remember to use the brainflowprobes tag and check the older posts. Other alternatives are available such as creating GitHub issues and tweeting. However, please note that if you want to receive help you should adhere to the posting guidelines. It is particularly critical that you provide a small reproducible example and your session information so package developers can track down the source of the error.

1.4 Citing brainflowprobes

We hope that brainflowprobes will be useful for your research. Please use the following information to cite the package and the overall approach. Thank you!

## Citation info
citation("brainflowprobes")
## To cite package 'brainflowprobes' in publications use:
## 
##   Price AJ (2023). _Plots and annotation for choosing BrainFlow target
##   probe sequence_. doi:10.18129/B9.bioc.brainflowprobes
##   <https://doi.org/10.18129/B9.bioc.brainflowprobes>,
##   https://github.com/LieberInstitute/brainflowprobes - R package
##   version 1.16.0,
##   <http://www.bioconductor.org/packages/brainflowprobes>.
## 
## A BibTeX entry for LaTeX users is
## 
##   @Manual{,
##     title = {Plots and annotation for choosing BrainFlow target probe sequence},
##     author = {Amanda J Price},
##     year = {2023},
##     url = {http://www.bioconductor.org/packages/brainflowprobes},
##     note = {https://github.com/LieberInstitute/brainflowprobes - R package version 1.16.0},
##     doi = {10.18129/B9.bioc.brainflowprobes},
##   }

2 Introduction

brainflowprobes is an R package that contains four functions to aid in designing probes to target RNA sequences in nuclei isolated from human postmortem brain using flow cytometry. brainflowprobes was made to support the method described in the BrainFlow publication, which is based on the Invitrogen PrimeFlow&#174 RNA kit.

2.1 Notes before starting

This package is currently only compatible with hg19 sequences. Also, because of the type of data used, the plotting functions plot_coverage() and four_panels() do not work on Windows machines. To visualize the data, please use R installed on either Mac or Linux operating systems. The region_info() function can still be used on Windows machines for creating an annotated .csv file to get the information required for custom probe synthesis.

3 Choosing candidate RNA sequences

Which genes you choose to target will ultimately depend on the purpose of your experiment. BrainFlow can be used to isolate specific cell populations for downstream sequencing, for instance, or to assess the coexpression of up to four transcripts at a time at single-nucleus resolution. For the highest probability of success, however, several parameters should be considered when choosing a sequence to target, no matter the purpose. Target sequences are more likely to be successful if they:

  • Are at least 1kb of contiguously expressed sequence (mandatory)
  • Are as highly expressed a target as possible (within the cell population of interest)
  • Are as highly expressed in nuclear RNA as possible
  • Are selectively expressed in the cell population of interest
  • Are robust to degradation due to postmortem factors
  • Avoid splice junctions if it can be helped (given that we’re profiling nuclear RNA)

More details about probe design and each of these considerations can be found in the BrainFlow manuscript. One strategy for choosing a sequence could be to choose the 3’UTR of a transcript of interest. Another strategy (and how many of the probes already validated in the BrainFlow manuscript were designed) is to identify expressed regions using the derfinder package. However you choose which sequences to test, the brainflowprobes package will help narrow down the best sequences for which to synthesize target probes.

4 Annotating a candidate sequence

Let’s say you want to design a probe to target deep layer pyramidal neurons in the prefrontal cortex. You choose TBR1 because of its role in neuronal identity specification in these cells, and you want to see if the last exon of this gene, a ~2.5 Kb sequence, would make for a good probe target. You find using the UCSC Genome browser (for instance) that the hg19 coordinates for this exon are chr2:162279880-162282378:+, where chr2 is the chromosome, 162279880-162282378 is the start and end of the exon, and + means that it is on the plus strand.

Before any of the brainflowprobes functions can be used, the package must be loaded and attached:

## Load brainflowprobes R package
library("brainflowprobes")

The next step is to use the region_info() function to annotate the sequence in a .csv file that can be used to custom synthesize a target probe:

region_info("chr2:162279880-162282378:+", CSV = FALSE, SEQ = TRUE, OUTDIR = ".")
## loading from cache
## require("GenomicRanges")
## Completed! If CSV=TRUE, check for region_info.csv in the temporary
## directory (i.e. tempdir()) unless otherwise specified in OUTDIR.
##   seqnames     start       end width strand name          annotation
## 1     chr2 162279880 162282378  2499      + TBR1 NM_006593 NP_006584
##   description region distance   subregion insideDistance exonnumber nexons
## 1 inside exon inside     7072 inside exon              0          3      3
##              UTR geneL codingL          Geneid
## 1 overlaps 3'UTR  9573    7816 ENSG00000136535
##                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              Sequence
## 1 GATCTACACCGGCTGTGACATGGACCGCCTGACCCCCTCGCCCAACGACTCGCCGCGCTCGCAGATCGTGCCCGGGGCCCGCTACGCCATGGCCGGCTCTTTCCTGCAGGACCAGTTCGTGAGCAACTACGCCAAGGCCCGCTTCCACCCGGGCGCGGGCGCGGGCCCCGGGCCGGGTACGGACCGCAGCGTGCCGCACACCAACGGGCTGCTGTCGCCGCAGCAGGCCGAGGACCCGGGCGCGCCCTCGCCGCAACGCTGGTTTGTGACGCCGGCCAACAACCGGCTGGACTTCGCGGCCTCGGCCTATGACACGGCCACGGACTTCGCGGGCAACGCGGCCACGCTGCTCTCTTACGCGGCGGCGGGCGTGAAGGCGCTGCCGCTGCAGGCTGCAGGCTGCACTGGCCGCCCGCTCGGCTACTACGCCGACCCGTCGGGCTGGGGCGCCCGCAGTCCCCCGCAGTACTGCGGCACCAAGTCGGGCTCGGTGCTGCCCTGCTGGCCCAACAGCGCCGCGGCCGCCGCGCGCATGGCCGGCGCCAATCCCTACCTGGGCGAGGAGGCCGAGGGCCTGGCCGCCGAGCGCTCGCCGCTGCCGCCCGGCGCCGCCGAGGACGCCAAGCCCAAGGACCTGTCCGATTCCAGCTGGATCGAGACGCCCTCCTCGATCAAGTCCATCGACTCCAGCGACTCGGGGATTTACGAGCAGGCCAAGCGGAGGCGGATCTCGCCGGCCGACACGCCCGTGTCCGAGAGTTCGTCCCCGCTCAAGAGCGAGGTGCTGGCCCAGCGGGACTGCGAGAAGAACTGCGCCAAGGACATTAGCGGCTACTATGGCTTCTACTCGCACAGCTAGGCCGCCCCTGCCCGCCCGGCCCCGCCGCGGCCCGGACCCCCAGCCAGCCCCTCACAGCTCTTCCCCAGCTCCGCCTCCCCACACTCCTCCTTGCGCACCCACTCATTTTATTTGACCCTCGATGGCCGTCTGCAGCGAATAAGTGCAGGTCTCCGAGCGTGATTTTAACCTTTTTTGCACAGCAGTCTCTGCAATTAGCTCACCGACCTTCAACTTTGCTGTAAACCTTTTGGTTTTCCTACTTACTCTTCTTCTGTGGAGTTATCCTCCTACAATTCCCCTCCCCCTCGTCTTTCTCTTACCTCCTACTTCTCTTTCTTGTAATGAAACTCTTCACCTTTAGGAGACCTGGGCAGTCCTGTCAGGCAGCAGCGATTCCGACCCGCCAAGTCTCGGCCTCCACATTAACCATAGGATGTTGACTCTAGAACCTGGACCCACCCAGCGCGTCCTTTCTTATCCCCGAGTGGATGGATGGATGGATGGATGGTAGGGATGTTAATAATTTTAGTGGAACAAAGCCTGTGAAATGATTGTACATAGTGTTAATTTATTGTAACGAATGGCTAGTTTTTATTCTCGTCAAGGCACAAAACCAGTTCATGCTTAACCTTTTTTTCCTTTCCTTTCTTTGCTTTTCTTTCTCTCCTCTCATACTTTCTCTTCTCTCTCTTTTAATTTTCTTGTGAGATAATATTCTAAGAGGCTCTAGAAACATGAAATACTCAGTAGTGATGGGTTTCCCACTTCTCCTCAATCCGTTGCATGAAATAATTACTATGTGCCCTAATGCACACAAATAGCTAAGGAGAATCCACCCAAACACCTTTAAAGGATAGGTGTCTGTTCATAGGCAAGTCGATTAAGTGGCATGATGCCTGCAAAGCAAAGTCAACTGGAGTTGTATGTTCCCCCCACCTTCTAAATAGAATAGCTCGACATCAGCAATATTATTTTGCCTTATTTGTTTTTCCCCAAAGTGCCAAATCCATTACTGGTCTGTGCAGGTGCCAAATATGCTGACAAACTGTTTCTGAATATCTTTCAGTACCCCTTCACCTTTATATGCTGTAAATCTTTGTAATGAATACTCTATTAATGATATAGATGACTGAATTGTTGGTAACTATAGTGTAGTCTAGTGAAGATGAATTGTGTGAGTTGTATATTTTACTGCATTTTAGTTTTGAAAATGACTTCCCCACCACCTAGAAACAGCTGAAATTTGACTTCCTTGGGAGAACACTAGCATTAATGCAAGTAAGACTGATTTTCCCCTAAGTCTTGTTATATTTGATAAGGAGCATTAATCCCCCTGGAAATAGATTAGTAGGATTTCTAATGTTGTGTAGCAAACCTATACTTTTTTGTATTTAAAAATTAATGTGAAATATGCATCATACACAATATTCAATCTAGATTCCAGTCCATGGGGGGATTTTTCCTAATAGGAATTCAGGGTCTAAACGTGTGTATATTTTGGCTCTTCTGTAAATCTAATGTTGTGATTTTTATATTTGTTTCGTTTTGTCTGTGAACTGAATAATTTATACAAGAACACACTCCATTGAGAAACGTTTTGTTTTTTGCTCGTTTGTATCGTCTGTGTATAACAAGTAAAATAAACCTGGTAAAAACGC

This function will annotate the specified genomic regions (sequences) by calling the matchGenes() function from the bumphunter package. The output is a table where the first six columns include the coordinates (chromosome, start, end, and strand), region width, and the name of the nearest gene. The proceeding columns list further information about the nearest gene and where the region is in relation to that gene. These columns are described in the documentation for matchGenes(), reprinted below:

Column Description
annotation RefSeq ID
description a factor with levels c(“upstream”, “promoter”, “overlaps 5’”, “inside intron”, “inside exon”, “covers exon(s)”, “overlaps exon upstream”, “overlaps exon downstream”, “overlaps two exons”, “overlaps 3’”, “close to 3’”, “downstream”, “covers”)
region a factor with levels c(“upstream”, “promoter”, “overlaps 5’”, “inside”, “overlaps 3’”, “close to 3’”, “downstream”, “covers”)
distance distance before 5’ end of gene
subregion a factor with levels c(“inside intron”, “inside exon”, “covers exon(s)”, “overlaps exon upstream”, “overlaps exon downstream”, “overlaps two exons”)
insideDistance distance past 5’ end of gene
exonnumber which exon
nexons number of exons
UTR a factor with levels c(“inside transcription region”, “5’ UTR”, “overlaps 5’ UTR”, “3’UTR”, “overlaps 3’UTR”, “covers transcription region”)
geneL the gene length
codingL the coding length
Entrez Entrez ID of closest gene

If CSV = TRUE, a file called region_info.csv will be printed in your working directory, unless another location and file name are listed in the OUTDIR option. It is important that chr preceeds the chromosome number, that the sequence is hg19, and that the candidate coordinates are encased in quotation marks (this tells R that it should read the coordinates as a character class). The output of this function is what can be sent to Invitrogen to specify the sequences you would like to be targeted.

5 Plotting expression coverage across a candidate region

brainflowprobes includes two functions that visualize expression information about candidate target regions based on four external datasets. Coverage data for these external datasets are stored online as BigWig tracks that unfortunately cannot be called using R on a Windows operating system. For users with Mac or Linux machines, expression of candidate regions in these datasets can be loaded and visualized using plot_coverage() and four_panels().

plot_coverage() uses the getRegionCoverage() function from the derfinder package to cut the coverage values for region(s) of interest (specified in the REGION option) in a set of nuclear (N) and cytoplasmic (C) RNA-seq samples derived from adult (A) and fetal (F) human cortex. In this dataset, two different RNA-seq libraries based on either polyA-enrichment (P) or rRNA depletion (R) were generated and sequenced for each fraction-age pair, resulting in eight groups of samples. Optimal candidate target probe sequences will be highly and uniformly expressed across the region.

plot_coverage("chr2:162279880-162282378:+",
    PDF = "regionCoverage_fractionedData.pdf",
    OUTDIR = ".",
    COVERAGE = NULL, VERBOSE = FALSE
)

In this example, this exon is highly expressed in both nuclear and cytoplasmic RNA but is not uniformly expressed. 2.5 Kb (the length of this exon) is longer than the minimum for probe synthesis, so we can limit the coordinates to exclude the lower-expressed sequence:

plot_coverage("chr2:162280900-162282378:+",
    PDF = "regionCoverage_fractionedData_shorter.pdf",
    OUTDIR = ".",
    COVERAGE = NULL, VERBOSE = FALSE
)

These new coordinates are now evenly expressed across a ~1.5 Kb region.

6 Assessing other parameters for a candidate region using four_panels()

Calculating coverage can take several minutes depending on the number of candidate regions being assessed. The coverage can also be pre-computed outside the context of the plotting functions using brainflowprobes_cov(), and then specified in the COVERAGE parameter of either plot_coverage() or four_panels().

tbr1.cov <- brainflowprobes_cov("chr2:162280900-162282378:+", VERBOSE = FALSE)

This example takes ~10 minutes to run. The resulting tbr1.cov object includes a list for each of the four external datasets of coverage across each region being assayed. In this case, coverage at each of the 1479 bases of the TBR1 exon is reported for each sample of the four datasets.

A snapshot of coverage, degradation and cell type specificity can be visualized using the four_panels() function:

four_panels("chr2:162280900-162282378:+",
    PDF = "four_panels.pdf",
    OUTDIR = ".",
    JUNCTIONS = FALSE,
    COVERAGE = tbr1.cov, VERBOSE = FALSE
)

The upper left panel (Separation) shows a boxplot of the mean transformed coverage value across the 1.5 Kb region in the fractionated data used by plot_coverage described above. This region is expressed at about the same level in both nuclear (N) and cytoplasmic (C) samples, making this a good candidate so far.

The upper right panel (Degradation) plots the mean transformed coverage in cortical tissue samples left on a benchtop at room temperature for 0-60 minutes (x-axis) before RNA extraction and sequencing using either polyA selection (“polyA”) or rRNA depletion (“Ribo”) library preparation kits. Expression coverage of this region does not reduce after an hour at room temperature, meaning that this sequence may be a good candidate for target probe synthesis.

The lower left panel (Sorted) shows expression of the region in nuclear RNA that has been sorted based on NeuN antibody labeling and sequenced using two library preparation strategies: polyA selection (“PolyA”) or rRNA depletion (“RiboGone”). NeuN+ (positive) samples are enriched for neurons, while NeuN- (negative) samples are enriched for non-neurons such as the subclasses of glia or epithelial cells. Although these samples were collected using a different protocol, as products of flow cytometric sorting of postmortem brain tissue, they provide insight to the level of detectable expression that may be expected from sorted nuclear RNA. If your target gene is cell type-specific (such as TBR1), it can also be used as a sanity check for the expected neuronal-enriched expression pattern of that gene.

The lower right panel (Single Cells) shows the expression of the region in 466 single cells isolated from human cortex or hippocampus and can be used to verify the cell type-specificity of the expression pattern, should you be interested in a cell type-specific target. In the case of the 6th exon of TBR1, it is selectively expressed in quiescent fetal brain cells and a subset of adult neurons, as is expected given its biological role.

After generating these plots, one can conclude that chr2:162280900-162282378:+ is a strong candidate for a target probe. To design a custom probe, go to https://www.thermofisher.com/order/custom-oligo/brancheddna. Enter the name of the probe (e.g., TBR1_exon6), choose ‘Prime Flow’ as the chemistry, ‘RNA’ as the target, and your desired fluorophore. We recommend shoowing Alexa Fluor 647 as it is the brightest and will offer the greatest chance of success. Choose ‘[Hs] Human’ as the species, and copy the sequence from region_info.csv to the target information. In the comment field, mention that this probe is for targeting nuclear RNA from human postmortem brain using BrainFlow application of the Invitrogen PrimeFlow&#174 RNA assay.

Even though it appears to be a good candidate however, it must still be validated experimentally.

7 Assessing many candidate sequences at a time

Say rather than one candidate you have a list of differentially expressed regions that are upregulated in your cell population of interest and you want to see which would make the best BrainFlow target probes. In this case, you can input a list of coordinates:

candidates <- c(
    "chr2:162279880-162282378:+",
    "chr11:31806351-31811553",
    "chr7:103112236-103113354"
)

region_info(candidates, CSV = FALSE, SEQ = FALSE)
## loading from cache
## Completed! If CSV=TRUE, check for region_info.csv in the temporary
## directory (i.e. tempdir()) unless otherwise specified in OUTDIR.
##   seqnames     start       end width strand         name
## 1     chr2 162279880 162282378  2499      +         TBR1
## 2    chr11  31806351  31811553  5203      *         ELP4
## 3     chr7 103112236 103113354  1119      * LOC101927870
##                                                                annotation
## 1                                                     NM_006593 NP_006584
## 2 NM_001288725 NM_001288726 NM_019040 NP_001275654 NP_001275655 NP_061913
## 3                                                               NR_110141
##     description region distance     subregion insideDistance exonnumber nexons
## 1   inside exon inside     7072   inside exon              0          3      3
## 2   inside exon inside   275049   inside exon              0         25     25
## 3 inside intron inside    26582 inside intron         -25120          2      4
##                           UTR  geneL codingL          Geneid
## 1              overlaps 3'UTR   9573      NA ENSG00000136535
## 2                       3'UTR 280570      NA ENSG00000109911
## 3 inside transcription region  68800      NA ENSG00000234715

Each candidate target probe region will be output as a row in the region_info.csv table.

When multiple regions are assessed concurrently using plot_coverage() and four_panels(), each region will be plotted and saved as individual pages in a pdf. It is recommended to not assess more than 50 or so regions as a time because of size and ease of interpretibility. An example would look like this (this example won’t run in this vignette to keep loading time down):

plot_coverage(candidates,
    PDF = "regionCoverage_fractionedData_multiple.pdf", OUTDIR = "."
)

four_panels(candidates, PDF = "four_panels_multiple.pdf", OUTDIR = ".")

8 Spanning splice junctions

Sometimes a gene may be too short to avoid a sequence that spans splice junctions, or you may be interested in creating a target probe that matches a probe that has been designed for another assay (sich as FISH). In this case, the start and end of the entire spliced sequence can be used as input to both region_info() and plot_coverage(). Because four_panels() averages the coverage across each candidate region, you want to exclude intron sequence. In this case, you may input the coordinates of the exons within a transcript of interest and specify that JUNCTIONS = TRUE. For instance, when designing a probe for PENK we wanted to target bases 2-1273 of NM_001135690.2 to match another probe from a different assay. From the UCSC genome browser, one can identify the coordinates of the exons within this transcript:

PENK_exons <- c(
    "chr8:57353587-57354496:-",
    "chr8:57358375-57358515:-",
    "chr8:57358985-57359040:-",
    "chr8:57359128-57359292:-"
)

four_panels(PENK_exons, JUNCTIONS = TRUE, PDF = "PENK_panels.pdf")

By specifying JUNCTIONS = TRUE, four_panels() will average the coverage of the four exons rather than plotting each exon on an individual pdf page.

9 Final considerations

Depending on the length of the target sequence, you may be able to synthesize a high sensitivity probe that includes 20 rather than 10 target-hybridizing pairs (See BrainFlow methods or the PrimFlow RNA literature for more information).

Also, it is worth noting that there are no hard cutoffs for what will work as a probe in the assay even if all the data looks as it should. All custom target probes designed using these plots will ultimately have to be validated at the bench.

Good luck and happy sorting!

10 Reproducibility

The brainflowprobes package was made possible thanks to:

Code for creating the vignette

## Create the vignette
library("rmarkdown")
system.time(render("brainflowprobes-vignette.Rmd", "BiocStyle::html_document"))

## Extract the R code
library("knitr")
knit("brainflowprobes-vignette.Rmd", tangle = TRUE)

Date the vignette was generated.

## [1] "2023-10-24 16:31:58 EDT"

Wallclock time spent generating the vignette.

## Time difference of 33.633 secs

R session information.

## ─ Session info ───────────────────────────────────────────────────────────────────────────────────────────────────────
##  setting  value
##  version  R version 4.3.1 (2023-06-16)
##  os       Ubuntu 22.04.3 LTS
##  system   x86_64, linux-gnu
##  ui       X11
##  language (EN)
##  collate  C
##  ctype    en_US.UTF-8
##  tz       America/New_York
##  date     2023-10-24
##  pandoc   2.7.3 @ /usr/bin/ (via rmarkdown)
## 
## ─ Packages ───────────────────────────────────────────────────────────────────────────────────────────────────────────
##  package                     * version   date (UTC) lib source
##  abind                         1.4-5     2016-07-21 [2] CRAN (R 4.3.1)
##  AnnotationDbi                 1.64.0    2023-10-24 [2] Bioconductor
##  AnnotationFilter              1.26.0    2023-10-24 [2] Bioconductor
##  AnnotationHub                 3.10.0    2023-10-24 [2] Bioconductor
##  backports                     1.4.1     2021-12-13 [2] CRAN (R 4.3.1)
##  base64enc                     0.1-3     2015-07-28 [2] CRAN (R 4.3.1)
##  bibtex                        0.5.1     2023-01-26 [2] CRAN (R 4.3.1)
##  Biobase                       2.62.0    2023-10-24 [2] Bioconductor
##  BiocFileCache                 2.10.0    2023-10-24 [2] Bioconductor
##  BiocGenerics                * 0.48.0    2023-10-24 [2] Bioconductor
##  BiocIO                        1.12.0    2023-10-24 [2] Bioconductor
##  BiocManager                   1.30.22   2023-08-08 [2] CRAN (R 4.3.1)
##  BiocParallel                  1.36.0    2023-10-24 [2] Bioconductor
##  BiocStyle                   * 2.30.0    2023-10-24 [2] Bioconductor
##  BiocVersion                   3.18.0    2023-10-24 [2] Bioconductor
##  biomaRt                       2.58.0    2023-10-24 [2] Bioconductor
##  Biostrings                    2.70.0    2023-10-24 [2] Bioconductor
##  biovizBase                    1.50.0    2023-10-24 [2] Bioconductor
##  bit                           4.0.5     2022-11-15 [2] CRAN (R 4.3.1)
##  bit64                         4.0.5     2020-08-30 [2] CRAN (R 4.3.1)
##  bitops                        1.0-7     2021-04-24 [2] CRAN (R 4.3.1)
##  blob                          1.2.4     2023-03-17 [2] CRAN (R 4.3.1)
##  bookdown                      0.36      2023-10-16 [2] CRAN (R 4.3.1)
##  brainflowprobes             * 1.16.0    2023-10-24 [1] Bioconductor
##  BSgenome                      1.70.0    2023-10-24 [2] Bioconductor
##  BSgenome.Hsapiens.UCSC.hg19   1.4.3     2023-06-20 [2] Bioconductor
##  bslib                         0.5.1     2023-08-11 [2] CRAN (R 4.3.1)
##  bumphunter                    1.44.0    2023-10-24 [2] Bioconductor
##  cachem                        1.0.8     2023-05-01 [2] CRAN (R 4.3.1)
##  checkmate                     2.2.0     2023-04-27 [2] CRAN (R 4.3.1)
##  cli                           3.6.1     2023-03-23 [2] CRAN (R 4.3.1)
##  cluster                       2.1.4     2022-08-22 [3] CRAN (R 4.3.1)
##  codetools                     0.2-19    2023-02-01 [3] CRAN (R 4.3.1)
##  colorspace                    2.1-0     2023-01-23 [2] CRAN (R 4.3.1)
##  cowplot                       1.1.1     2020-12-30 [2] CRAN (R 4.3.1)
##  crayon                        1.5.2     2022-09-29 [2] CRAN (R 4.3.1)
##  curl                          5.1.0     2023-10-02 [2] CRAN (R 4.3.1)
##  data.table                    1.14.8    2023-02-17 [2] CRAN (R 4.3.1)
##  DBI                           1.1.3     2022-06-18 [2] CRAN (R 4.3.1)
##  dbplyr                        2.3.4     2023-09-26 [2] CRAN (R 4.3.1)
##  DelayedArray                  0.28.0    2023-10-24 [2] Bioconductor
##  derfinder                     1.36.0    2023-10-24 [2] Bioconductor
##  derfinderHelper               1.36.0    2023-10-24 [2] Bioconductor
##  derfinderPlot                 1.36.0    2023-10-24 [2] Bioconductor
##  dichromat                     2.0-0.1   2022-05-02 [2] CRAN (R 4.3.1)
##  digest                        0.6.33    2023-07-07 [2] CRAN (R 4.3.1)
##  doRNG                         1.8.6     2023-01-16 [2] CRAN (R 4.3.1)
##  dplyr                         1.1.3     2023-09-03 [2] CRAN (R 4.3.1)
##  ellipsis                      0.3.2     2021-04-29 [2] CRAN (R 4.3.1)
##  ensembldb                     2.26.0    2023-10-24 [2] Bioconductor
##  evaluate                      0.22      2023-09-29 [2] CRAN (R 4.3.1)
##  fansi                         1.0.5     2023-10-08 [2] CRAN (R 4.3.1)
##  fastmap                       1.1.1     2023-02-24 [2] CRAN (R 4.3.1)
##  filelock                      1.0.2     2018-10-05 [2] CRAN (R 4.3.1)
##  foreach                       1.5.2     2022-02-02 [2] CRAN (R 4.3.1)
##  foreign                       0.8-85    2023-09-09 [3] CRAN (R 4.3.1)
##  Formula                       1.2-5     2023-02-24 [2] CRAN (R 4.3.1)
##  generics                      0.1.3     2022-07-05 [2] CRAN (R 4.3.1)
##  GenomeInfoDb                * 1.38.0    2023-10-24 [2] Bioconductor
##  GenomeInfoDbData              1.2.11    2023-10-17 [2] Bioconductor
##  GenomicAlignments             1.38.0    2023-10-24 [2] Bioconductor
##  GenomicFeatures               1.54.0    2023-10-24 [2] Bioconductor
##  GenomicFiles                  1.38.0    2023-10-24 [2] Bioconductor
##  GenomicRanges               * 1.54.0    2023-10-24 [2] Bioconductor
##  GenomicState                  0.99.15   2023-10-18 [2] Bioconductor
##  GGally                        2.1.2     2021-06-21 [2] CRAN (R 4.3.1)
##  ggbio                         1.50.0    2023-10-24 [2] Bioconductor
##  ggplot2                       3.4.4     2023-10-12 [2] CRAN (R 4.3.1)
##  glue                          1.6.2     2022-02-24 [2] CRAN (R 4.3.1)
##  graph                         1.80.0    2023-10-24 [2] Bioconductor
##  gridExtra                     2.3       2017-09-09 [2] CRAN (R 4.3.1)
##  gtable                        0.3.4     2023-08-21 [2] CRAN (R 4.3.1)
##  Hmisc                         5.1-1     2023-09-12 [2] CRAN (R 4.3.1)
##  hms                           1.1.3     2023-03-21 [2] CRAN (R 4.3.1)
##  htmlTable                     2.4.1     2022-07-07 [2] CRAN (R 4.3.1)
##  htmltools                     0.5.6.1   2023-10-06 [2] CRAN (R 4.3.1)
##  htmlwidgets                   1.6.2     2023-03-17 [2] CRAN (R 4.3.1)
##  httpuv                        1.6.12    2023-10-23 [2] CRAN (R 4.3.1)
##  httr                          1.4.7     2023-08-15 [2] CRAN (R 4.3.1)
##  interactiveDisplayBase        1.40.0    2023-10-24 [2] Bioconductor
##  IRanges                     * 2.36.0    2023-10-24 [2] Bioconductor
##  iterators                     1.0.14    2022-02-05 [2] CRAN (R 4.3.1)
##  jquerylib                     0.1.4     2021-04-26 [2] CRAN (R 4.3.1)
##  jsonlite                      1.8.7     2023-06-29 [2] CRAN (R 4.3.1)
##  KEGGREST                      1.42.0    2023-10-24 [2] Bioconductor
##  knitr                         1.44      2023-09-11 [2] CRAN (R 4.3.1)
##  later                         1.3.1     2023-05-02 [2] CRAN (R 4.3.1)
##  lattice                       0.22-5    2023-10-24 [3] CRAN (R 4.3.1)
##  lazyeval                      0.2.2     2019-03-15 [2] CRAN (R 4.3.1)
##  lifecycle                     1.0.3     2022-10-07 [2] CRAN (R 4.3.1)
##  limma                         3.58.0    2023-10-24 [2] Bioconductor
##  locfit                        1.5-9.8   2023-06-11 [2] CRAN (R 4.3.1)
##  lubridate                     1.9.3     2023-09-27 [2] CRAN (R 4.3.1)
##  magrittr                      2.0.3     2022-03-30 [2] CRAN (R 4.3.1)
##  Matrix                        1.6-1.1   2023-09-18 [3] CRAN (R 4.3.1)
##  MatrixGenerics                1.14.0    2023-10-24 [2] Bioconductor
##  matrixStats                   1.0.0     2023-06-02 [2] CRAN (R 4.3.1)
##  memoise                       2.0.1     2021-11-26 [2] CRAN (R 4.3.1)
##  mime                          0.12      2021-09-28 [2] CRAN (R 4.3.1)
##  munsell                       0.5.0     2018-06-12 [2] CRAN (R 4.3.1)
##  nnet                          7.3-19    2023-05-03 [3] CRAN (R 4.3.1)
##  OrganismDbi                   1.44.0    2023-10-24 [2] Bioconductor
##  pillar                        1.9.0     2023-03-22 [2] CRAN (R 4.3.1)
##  pkgconfig                     2.0.3     2019-09-22 [2] CRAN (R 4.3.1)
##  plyr                          1.8.9     2023-10-02 [2] CRAN (R 4.3.1)
##  png                           0.1-8     2022-11-29 [2] CRAN (R 4.3.1)
##  prettyunits                   1.2.0     2023-09-24 [2] CRAN (R 4.3.1)
##  progress                      1.2.2     2019-05-16 [2] CRAN (R 4.3.1)
##  promises                      1.2.1     2023-08-10 [2] CRAN (R 4.3.1)
##  ProtGenerics                  1.34.0    2023-10-24 [2] Bioconductor
##  purrr                         1.0.2     2023-08-10 [2] CRAN (R 4.3.1)
##  qvalue                        2.34.0    2023-10-24 [2] Bioconductor
##  R6                            2.5.1     2021-08-19 [2] CRAN (R 4.3.1)
##  rappdirs                      0.3.3     2021-01-31 [2] CRAN (R 4.3.1)
##  RBGL                          1.78.0    2023-10-24 [2] Bioconductor
##  RColorBrewer                  1.1-3     2022-04-03 [2] CRAN (R 4.3.1)
##  Rcpp                          1.0.11    2023-07-06 [2] CRAN (R 4.3.1)
##  RCurl                         1.98-1.12 2023-03-27 [2] CRAN (R 4.3.1)
##  RefManageR                  * 1.4.0     2022-09-30 [2] CRAN (R 4.3.1)
##  reshape                       0.8.9     2022-04-12 [2] CRAN (R 4.3.1)
##  reshape2                      1.4.4     2020-04-09 [2] CRAN (R 4.3.1)
##  restfulr                      0.0.15    2022-06-16 [2] CRAN (R 4.3.1)
##  rjson                         0.2.21    2022-01-09 [2] CRAN (R 4.3.1)
##  rlang                         1.1.1     2023-04-28 [2] CRAN (R 4.3.1)
##  rmarkdown                     2.25      2023-09-18 [2] CRAN (R 4.3.1)
##  rngtools                      1.5.2     2021-09-20 [2] CRAN (R 4.3.1)
##  rpart                         4.1.21    2023-10-09 [3] CRAN (R 4.3.1)
##  Rsamtools                     2.18.0    2023-10-24 [2] Bioconductor
##  RSQLite                       2.3.1     2023-04-03 [2] CRAN (R 4.3.1)
##  rstudioapi                    0.15.0    2023-07-07 [2] CRAN (R 4.3.1)
##  rtracklayer                   1.62.0    2023-10-24 [2] Bioconductor
##  S4Arrays                      1.2.0     2023-10-24 [2] Bioconductor
##  S4Vectors                   * 0.40.0    2023-10-24 [2] Bioconductor
##  sass                          0.4.7     2023-07-15 [2] CRAN (R 4.3.1)
##  scales                        1.2.1     2022-08-20 [2] CRAN (R 4.3.1)
##  sessioninfo                 * 1.2.2     2021-12-06 [2] CRAN (R 4.3.1)
##  shiny                         1.7.5.1   2023-10-14 [2] CRAN (R 4.3.1)
##  SparseArray                   1.2.0     2023-10-24 [2] Bioconductor
##  statmod                       1.5.0     2023-01-06 [2] CRAN (R 4.3.1)
##  stringi                       1.7.12    2023-01-11 [2] CRAN (R 4.3.1)
##  stringr                       1.5.0     2022-12-02 [2] CRAN (R 4.3.1)
##  SummarizedExperiment          1.32.0    2023-10-24 [2] Bioconductor
##  tibble                        3.2.1     2023-03-20 [2] CRAN (R 4.3.1)
##  tidyselect                    1.2.0     2022-10-10 [2] CRAN (R 4.3.1)
##  timechange                    0.2.0     2023-01-11 [2] CRAN (R 4.3.1)
##  utf8                          1.2.4     2023-10-22 [2] CRAN (R 4.3.1)
##  VariantAnnotation             1.48.0    2023-10-24 [2] Bioconductor
##  vctrs                         0.6.4     2023-10-12 [2] CRAN (R 4.3.1)
##  withr                         2.5.1     2023-09-26 [2] CRAN (R 4.3.1)
##  xfun                          0.40      2023-08-09 [2] CRAN (R 4.3.1)
##  XML                           3.99-0.14 2023-03-19 [2] CRAN (R 4.3.1)
##  xml2                          1.3.5     2023-07-06 [2] CRAN (R 4.3.1)
##  xtable                        1.8-4     2019-04-21 [2] CRAN (R 4.3.1)
##  XVector                     * 0.42.0    2023-10-24 [2] Bioconductor
##  yaml                          2.3.7     2023-01-23 [2] CRAN (R 4.3.1)
##  zlibbioc                      1.48.0    2023-10-24 [2] Bioconductor
## 
##  [1] /tmp/RtmprvQmMV/Rinst2351792388f447
##  [2] /home/biocbuild/bbs-3.18-bioc/R/site-library
##  [3] /home/biocbuild/bbs-3.18-bioc/R/library
## 
## ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

11 Bibliography

This vignette was generated using BiocStyle (Oleś, 2023) with knitr (Xie, 2014) and rmarkdown (Allaire, Xie, Dervieux et al., 2023) running behind the scenes.

Citations made with RefManageR (McLean, 2017).

[1] J. Allaire, Y. Xie, C. Dervieux, et al. rmarkdown: Dynamic Documents for R. R package version 2.25. 2023. URL: https://github.com/rstudio/rmarkdown.

[2] L. Collado-Torres. Build and access GenomicState objects for use with derfinder tools from sources like Gencode. https://github.com/LieberInstitute/GenomicState - R package version 0.99.15. 2023. DOI: 10.18129/B9.bioc.GenomicState. URL: http://www.bioconductor.org/packages/GenomicState.

[3] L. Collado-Torres, A. E. Jaffe, and J. T. Leek. derfinderPlot: Plotting functions for derfinder. https://github.com/leekgroup/derfinderPlot - R package version 1.36.0. 2017. DOI: 10.18129/B9.bioc.derfinderPlot. URL: http://www.bioconductor.org/packages/derfinderPlot.

[4] L. Collado-Torres, A. Nellore, A. C. Frazee, et al. “Flexible expressed region analysis for RNA-seq with derfinder”. In: Nucl. Acids Res. (2017). DOI: 10.1093/nar/gkw852. URL: http://nar.oxfordjournals.org/content/early/2016/09/29/nar.gkw852.

[5] A. E. Jaffe, P. Murakami, H. Lee, et al. “Bump hunting to identify differentially methylated regions in epigenetic epidemiology studies”. In: International journal of epidemiology 41.1 (2012), pp. 200–209. DOI: 10.1093/ije/dyr238.

[6] M. Lawrence, R. Gentleman, and V. Carey. “rtracklayer: an R package for interfacing with genome browsers”. In: Bioinformatics 25 (2009), pp. 1841-1842. DOI: 10.1093/bioinformatics/btp328. URL: http://bioinformatics.oxfordjournals.org/content/25/14/1841.abstract.

[7] M. Lawrence, W. Huber, H. Pagès, et al. “Software for Computing and Annotating Genomic Ranges”. In: PLoS Computational Biology 9 (8 2013). DOI: 10.1371/journal.pcbi.1003118. URL: http://www.ploscompbiol.org/article/info%3Adoi%2F10.1371%2Fjournal.pcbi.1003118}.

[8] M. W. McLean. “RefManageR: Import and Manage BibTeX and BibLaTeX References in R”. In: The Journal of Open Source Software (2017). DOI: 10.21105/joss.00338.

[9] E. Neuwirth. RColorBrewer: ColorBrewer Palettes. R package version 1.1-3. 2022. URL: https://CRAN.R-project.org/package=RColorBrewer.

[10] A. Oleś. BiocStyle: Standard styles for vignettes and other Bioconductor documents. R package version 2.30.0. 2023. DOI: 10.18129/B9.bioc.BiocStyle. URL: https://bioconductor.org/packages/BiocStyle.

[11] H. Pagès, P. Aboyoun, R. Gentleman, et al. Biostrings: Efficient manipulation of biological strings. R package version 2.70.0. 2023. DOI: 10.18129/B9.bioc.Biostrings. URL: https://bioconductor.org/packages/Biostrings.

[12] R Core Team. R: A Language and Environment for Statistical Computing. R Foundation for Statistical Computing. Vienna, Austria, 2023. URL: https://www.R-project.org/.

[13] T. B. D. Team. BSgenome.Hsapiens.UCSC.hg19: Full genome sequences for Homo sapiens (UCSC version hg19, based on GRCh37.p13). R package version 1.4.3. 2020.

[14] H. Wickham. ggplot2: Elegant Graphics for Data Analysis. Springer-Verlag New York, 2016. ISBN: 978-3-319-24277-4. URL: https://ggplot2.tidyverse.org.

[15] H. Wickham. “testthat: Get Started with Testing”. In: The R Journal 3 (2011), pp. 5–10. URL: https://journal.r-project.org/archive/2011-1/RJournal_2011-1_Wickham.pdf.

[16] H. Wickham, W. Chang, R. Flight, et al. sessioninfo: R Session Information. R package version 1.2.2. 2021. URL: https://CRAN.R-project.org/package=sessioninfo.

[17] C. Wilke. cowplot: Streamlined Plot Theme and Plot Annotations for ‘ggplot2’. R package version 1.1.1. 2020. URL: https://CRAN.R-project.org/package=cowplot.

[18] Y. Xie. “knitr: A Comprehensive Tool for Reproducible Research in R”. In: Implementing Reproducible Computational Research. Ed. by V. Stodden, F. Leisch and R. D. Peng. ISBN 978-1466561595. Chapman and Hall/CRC, 2014.