rdhs

0.8.1

API Client and Dataset Management for the Demographic and Health Survey (DHS) Data

4packages depend

166Kdownloads / year

85.9%test coverage

13/13checks pass

Overview

About

Maintained by OJ WatsonFirst published 2018-12-1911 releasesCRAN page ↗GitHub ↗

Provides a client for (1) querying the DHS API for survey indicators and metadata (https://api.dhsprogram.com/#/index.html), (2) identifying surveys and datasets for analysis, (3) downloading survey datasets from the DHS website, (4) loading datasets and associate metadata into R, and (5) extracting variables and combining datasets for pooled analysis.

Install

R (CRAN)pak (dev)Ubuntu (r2u)openSUSE (OBS)

install.packages("rdhs", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("ropensci/rdhs")

Development version from ropensci/rdhs. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-rdhs

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-rdhs

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

13OK

Slowest check: 2.4 min · r-oldrel-windows-x86_64

Code health

Yes

Tests · ratio 0.24

85.9%

Coverage · measured lines

97%

Documentation · exports

Dependencies · direct

Check history

OK2026-07-22
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-07-18
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-06-09
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-06-08
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-04-30
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Show 2 earlier snapshots

ERROR2026-04-28
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 1,008 wordsVignettesYes · dynamicpkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 22%
Documented parameters: 100%
Return-value docs: 83%
References docs: 0%

Downloads

166K

CRAN downloads in the past year

Rank #2,429 · ~455/day · ~13.8K/mo

Releases R versions

Daily download trend is not available in this view yet.

1.4K30 days

9K90 days

166K1 year

Compare downloads with other packages →

Also on117 r2u33 autocran47 c2d4u

Repository

GitHub ↗ ropensci/rdhs

38Stars

12Forks

37Open issues

2Open PRs

6Releases

678Commits

9Contributors

datasetsurvey-datadhsextractdhs-apipeer-reviewedrr-package

678 commits · Last activity 2025-02-27 · 0% stars, 30d

Stars over time

2025-07-03 · 372026-07-07 · 38

Repository practices

Upstream repositoryBeta

7 development-tooling and community-health practices detected across 7 families in the upstream repository

Checks run against github.com/ropensci/rdhs on 2026-07-19.

Continuous integration (1)

GitHub Actions

Reproducibility and dev environment (1)

data-raw/

CRAN release process (1)

cran-comments.md

Docs source (1)

README.Rmd

Show all practices

Research and citation (1)

codemeta.json

Lint, format, editor (1)

RStudio project

Git structural (1)

.gitattributes

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

23 external dependencies (excludes base and recommended)

Depends (1)

R >= 3.3.0

Imports (17)

brio R6 httr jsonliteforeignmagrittr rappdirs digest storr xml2 qdapRegex getPass haven iotools sf cli rlang

LinkingTo (0)

none

Suggests (7)

testthat knitr rmarkdown ggplot2 survey data.table microbenchmark

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

4direct

1indirect

AgePopDenom surveyPrev SUMMER malariaAtlas

Code & Tests

Datasets

People & History

People (4)

Maintainer (1)

OJ Watson

Author, Maintainer

Authors (2)

OJ Watson

Author, Maintainer

Jeff Eaton

Author

Reviewers (2)

Lucy D'Agostino McGowan

Reviewer

Duncan Gillespie

Reviewer

Package Timeline

11 releases. Pick two to compare their code metrics. R releases are shown for context.

R
R 4.6.0 released · 2026-04-24
R
R 4.5.0 released · 2025-04-11
R
R 4.4.0 released · 2024-04-24
0.8.1Latest
2023-11-21 · current release · diff ↗
0.8.0
2023-10-10 · diff ↗
R
R 4.3.0 released · 2023-04-21
0.7.6
2022-10-20 · diff ↗
0.7.5
2022-09-29 · diff ↗
R
R 4.2.0 released · 2022-04-22
0.7.3
2021-07-19 · diff ↗
R
R 4.1.0 released · 2021-05-18
0.7.2
2021-04-28 · diff ↗
0.7.1
2020-12-01 · diff ↗
unarchivedReturned to CRAN
2020-12-01
archivedRemoved from CRAN
2020-11-27
check problems were not corrected in time
R
R 4.0.0 released · 2020-04-24

Show 8 earlier events

R
R 3.6.0 released · 2019-04-26
0.6.3
2019-03-19 · diff ↗
0.6.2
2019-02-28 · diff ↗
0.6.1
2019-01-24 · diff ↗
unarchivedReturned to CRAN
2019-01-24
archivedRemoved from CRAN
2019-01-24
check issues were not corrected in time
0.6.0
2018-12-19
R
R 3.5.0 released · 2018-04-23

Package metadata

First published: 2018-12-19
Total releases: 11 / 8 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 3.3.0
Bundled data: 3.0 KB / 2 files
Download size: 941 KB
Installed size: not tracked yet
With dependencies: not tracked yet

Appears in task views

Official Statistics & Survey Statistics

Report a problem with this page →