OSCR

RegRegSEA: a web server for regulatory region set enrichment analysis of epigenomic data.

Code ↔ Paper

2 matches between paragraphs of the paper and lines of its authors' code, computed by the harvester (lexical-v1). Click a colored paragraph or line to see its counterpart.

One block of code here has a permanent identifier (oscr:b:…), listed with the matches below: citable for good, with a page of its own. Select a match and press Cite to copy it. What a block identifier is.

The 2 matches
  1. [1] § Results › Case study 1: re-analysis of down syndrome brain methylome ↔ R/plotting.R, lines 134 to 236 · score 0.69 · absolute NES, positive NES, Top enriched, enrichment scores, Bars, enhancers · block oscr:b:BC513E7APQRGR-X · Report a mismatch
  2. [2] § Results › The RegRegSEA web server › Output and visualizations ↔ R/plotting.R, lines 134 to 236 · score 0.69 · positive NES, top enriched, enrichment score, bars, cutoff, FDR · block oscr:b:BC513E7APQRGR-X · Report a mismatch

Paper

Loaded from Europe PMC by your browser; OSCR does not store it: doi.org · Europe PMC

The paper is loaded when this pane is shown.

The authors' code

R · 236 lines · 7.9 KB · MIT · 2 matches

  1. #' Plot Running Enrichment Score
  2. #'
  3. #' Creates a two-panel plot showing the running enrichment score and
  4. #' ranked statistic for a specific region set.
  5. #'
  6. #' @param ranking Named and sorted vector of genomic regions and their ranking score
  7. #' @param region_sets List of region sets (from mapGRangesToRegionSets)
  8. #' @param region_set_name Name of the region set to plot
  9. #' @param title Plot title (optional, defaults to region set name)
  10. #' @param color Color for enrichment score curve (default: "grey40")
  11. #' @return ggplot object with running enrichment score plot
  12. #' @export
  13. #' @importFrom fgsea plotEnrichmentData
  14. #' @importFrom ggplot2 ggplot aes geom_line geom_segment geom_hline geom_tile
  15. #' @importFrom ggplot2 labs theme_classic theme element_blank element_text
  16. #' @importFrom ggplot2 coord_cartesian scale_y_continuous scale_fill_gradient2
  17. #' @importFrom ggplot2 scale_x_continuous guides guide_colorbar margin unit
  18. #' @importFrom patchwork plot_layout
  19. #' @importFrom scales pretty_breaks
  20. #' @examples
  21. #' \dontrun{
  22. #' # Plot running enrichment score for specific region set
  23. #' p <- plotRunningES(ranking, region_sets, "encode_tfbs_CTCF_hg19.bed")
  24. #' print(p)
  25. #' }
  26. plotRunningES <- function(ranking, region_sets, region_set_name,
  27. title = NULL, color = "grey40") {
  28. # Input validation
  29. if (!region_set_name %in% names(region_sets)) {
  30. stop(sprintf("Region set '%s' not found in region_sets", region_set_name))
  31. }
  32. # Get the specific region set
  33. pathway <- region_sets[[region_set_name]]
  34. # Generate plot data using fgsea's function
  35. plot_data <- plotEnrichmentData(
  36. pathway = pathway,
  37. stats = ranking,
  38. gseaParam = 1
  39. )
  40. # Set title
  41. if (is.null(title)) {
  42. title <- region_set_name
  43. }
  44. # Calculate plot limits
  45. y_min <- min(plot_data$curve$ES) - abs(min(plot_data$curve$ES)) * 0.1 - 0.07
  46. y_max <- max(plot_data$curve$ES) + abs(max(plot_data$curve$ES)) * 0.1
  47. # Calculate statistic limits for consistent color scaling
  48. stat_limits <- c(min(ranking), max(ranking))
  49. # Main enrichment score plot
  50. main_plot <- ggplot() +
  51. # Enrichment score curve
  52. geom_line(data = plot_data$curve,
  53. aes(x = rank, y = ES),
  54. color = color, size = 1.4) +
  55. # Gene hit ticks at bottom
  56. geom_segment(data = plot_data$ticks,
  57. aes(x = rank,
  58. y = y_min - (y_max - y_min) * 0.04,
  59. xend = rank,
  60. yend = y_min + (y_max - y_min) * 0.05),
  61. color = "black", size = 0.3) +
  62. # Reference line at zero
  63. geom_hline(yintercept = 0, color = "black",
  64. size = 0.5, linetype = "dashed", alpha = 0.7) +
  65. # Styling
  66. labs(y = "Enrichment Score", x = NULL, title = title) +
  67. theme_classic() +
  68. theme(
  69. axis.text.x = element_blank(),
  70. axis.ticks.x = element_blank(),
  71. plot.margin = margin(5, 5, 0, 5),
  72. panel.grid = element_blank(),
  73. plot.title = element_text(size = 16, hjust = 0.5),
  74. axis.title.y = element_text(size = 14),
  75. axis.text.y = element_text(size = 12)
  76. ) +
  77. coord_cartesian(ylim = c(y_min, y_max)) +
  78. scale_y_continuous(breaks = pretty_breaks(n = 5))
  79. # Bottom panel - ranked statistics heatmap
  80. # Create bins for smoother visualization
  81. n_bins <- min(100, length(ranking))
  82. bin_indices <- round(seq(1, length(ranking), length.out = n_bins))
  83. stats_binned <- data.frame(
  84. rank = bin_indices,
  85. stat = ranking[bin_indices]
  86. )
  87. stats_heatmap <- ggplot(stats_binned, aes(x = rank, y = 1)) +
  88. geom_tile(aes(fill = stat), height = 1) +
  89. scale_fill_gradient2(
  90. low = "blue",
  91. mid = "white",
  92. high = "red",
  93. midpoint = 0,
  94. limits = stat_limits,
  95. name = "Ranked\nStatistic"
  96. ) +
  97. theme_classic() +
  98. theme(
  99. axis.title.y = element_blank(),
  100. axis.text.y = element_blank(),
  101. axis.ticks.y = element_blank(),
  102. axis.line.y = element_blank(),
  103. plot.margin = margin(0, 5, 5, 5),
  104. legend.position = "right",
  105. legend.key.size = unit(0.4, "cm"),
  106. axis.title.x = element_text(size = 14),
  107. axis.text.x = element_text(size = 12)
  108. ) +
  109. labs(x = "Rank in Ordered Regions") +
  110. scale_x_continuous(breaks = pretty_breaks(n = 6)) +
  111. guides(fill = guide_colorbar(barwidth = 0.8, barheight = 3))
  112. # Combine panels with appropriate height ratio
  113. final_plot <- main_plot / stats_heatmap +
  114. plot_layout(heights = c(7, 1))
  115. return(final_plot)
  116. }
  117. #' Plot Top Enriched Region Sets
  118. #'
  119. #' Filters and plots the top significantly enriched region sets from enrichment results.
  120. #'
  121. #' @param results A data frame containing enrichment results (analysis$results). Must contain columns:
  122. #' \code{padj}, \code{antibody}, \code{NES}, and \code{description}.
  123. #' @param n Integer. The number of top region sets to display. Default is 20.
  124. #' @param filter_by_TF Logical. If \code{TRUE}, selects only the single top region set
  125. #' (by absolute NES) for each unique TF/antibody and plots TF/antibody names instead of region set names.
  126. #' Default is \code{FALSE}.
  127. #' @param FDR_cutoff Numeric. The adjusted p-value cutoff for significance.
  128. #' Default is 0.05.
  129. #' @param only_pos Logical. If \code{TRUE}, filters for only positive Normalized
  130. #' Enrichment Scores (NES > 0). Default is \code{FALSE}.
  131. #' @return A \code{ggplot} object representing the bar plot of normalized enrichment scores.
  132. #' @export
  133. #' @importFrom dplyr %>% filter group_by slice_max ungroup arrange desc slice_head mutate
  134. #' @importFrom ggplot2 ggplot aes geom_bar coord_flip scale_fill_manual labs theme_minimal theme element_text
  135. #' @importFrom stringr str_wrap
  136. #' @importFrom rlang .data
  137. #' @examples
  138. #' # Mock data
  139. #' df <- data.frame(
  140. #' regionSet = c("Region_Set_1", "Region_Set_2", "Region_Set_3"),
  141. #' antibody = c("TF_A", "TF_B", "TF_A"),
  142. #' NES = c(2.5, -1.8, 1.2),
  143. #' padj = c(0.001, 0.04, 0.001),
  144. #' description = c("Promoter Region A", "Enhancer Region B", "Promoter Region C")
  145. #' )
  146. #'
  147. #' # Plot top 10 sets
  148. #' plotTopRegionSets(df, n = 10)
  149. #'
  150. plotTopRegionSets <- function(results, n = 20, filter_by_TF = FALSE, FDR_cutoff = 0.05, only_pos = FALSE) {
  151. # Filter for significant region sets
  152. results <- results %>%
  153. filter(.data$padj < FDR_cutoff)
  154. if (dim(results)[1] == 0) {
  155. stop(sprintf("No significantly enriched region sets found at FDR_cutoff = '%s'", FDR_cutoff))
  156. }
  157. # Filter for the top set for each TF/antibody (Optional)
  158. if (filter_by_TF) {
  159. results <- results %>%
  160. group_by(.data$antibody) %>%
  161. slice_max(order_by = abs(.data$NES), n = 1, with_ties = FALSE) %>%
  162. ungroup()
  163. }
  164. # Filter for only positive NES values (Optional)
  165. if (only_pos) {
  166. results <- results %>%
  167. filter(.data$NES > 0)
  168. }
  169. # Filter top n region sets and arrange for plotting
  170. results <- results %>%
  171. arrange(desc(abs(.data$NES))) %>%
  172. slice_head(n = n) %>%
  173. arrange(.data$NES)
  174. # If filtering by TF, use TF names for plot labels
  175. if (filter_by_TF) {
  176. results <- results %>%
  177. mutate(plot_label = .data$antibody)
  178. } else {
  179. results <- results %>%
  180. mutate(plot_label = str_wrap(.data$regionSet, width = 40))
  181. }
  182. # Set factor levels to match the current order and add sign
  183. results <- results %>%
  184. mutate(
  185. plot_label = factor(plot_label, levels = unique(plot_label)),
  186. NES_sign = ifelse(.data$NES > 0, "pos. NES", "neg. NES")
  187. )
  188. # Plotting
  189. plot <- ggplot(results, aes(x = .data$plot_label, y = .data$NES, fill = .data$NES_sign)) +
  190. geom_bar(stat = "identity", width = 0.7) +
  191. coord_flip() +
  192. scale_fill_manual(
  193. values = c("pos. NES" = "#E57373", "neg. NES" = "#64B5F6"),
  194. drop = FALSE
  195. ) +
  196. labs(
  197. x = "",
  198. y = "Normalized Enrichment Score (NES)",
  199. fill = ""
  200. ) +
  201. theme_minimal() +
  202. theme(
  203. axis.text.y = element_text(size = 12, face = "bold"),
  204. axis.text.x = element_text(size = 11),
  205. axis.title = element_text(size = 12),
  206. legend.text = element_text(size = 11),
  207. legend.position = "top"
  208. )
  209. return(plot)
  210. }

plotting.R at commit a874a19, under MIT · at the source

Overview

  1. Chair for Clinical Bioinformatics, Center for Bioinformatics, Saarland University, 66123 Saarbrücken, Germany
  2. Helmholtz Institute for Pharmaceutical Research Saarland (HIPS), Saarland University Campus, 66123 Saarbrücken, Germany
  3. PharmaScienceHub (PSH), Saarland University Campus, 66123 Saarbrücken, Germany
Journal: Nucleic acids research, volume 54, issue W1, pages W117-W124
Dates: received 25 March 2026; accepted 23 April 2026; published online 11 May 2026; in print July 2026
Type: Research article · Language: English
License: CC BY-NC
Identifiers: DOI 10.1093/nar/gkag454 · PMID 42109173 · PMCID PMC13355058 · OpenAlex W7160847415
Open access: gold, a free copy (OpenAlex)
Status: code verified (how the code is found and verified)
Categories: genetics / omics (modality), human (organism), mouse (organism), methods / tools (subfield)
Methods: Statistics
MeSH: Epigenomics*, Regulatory Sequences, Nucleic Acid*, Software*, Animals, Binding Sites, Chromatin, DNA Methylation, Humans, Internet, Mice, Transcription Factors (* major topic)
Topic: Genomics and Chromatin Dynamics (Molecular Biology, Biochemistry, Genetics and Molecular Biology), according to OpenAlex
Funding: HORIZON EUROPE Programme (101057548-EPIVINF); DFG (469073465); Saarland University
Citations: not cited yet (Europe PMC); 34 references in the paper

Abstract

Interpreting genome-wide epigenomic experiments, such as DNA methylation profiling and chromatin accessibility assays, requires tools that can identify which regulatory programs underlie coordinated changes across genomic regions. Without this regulatory context, lists of differential regions remain largely descriptive and difficult to interpret mechanistically. Existing approaches either apply hard significance cutoffs that discard moderate but biologically meaningful signals, or rely on gene-centric annotations that neglect enhancers and intergenic space, introducing bias into the interpretation. RegRegSEA addresses both shortcomings by adapting the Gene Set Enrichment Analysis framework directly to genomic coordinates. The server accepts a standard differential analysis table, ranks all tested intervals by a signed statistic, and computes enrichment scores against curated regulatory databases including transcription factor binding site collections. Results are returned as an interactive, publication-ready report featuring dynamic visualizations of enrichment profiles and regulatory annotations, along with downloadable leading-edge regions for downstream analyses. We demonstrate the utility of this approach through re-analysis of Down syndrome brain methylation data and chromatin accessibility in ageing mouse liver. The server is freely available at https://web.ccb.uni-saarland.de/regregsea/ and open to all users with no login required.

Reproduced under the paper's license (CC BY-NC), from the paper cited above.

Repositories

Its files are read in the Code ↔ Paper reader above, with 2 matches between paragraphs and lines of code.

CCB-SB/RegRegSEA

License: MIT
State: the link answers, verified on 27 September 2026
Evidence: files inventoried
Commit: a874a198aaf5a75d6be6371b8bac03eeb4bee4d0, 20 April 2026
Languages: R (3)
Size: 20 files, 3 scripts
Software Heritage: not archived
Found in: “Code availability”
Holds: README, license file, environment (DESCRIPTION), documentation, 1 notebook
Not found: CITATION.cff, tests, continuous integration
Tools: tidyverse (2 files), data.table (1 file), ggplot2 (1 file), patchwork (1 file)
Availability: 1 check, the latest on 27 September 2026: the link answers
  • 27 September 2026: the link answers
5 files

Zenodo 19731482

License: MIT
State: the link answers, verified on 27 September 2026
Evidence: files inventoried
Size: 1 file
Software Heritage: not checked
Found in: “Code availability”
Not found: README, license file, CITATION.cff, environment file, tests, continuous integration, documentation
Tools: tidyverse (2 files), data.table (1 file), ggplot2 (1 file), patchwork (1 file)
Availability: 1 check, the latest on 27 September 2026: the link answers (HTTP 200)
  • 27 September 2026: the link answers (HTTP 200)
5 files

Code availability

The backend analysis code of the web server is written in R and available at https://github.com/CCB-SB/RegRegSEA and https://doi.org/10.5281/zenodo.19731482.

Reproduced under the paper's license (CC BY-NC), from the paper cited above.

Tracing map

Proposed by the machine: these links were found in the paper and verified at the source, without human review. The map will receive a Zenodo DOI once one of the paper's authors has validated it with their ORCID.

What the map holds:

  • 2 repositories of the authors' code, each at its verified commit, with its license and how the link was found in the paper;
  • 6 scripts, each with its path and the digest of its content;
  • 2 matches between paragraphs of the paper and lines of the code (method lexical-v1);
  • neither the text of the paper nor the code itself.

Its JSON (tracing-map.json) is deposited on Zenodo with its DOI once the map is validated.

Data

Datasets cited

Data availability

No new data were generated or analysed in this study. The RegRegSEA web server is freely available at https://web.ccb.uni-saarland.de/regregsea/.

Reproduced under the paper's license (CC BY-NC), from the paper cited above.

Versions

The history of this record: each version stored by the harvester or made by a correction of its authors or of the maintainers of its code, and what changed in its facts. The texts of the paper (its abstract, its availability statements) are not part of it; versions that changed only those are not listed.

Version 1, 27 September 2026: the first record

Recorded: type, language, journal, volume, issue, pages, dates, 6 authors, 11 MeSH terms, 3 funders, 34 references.

Cite

This paper

