An R package for accessing India’s Health Management Information System (HMIS) data — 840+ state-level and 845 district-level health indicators across 36 states/UTs and 700+ districts, from April 2008 to March 2025.
Installation
# install.packages("remotes")
remotes::install_github("saketkc/hmisindia")Data files (parquet) are downloaded from GitHub Releases on first use.
Quick start
library(hmisindia)
# Browse available indicators
list_indicators()
search_indicators("malaria")
# Query an indicator
deaths <- get_hmis("Number of Inpatient Deaths",
sector = "Total",
category = "Total"
)
# Time series plot
plot_time_series(deaths, y_label = "Inpatient deaths")
# Filter by state and date range
births <- get_hmis("Number of female live births",
state = c("Bihar", "Kerala", "Tamil Nadu"),
from = "Apr 2015",
to = "Mar 2024",
sector = "Total",
category = "Total"
)Capabilities
| Function | Purpose |
|---|---|
get_hmis() |
Query by substring, regex, or fuzzy match with push-down Arrow filters |
list_indicators() / search_indicators()
|
Browse 840+ state and 845 district indicators |
plot_time_series() / plot_heatmap()
|
Visualise with colorblind-safe palettes |
detect_periodicity() / decompose_series()
|
Identify and decompose seasonal patterns |
attach_geometry() |
Join LGD boundaries for choropleth mapping |
Documentation
Full reference and vignettes: hmisindia.saketlab.org