# GenomicLayers: sequence-based simulation of epi-genomes

## TL;DR

GenomicLayers is a new R package that simulates genome-wide epigenetic changes using rules-based models, allowing researchers to study gene regulation in eukaryotes.

## Contribution

GenomicLayers introduces a novel framework for simulating epigenetic state changes across entire genomes using user-defined rules.

## Key findings

- GenomicLayers can simulate recruitment and spreading of epigenetic marks near telomeres in yeast.
- The package generates whole-genome predictions of epigenetic state at 1 bp resolution.
- The software is demonstrated on both yeast and human genomes, showing its versatility for different organisms.

## Abstract

Cellular development and differentiation in Eukaryotes depends upon sequential gene regulatory decisions that allow a single genome to encode many hundreds of distinct cellular phenotypes. Decisions are stored in the regulatory state of each cell, an important part of which is the epi-genome—the collection of proteins, RNA and their specific associations with the genome. Additionally, further cellular responses are, in part, determined by this regulatory state. To date, models of regulatory state have failed to include the contingency of incoming regulatory signals on the current epi-genetic state and none have done so at the whole-genome level.

Here we introduce GenomicLayers, a new R package to run rules-based simulations of epigenetic state changes genome-wide in Eukaryotes. Simulations model the accumulation of changes to genome-wide layers by user-specified binding factors. As a first exemplar, we show two versions of a simple model of the recruitment and spreading of epigenetic marks near telomeres in the yeast Saccharomyces cerevisiae. By combining the output from 100 runs of the simulation, we generate whole genome predictions of epigenetic state at 1 bp resolution. The example yeast models are included within a ‘vignette’ with the GenomicLayers package, which is available at https://github.com/davetgerrard/GenomicLayers. To demonstrate the use of GenomicLayers on the full human reference genome (hg38), we show the results from parameter refinement on a simplistic model of the action of pluripotency factors against a self-spreading repressor seeded at CpG islands. The human genome model is included in supplementary information as an R script.

GenomicLayers enables scientists working on diverse eukaryotic organisms to test models of gene regulation in silico. Applications include epigenetic silencing, activation by combinatorial binding of transcription factors and the sink effects caused by down-regulation of components of epigenetic regulators. The software is intended to be used to parameterise, refine and combine models and thereby capitalise on data from the thousands of studies of Eukaryotic epigenomes.

The online version contains supplementary material available at 10.1186/s12859-025-06224-y.