PyBDEI

PyBDEI estimates epidemiological parameters from phylogenetic trees using the Birth-Death Exposed-Infectious (BDEI) model to quantify transmission dynamics such as R_e and infectious period while accounting for incubation delays in pathogens like Ebola and SARS-CoV-2.


Key Features:

  • BDEI model: Implements the Birth-Death Exposed-Infectious model that accounts for the delay between infection and becoming infectious (incubation period).
  • Phylogenetic inference: Uses phylogenetic trees (genealogies of pathogen sequences) to infer epidemiological parameters including R_e and infectious time.
  • Multi-type birth-death framework: Operates within a multi-type birth-death (MTBD) framework to represent structured transmission dynamics.
  • Parallelizable ODE formulation: Employs a novel formulation of ordinary differential equations (ODEs) that enables parallel computation and preserves numerical stability.
  • Scalability and speed: Processes large phylogenetic trees (reported up to 10,000 samples) with execution times on the order of minutes (approximately two minutes for 10,000 samples in reported benchmarks).
  • Accuracy and uncertainty: Produces parameter estimates together with confidence intervals to quantify estimation uncertainty.
  • Forests of trees: Extends to forests of phylogenetic trees to model multiple introductions or sub-epidemics.
  • Comparative performance: Empirical comparisons on simulated data report improved speed and accuracy relative to existing implementations and include application to the 2014 Ebola epidemic in Sierra Leone.
  • Extensibility: Methodological approaches are stated to be extendable to ClaSSE-like models for macroevolutionary applications.

Scientific Applications:

  • Estimation of transmission parameters: Quantifies R_e and infectious period for pathogens with incubation periods, such as Ebola and SARS-CoV-2.
  • Phylodynamic analysis: Infers epidemic dynamics from pathogen sequence genealogies under the BDEI and MTBD frameworks.
  • Modeling complex epidemics: Represents multiple introductions and sub-epidemics via forests of phylogenetic trees.
  • Real-world outbreak analysis: Applied to real outbreak data, including analysis of the 2014 Ebola epidemic in Sierra Leone.
  • Macro-evolutionary extension: Supports methodological extension to ClaSSE-like models beyond epidemiology.

Methodology:

Inference is performed from phylogenetic trees using the BDEI model and a novel ODE formulation that enables parallel computation and numerical stability; the implementation estimates epidemiological parameters and their confidence intervals and can operate on forests of phylogenetic trees.

Topics

Collections

Details

License:
GPL-2.0
Maturity:
Emerging
Cost:
Free of charge
Tool Type:
library
Operating Systems:
Linux, Mac
Programming Languages:
Python
Added:
7/26/2024
Last Updated:
11/24/2024

Operations

Publications

Zhukova A, Hecht F, Maday Y, Gascuel O. Fast and Accurate Maximum-Likelihood Estimation of Multi-Type Birth–Death Epidemiological Models from Phylogenetic Trees. Systematic Biology. 2023;72(6):1387-1402. doi:10.1093/sysbio/syad059. PMID:37703335. PMCID:PMC10924745.

PMID: 37703335
Funding: - PRAIRIE: ANR-19-P3IA-0001 - European Research Council: 810367

Documentation

Installation instructions', 'Command-line options', 'Citation instructions
https://github.com/evolbioinfo/bdei

Downloads

Links