Access CDC Behavioral Risk Factor Surveillance System Data
Overview
Download, cache, and analyze annual microdata from the United States Centers for Disease Control and Prevention Behavioral Risk Factor Surveillance System (BRFSS) https://www.cdc.gov/brfss/. Each requested survey year is downloaded once as a compact file hosted on public releases, verified against a published checksum, and cached locally; queries then run through 'DuckDB' (via the 'duckdb' package), so column selection and repeat analyses never re-transfer data. Survey-design helpers construct 'srvyr' design objects with year-appropriate weights, strata, and primary sampling units, including explicit handling of the 2011 weighting methodology change and of the codes CDC uses for missing-type answers.
- BRFSS 2025 is available: 356,158 respondents from 47 states, the District of Columbia, Guam, and Puerto Rico. CDC excluded California, Mississippi, Nevada, and the US Virgin Islands from the 2025 public file for collecting too little data, and the 2024 file has no Tennessee respondents, so pooling 2024 with 2025 names all five jurisdictions in the state-participation warning. The year reaches installed versions through the data manifest without upgrading.
- Three 2025 questionnaire changes are worth knowing before pooling years. The respondent sex questions (
LANDSEX4,CELLSEX4) accept only male or female, and the call ends for anyone who gives neither, so the 2025 sample has no counterpart to the don't-know and refused answers earlier years recorded. The child-sex item (RCSBORG1) offers only boy or girl, and the 2024 file carries its predecessors (RCSGEND1,RCSXBRTH) with no values at all.COVIDWHN's label in CDC's file says first COVID-19 vaccination, but CDC's 2025 codebook asks for the most recent one.
Show all changes in 0.1.1Hide the rest of the changes in 0.1.1
- The crosswalk gains the 2025 renames (
LANDSEX4,CELLSEX4,NOBCUSE9, andTYPCNT10, whose stem CDC shortened to fit SAS's eight-character limit) and a new child-sex family linkingRCSGENDR,RCSGEND1, andRCSBORG1; all are verified against CDC's codebooks. The notes forEXERANY2andCVDEXR03now give the 2001 wording changes as the reason they are not comparable with their predecessors; the earlier notes blamed a don't-know recode that CDC's 2000 codebook shows never happened. - The data manifest now records upstream provenance for every annual asset: the CDC download URL of the source SAS Transport zip, that file's sha256 and size as downloaded, the download and processing dates, and the row and column counts of the published parquet. The fields are additive within manifest schema 2, so installed versions that predate them read the new manifest unchanged (#1).
brfss_year_info()reports the CDC source file behind each year: newsource_file,source_format, andsource_sha256columns plus adownloadeddate, joined from the same build-pipeline provenance record as the manifest (#5).brfss_year_info()$codebook_urlfor 1989 now points at CDC's web archive, where CDC moved that year's documentation page in August 2026; the live address returns 404 to scripts. The year inventory is fetched from the data-meta release, so installed versions pick the corrected address up without upgrading. The datasets article and the README no longer describe a 1984 public-use file as available. Its documentation is archived, but the file itself is no longer served.
From NEWS.md in the release
Install
Health
- OK13 OK2026-09-30
- ERROR12 OK, 1 ERROR2026-09-04
- OK7 OK2026-08-22
Documentation
The repository also keeps web-only articles.
- Help pages
- 18 (3 internal)includes a package overview page
- Examples that run
- 100%14 run in a plain check (5 of them under a condition)
- Exported functions with examples
- 92%
- Documented parameters
- 100%
- Return-value docs
- 92%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- not measured
- Median days to close, 50 most recently updated closed issues
- 4
- Median days to close, 50 most recently updated closed PRs
- not measured
Stars over time
Releases over time
Commits over time
14 development-tooling and community-health practices detected across 8 families in the upstream repository
Checks run against github.com/muntasirmasum/brfssdata on 2026-10-11.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-08-29 · The repository has a site deploy workflow
pkgdown site last built 2026-08-29, before release 0.1.1 (2026-10-18)
Show all practicesHide 4 practices
This repository shows signs of AI coding tools.
- Claude Codefirst seen 2026-08-02Named in .Rbuildignore: .claudeNamed in .gitignore: .claudeCommits: at least 19 crediting it in the message
Dependencies
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- 0.1.1Latest
- 0.1.02026-08-21
- RR 4.6.0 released · 2026-04-24
Package metadata
- First published
- 2026-08-21
- Total releases
- 2 / 1 yrs
- License
- MIT + file LICENSE OSI
- Minimum R
- ≥ 4.2
- Bundled data
- 1.7 KB / 2 files
- Download size
- 457 KB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("brfssdata")The package provides a citation file that builds its entry when R runs it. Run citation() to see it.
The repository also keeps a CITATION.cff.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-19, which the citation names so these numbers can be found later. More on citing and the projects behind them.