Wolff, T., Grandke, F., Sayeeda, M., Hirsch, P., Flotho, M., & Keller, A. (2026). RegRegSEA: a web server for regulatory region set enrichment analysis of epigenomic data. Nucleic acids research, 54(W1), W117-W124. https://doi.org/10.1093/nar/gkag454

BibTeX

@article{wolff2026regregsea,
author = {Wolff, Tobias and Grandke, Friederike and Sayeeda, Misbah and Hirsch, Pascal and Flotho, Matthias and Keller, Andreas},
title = {{RegRegSEA: a web server for regulatory region set enrichment analysis of epigenomic data}},
journal = {Nucleic acids research},
year = {2026},
month = jul,
volume = {54},
number = {W1},
pages = {W117--W124},
publisher = {Oxford University Press},
issn = {0305-1048},
doi = {10.1093/nar/gkag454},
url = {https://doi.org/10.1093/nar/gkag454},
pmid = {42109173},
pmcid = {PMC13355058}
}

RIS

TY - JOUR
AU - Wolff, Tobias
AU - Grandke, Friederike
AU - Sayeeda, Misbah
AU - Hirsch, Pascal
AU - Flotho, Matthias
AU - Keller, Andreas
TI - RegRegSEA: a web server for regulatory region set enrichment analysis of epigenomic data
T2 - Nucleic acids research
J2 - Nucleic Acids Res
PY - 2026
DA - 2026/07/01
VL - 54
IS - W1
SP - W117
EP - W124
SN - 0305-1048
PB - Oxford University Press
DO - 10.1093/nar/gkag454
UR - https://doi.org/10.1093/nar/gkag454
LA - en
ER -

CSL-JSON

{
"id": "10.1093/nar/gkag454",
"type": "article-journal",
"title": "RegRegSEA: a web server for regulatory region set enrichment analysis of epigenomic data",
"container-title": "Nucleic acids research",
"author": [
{
"family": "Wolff",
"given": "Tobias"
},
{
"family": "Grandke",
"given": "Friederike"
},
{
"family": "Sayeeda",
"given": "Misbah"
},
{
"family": "Hirsch",
"given": "Pascal"
},
{
"family": "Flotho",
"given": "Matthias"
},
{
"family": "Keller",
"given": "Andreas"
}
],
"container-title-short": "Nucleic Acids Res",
"volume": "54",
"issue": "W1",
"page": "W117-W124",
"DOI": "10.1093/nar/gkag454",
"PMID": "42109173",
"PMCID": "PMC13355058",
"ISSN": "0305-1048",
"publisher": "Oxford University Press",
"URL": "https://doi.org/10.1093/nar/gkag454",
"language": "en",
"issued": {
"date-parts": [
[
2026,
7,
1
]
]
}
}

The tracing map gets a citation of its own once an author has validated it and it has a DOI.

Similar papers

The papers with a page that share the most with this one: the tools found in their code, their categories, datasets, cited references and authors, the rarest counting most.

[1] doi:10.1038/s41467-025-59860-6 [code]
A spatio-temporal brain miRNA expression atlas identifies sex-independent age-related microglial driven miR-155-5p increase.
Journal: Nature communications
In common: data.table, ggplot2, tidyverse, mouse, 1 reference, author Andreas Keller
[2] doi:10.1038/s41592-023-01938-4 [code]
SCENIC+: single-cell multiomic inference of enhancers and gene regulatory networks.
Journal: Nature methods
In common: patchwork, data.table, ggplot2, 1 other tool, genetics / omics, mouse, 3 references
[3] doi:10.1186/s13059-022-02613-1 [code]
Placental methylome reveals a 22q13.33 brain regulatory gene locus associated with autism.
Journal: Genome biology
In common: data.table, ggplot2, tidyverse, genetics / omics, 4 references
[4] doi:10.1038/s41586-025-09987-9 [code]
Ageing promotes microglial accumulation of slow-degrading synaptic proteins.
Journal: Nature
In common: data.table, ggplot2, tidyverse, author Andreas Keller
[5] doi:10.1038/s41467-025-66109-9 [code]
Mid-gestational cell-type-specific transcriptomic signatures in the prefrontal and superior temporal cortex in Down syndrome.
Journal: Nature communications
In common: patchwork, data.table, ggplot2, 1 other tool, genetics / omics, 2 references
[6] doi:10.1016/j.xgen.2025.100890 [code]
Early establishment and life course stability of sex biases in the human brain transcriptome.
Journal: Cell genomics
In common: patchwork, data.table, ggplot2, 1 other tool, genetics / omics, 3 references
[7] doi:10.1016/j.isci.2024.110546 [code]
Purinergic exposure induces epigenomic and transcriptomic-mediated preconditioning resembling epilepsy-associated microglial states.
Journal: iScience
In common: patchwork, data.table, ggplot2, 1 other tool, genetics / omics, 3 references
[8] doi:10.1126/sciadv.abo3991 [code]
Sex-specific epigenetic development in the mouse hypothalamic arcuate nucleus pinpoints human genomic regions associated with body mass index.
Journal: Science advances
In common: data.table, ggplot2, tidyverse, genetics / omics, mouse, 3 references
[9] doi:10.1038/s41586-023-06819-6 [code]
Conserved and divergent gene regulatory programs of the mammalian neocortex.
Journal: Nature
In common: patchwork, data.table, ggplot2, 1 other tool, genetics / omics, mouse, 2 references
[10] doi:10.1038/s41467-024-52463-7 [code]
A cell type-aware framework for nominating non-coding variants in Mendelian regulatory disorders.
Journal: Nature communications
In common: patchwork, data.table, ggplot2, 1 other tool, genetics / omics, mouse, 2 references

Contribute

The authors of this paper can claim it, correct its record and validate its tracing map, and the maintainers of its code (its owner, or a public member of its organization) correct what it says of their repository; anyone signed in can ask for its removal. Every request goes to OSCR's own machine, which answers it; your account page follows them.

Sign in with ORCID to claim this paper as one of its authors, correct its record or validate its tracing map: when the paper's metadata lists your ORCID iD, you are recognized at once. Maintainers of its code: sign in with GitHub, then claim the repository on your account page.

Add the badge to the code's README

OSCR: the badge of this paper

If you are an author or a maintainer of this paper's code, you can add this badge. It says what OSCR knows of the paper (its code, its validated tracing map) and links the code to this page. Paste one of these snippets under the README's title. Keep the two marks around it, so that the badge can be replaced in place and is never added twice. OSCR changes nothing in your repository.

Markdown
<!-- oscr-badge:start -->
[![OSCR](https://openscicode.org/badge/doi/10.1093/nar/gkag454.svg)](https://openscicode.org/badge/doi/10.1093/nar/gkag454)
<!-- oscr-badge:end -->
reStructuredText
.. oscr-badge:start

.. image:: https://openscicode.org/badge/doi/10.1093/nar/gkag454.svg
   :target: https://openscicode.org/badge/doi/10.1093/nar/gkag454
   :alt: OSCR

.. oscr-badge:end
HTML
<!-- oscr-badge:start -->
<a href="https://openscicode.org/badge/doi/10.1093/nar/gkag454"><img src="https://openscicode.org/badge/doi/10.1093/nar/gkag454.svg" alt="OSCR"></a>
<!-- oscr-badge:end -->

On GitHub, open the README, choose Edit (the pencil), paste the snippet under the title, then "Commit changes".

If you choose to, you can have the badge kept up to date for you, with oscr badge --write from the command line or with the GitHub Action in your repository's workflows. Every other form and option (a card, AsciiDoc, LaTeX, shields.io) is on the badge page.

Request its removal

To ask OSCR to remove this record, the copies of its authors' scripts or its tracing map, use the removal request page: signed in, you say who you are, what to remove and why, then review and confirm the request. Published rules decide every request (how).

Discussion, reproductions, activity

Discussion: code errors and mismatches between the code and the paper about this paper and its code, from readers and its authors, beside the paper and its tracing map.

Report a mismatch between the code and the paper · Report a code error (signed in)

Reproductions: reports from readers who ran the authors' code and did not get the paper's result, what they ran, with which environment, commit and data.

Report a reproduction failure (signed in)

Versions of its code: the releases of its code tied to a version of this paper (the preprint, the accepted manuscript, the version of record…), each with the tracing map versioned with it.

Activity: what happens around this paper: new versions of its record, its map's validation, discussions and reproductions. It opens with sign-in.