denim: an R package for deterministic compartmental models with flexible dwell time distributions
Authors:
- Thinh P. OngTOThinh P. Ong
- Anh T. Q. PhanAPAnh T. Q. Phan
- Lam M. HaLHLam M. Ha
- Marc ChoisyMCMarc Choisy
Preprint
Abstract
Compartmental models are widely used for dynamical systems where states are discrete such as in infectious diseases epidemiology with the so-called SIR or Susceptible-Infectious-Recovered framework. For mathematical simplicity, rates of transition between compartments are generally assumed to be independent of the dwell time (or secondary time scale in survival analysis): they are either constant or dependent on the epidemiological time (or primary time scale in survival analysis) only, either directly (e.g. environmental or behavioral forcings in epidemiological models) or indirectly through dependence on other variables of the system (e.g. the force of infection in epidemiological models). In some domains of application, this memoryless assumption leads to distributions of dwelling times that are incompatible with those observed on data which can lead to serious problems since the model predictions are highly sensitive on the exact shape of these distributions. Here we propose a deterministic, continuous-variable, numerical modelling approach that allows full flexibility on the dwell time distributions. The accompanying denim package provides a user-friendly interface to implement our proposed method through a dedicated language for model definition. The package is open-source and available on CRAN. With more detailed data on the clinical process of infections becoming available, the denim package will be extremely useful for building more realistic epidemiological models providing more accurate projections. The denim package is publicly available for download on CRAN ( https://cran.r-project.org/web/packages/denim/index.html ) and GitHub ( https://github.com/thinhong/denim ). Additional documentation can be found on the denim webpage ( https://drthinhong.com/denim/ ). Bug reports can be submitted via Github Issue.Keywords
All Related Versions
- Published version: Methods in Ecology and Evolution, 17 (4), 1060.
This publication has 17 references indexed in Scilit:
- Serodynamics: A primer and synthetic review of methods for epidemiological inference using serological dataEpidemics, 2024
- Overcoming bias in estimating epidemiological parameters with realistic history-dependent disease spread dynamicsNature Communications, 2024
- Feasibility of controlling COVID-19 outbreaks by isolation of cases and contactsThe Lancet Global Health, 2020
- Generalizations of the ‘Linear Chain Trick’: incorporating more flexible dwell time distributions into mean field ODE modelsJournal of Mathematical Biology, 2019
- Effects of the infectious period distribution on predicted transitions in childhood disease dynamicsJournal of The Royal Society Interface, 2013
- Infectiousness of smallpox relative to disease age: estimates based on transmission network and incubation periodEpidemiology and Infection, 2006
- The estimation of SARS incubation distribution from serial interval data using a convolution likelihoodStatistics in Medicine, 2005
- Realistic Distributions of Infectious Periods in Epidemic Models: Changing Patterns of Persistence and DynamicsTheoretical Population Biology, 2001
- Effect of variability in infection period on the persistence and spatial spread of infectious diseasesMathematical Biosciences, 1998
- Compartmental models and competing riskMathematical Biosciences, 1994