Skip to content

Pipeline for ODE-driven simulations to explore the genomic compliance of PR-2.

License

Notifications You must be signed in to change notification settings

SahakyanLab/GenomicPR2Simulations

Repository files navigation

Genomic PR-2 Simulations

R&D pipeline for: Generalised interrelations among mutation rates drive the genomic compliance of Chargaff’s second parity rule.

Chargaff’s second parity rule (PR-2), where the complementary base (and k-mer) contents are matching within the same strand of a double stranded DNA (dsDNA), is a phenomenon that invited many elaborations for its explanation. The strict compliance of nearly all nuclear dsDNA genomes to PR-2 implies that the explanation should also be similarly strict and constraining. In this work, we revisited the possibility of mutation rates being the drivers behind PR-2. Starting from the assumption-free approach, we constructed a set of kinetic equations for unconstrained simulations. The results were analysed in terms of their PR-2 compliance by employing symbolic regression and machine learning techniques. [Nucleic Acids Research]

Installation

Download the source code from the GitHub repository. You can also do that via a Linux/Unix/OSX command line, given that git is installed, by typing the following:

git clone https://github.com/SahakyanLab/GenomicPR2Simulations

Requirements

Workflow to get similar plots in the publication

Execute the submit.sh file for sequential execution of the complete workflow.

Downloads, filters and plots various meta-data of the species for the prokaryotes, eukaryotes and DNA virus kingdoms. Please note the following. First, the DNA Virus sequences are automatically downloaded from the latest updated list on NCBI, whereas the publication worked with a list of viruses released until Dec 2020. Second, if you execute the main submit.sh file, it will only plot the already processed data sets. If you wish to perform the full pipeline for the 3 kingdoms, please uncomment the lines within the script.sh file in this folder.

Numerical simulations to produce the time evolution of genomic base content within 4.28 billion year period. Please note, that each simulation run solves an ODE-based system and calculates the associated meta-data. In the main paper, the core simulations were run 25 million times each and took approximately 2-4 weeks each, depending on the number of cpus used for parallel processing with foreach. If you wish to entirely replicate this, please amend the Process.R script in this folder so as to run the simulations in parallel (e.g. on a cluster). By default, each simulation is run sequentially. Alternatively, for a simple demonstration purpose, please amend the run argument within the script.sh file in this folder from 25,000,000 to a lower number like 100,000. Please also note that if the default of 25,000,000 is not used, all the subsequent results below will be different from the main paper. Due to the size of each simulation outcome, most of the resulting files are not deposited in this repo.

Performs the machine learning strategy for classification of compliance and non-compliance with the second parity rule solutions. Data depends on above folders.

Symbolic regression of mutation rate constants under the tolerance region of the second parity rule compliance. Equations were generated with the Eureqa modelling engine. Data depends on above folders.

Interactive web application

The corresponding interactive web application for demonstration purposes is accessible on GenomicPR2SimsWebApp GitHub repository.

About

Pipeline for ODE-driven simulations to explore the genomic compliance of PR-2.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages