Skip to content

Python implementation of a Gillespie-based stochastic model simulating telomere state transitions (blunt, resected, t-loop) across embryonic stem cell cycles, with visualization of population dynamics over multiple simulated cells.

License

Notifications You must be signed in to change notification settings

joeydufourd/telomere-dynamics-gillespie

Repository files navigation

Stochastic Simulation of Telomere Dynamics

This repository contains a Python implementation of a stochastic telomere dynamics model using the Gillespie algorithm.
The code simulates the transitions between three telomeric states during multiple embryonic stem cell (ESC) cycles:

  • LB: Linear blunt telomeres
  • LR: Linear resected telomeres
  • T: Telomere loops (t-loops)

The model explores how telomeres fluctuate between these states depending on cell cycle phase (G1, S, G2/M) and stochastic reaction events.


Features

  • Gillespie simulation of telomere state transitions.
  • Incorporates cell cycle dynamics (G1, S, G2/M).
  • Models rare non-equal divisions at cell cycle checkpoints.
  • Runs multiple independent simulations (representing different cells).
  • Outputs mean dynamics and variability across simulated populations.
  • Generates clear plots with shaded error bars, cell cycle phase markers, and division events.

Model Overview

States

  1. LB (Linear blunt telomeres)
  2. LR (Linear resected telomeres)
  3. T (Telomere-loops)

Reactions (with biological interpretation)

  1. LB → LR (APOLLO activity, resection)
  2. LR → LB (breaks or nucleases)
  3. LR → T (t-loop formation)
  4. T → LB (t-circle, breakage)
  5. T → LR (t-loop opening, C-circle formation)

Graph describing nodes relationships

Cell Cycle Parameters

  • G1: ~1 hour
  • S: ~5 hours
  • G2/M: ~2 hours
  • Total cycle length: 8 hours

Different (arbitrary) reaction rate constants are applied in each phase to reflect biological conditions.


Contributing

  • Feel free to open issues for bug reports or feature requests.
  • For enhancements, fork the repo, make your changes, and submit a pull request.

License

This project is licensed under the MIT License — see LICENSE for details.


Acknowledgements / Citation

If you use this code in a publication or a pipeline, please cite the original thesis (Joey Dufourd ; or this GitHub repository).
Include author name, year, and DOI (or link).

Installation

Clone the repository and install required dependencies:

git clone https://github.com/joeydufourd/telomere-dynamics-gillespie.git

About

Python implementation of a Gillespie-based stochastic model simulating telomere state transitions (blunt, resected, t-loop) across embryonic stem cell cycles, with visualization of population dynamics over multiple simulated cells.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages