Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



49 Commits

Repository files navigation


This GitHub repository provides source code for the IDSpatialStats R package, which is designed to help epidemiologists assess the scale of spatial and temporal dependence in epidemic case occurrence data.

The current implementation of the package includes a function which simulates infectious disease spread as a spatial branching process, along with two novel spatial statistics that estimate: 1) the mean of the spatial transmission kernel, which is a measure of fine-scale spatial dependence between two cases, and 2) the tau-statistic, a measure of global clustering based on pathogen subtype.

Detailed description of the methods can be found here:

The IDSpatialStats R package: Quantifying spatial dependence of infectious disease spread (Giles et al. 2019)

Measuring spatial dependence for infectious disease epidemiology (Lessler et al. 2016)

Estimating infectious disease transmission distances using the overall distribution of cases (Salje et al. 2016)


To install the offical release of the IDSpatialStats package, open R and type:


To install the install the development version, first install the devtools package and then install IDSpatialStats from source via GitHub:



For general questions, contact package maintainers Justin Lessler ( or John Giles (

To report bugs or problems with documentation, please go to the Issues page associated with this GitHub page and click new issue.

If you wish to contribute to IDSpatialStats, please get in touch via email and then fork the latest version of the package. After committing your code to your own forked version, submit a pull request when you are ready to share.