epiverse-trace / epiCo

R package for statistical and spatiotemporal modeling of epidemiological data for vector-borne diseases in Colombia
https://epiverse-trace.github.io/epiCo/
Other
12 stars 1 forks source link
colombia decision-support demographics epiverse outbreak-analysis r r-package spatio-temporal-analysis vector-borne-diseases

epiCo

epiCo provides statistical and visualization tools for the analysis of demographic indicators, and spatio-temporal behavior and characterization of outbreaks of vector-borne diseases (VBDs) in Colombia.

License:
MIT R-CMD-check Codecov test
coverage lifecycle-maturing DOI

Installation

You can install the stable version of epiCo from CRAN with:

install.packages("epiCo")

You can also install the development version of epiCo from GitHub with:

# install.packages("remotes")
remotes::install_github("epiverse-trace/epiCo")

Motivation

When reviewing the current epidemiological bulletins published by the local Secretariats of Health in Colombia, we identified an opportunity to create a tool to:

The package allows for interoperable analyses of linelist data from SIVIGILA (accessible using the Epiverse-TRACE package sivirep) with spatial and demographic data (accessible using the Epiverse-TRACE package ColOpenData).

epiCo can be used to perform the following main tasks at the municipality, departmental, or national level:

  1. To identify demographic vulnerabilities from linelist data and the socioeconomic census, including risk assessment based on age, gender, occupation, and ethnicity.
  2. To assess hot-spot analyses (as Local Moran's index) based on real travel distances in Colombia estimated from Bravo-Vega C., Santos-Vega M., & Cordovez J.M. (2022).
  3. To generate automated outbreak characterization (onset, duration, magnitude, and frequency) using traditional methods as the endemic channel and poisson tests for unusual behavior.
  4. Future features will include correlation analyses between categorical socioeconomic data, climate time series and epidemiological data, nowcasting assessment, underreport estimation, and short-term forecasting.

All features are performed automatically from epidemiological, demographic, spatial, and socioeconomic data published by Colombian institutions, but methods can also be customized as well as input data, so hypothetical information can be tested within the package.

Modules

epiCo contains three modules documented in the following vignettes:

  1. Demographic analyses with epiCo
  2. Building an Endemic Channel with epiCo
  3. Spatiotemporal analyses with epiCo

Development

Lifecycle

This package is currently a maturing product, as defined by the RECON software lifecycle. This means that essential features and mechanisms are functional, documented, and tested. However, the package is open to receive code reviews and is being socialized with expert users.

Contributions

Contributions are welcome via pull requests.

Contributors to the project include:

We acknowledge the contribution of collaborators in Universidad de los Andes, Pontificia Universidad Javeriana, Instituto Nacional de Salud de Colombia, Secretaría de Salud del Tolima, and Epimodelac Course attendees who provided insightful feedback for the package.

Code of Conduct

Please note that the epiCo project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

Funding

This work is part of the TRACE-LAC research project funded by the International Research Centre (IDRC) Ottawa, Canada.[109848-001-].