Learn R Programming

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.

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:

  • Include spatial and demographic risk assessments into their routine epidemiological reports to better identify population groups for potential interventions.
  • Facilitate the understanding of the different epidemiological profiles within a region in Colombia regarding the onset, duration, magnitude, and frequency of the outbreaks.
  • Strengthen the transparency of the methods used for the outbreak analysis.
  • Provide more informative context by performing spatial correlation analysis.

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-].

Copy Link

Version

Install

install.packages('epiCo')

Monthly Downloads

199

Version

1.0.1

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Juan D. Umaña

Last Published

January 15th, 2025

Functions in epiCo (1.0.1)

geometric_mean

Returns the geometric mean of a vector of real numbers.
population_pyramid_plot

Returns the population pyramid plot
get_age_risk_sex

Auxiliary function to calculate the proportion by age according to the total population and sex
get_occupation_data

Auxiliary function to obtain the information of the occupations
epi_data

epi_data
endemic_channel

Create and return the endemic channel of a disease from an incidence object
describe_occupation

Get ISCO-88 occupation labels from codes
age_risk

Returns the specific rates associated with being infected given age and sex
epi_calendar

Get the epidemiological calendar of a consulted year.
describe_ethnicity

Provides the sociological description of ethnicities in Colombia
geometric_sd

Returns the geometric standard deviation of a vector of real numbers.
population_pyramid

Returns the population pyramid of the consulted region
morans_index

Calculate spatial correlation of given municipalities in an incidence_rate object.
divipola_table

divipola_table
occupation_plot

Distribution plots for ISCO-88 occupation labels
endemic_outliers

Modifies the historic incidence to handle with the observations of epidemic years
neighborhoods

Neighborhoods from real travel distances in Colombia
endemic_plot

Creates the endemic channel plot
occupation_plot_circular

Distribution plots for ISCO-88 occupation labels
epiCo-package

epiCo: Statistical and Viz Tools for Vector-Borne Diseases in Colombia
isco88_table

isco88_table
incidence_rate

Extends an incidence class object with incidence rates estimations.