{ "_id": "6ac0bc4791601a2ad2997fe3", "Package": "nhanesR", "Type": "Package", "Title": "Download, Parse, and Analyze NHANES Data with Mortality Linkage", "Version": "0.1.7", "Authors@R": "person(\"David\", \"Winsemius\", email = \"dwinsemius@comcast.net\",\nrole = c(\"aut\", \"cre\"))", "Description": "Provides tools for downloading and organizing National\nHealth and Nutrition Examination Survey (NHANES) public-use\ndata files and the National Center for Health Statistics (NCHS)\nPublic-Use Linked Mortality Files (LMF). Supports structured\nlocal caching, codebook access, survey-aware merging, and\npreparation of survival analysis datasets using NHANES-National\nDeath Index (NDI) linked mortality data (follow-up through\nDecember 31, 2019). NHANES methodology is described at\n.", "License": "MIT + file LICENSE", "Encoding": "UTF-8", "Language": "en-US", "Roxygen": "list(markdown = TRUE)", "Config/testthat/edition": "3", "VignetteBuilder": "knitr", "URL": "https://dwinsemius.github.io/nhanesR/,\nhttps://github.com/dwinsemius/nhanesR", "BugReports": "https://github.com/dwinsemius/nhanesR/issues", "Config/roxygen2/version": "8.1.0", "Config/pak/sysreqs": "make libssl-dev libx11-dev zlib1g-dev", "Repository": "https://dwinsemius.r-universe.dev", "Date/Publication": "2026-10-03 04:30:09 UTC", "RemoteUrl": "https://github.com/dwinsemius/nhanesr", "RemoteRef": "HEAD", "RemoteSha": "013da89ccc1a59ee9ce442dcc8d066d6352eaa23", "NeedsCompilation": "no", "Packaged": { "Date": "2026-10-03 08:23:47 UTC", "User": "root" }, "Author": "David Winsemius [aut, cre]", "Maintainer": "David Winsemius ", "_user": "dwinsemius", "_type": "src", "_file": "nhanesR_0.1.7.tar.gz", "_fileid": "https://r2.ropensci.org/5b79d47bc3fd63dc42800c51d89b85bb5eba9a4efb82c0dd11a1194947e3ede6", "_filesize": 718524, "_sha256": "5b79d47bc3fd63dc42800c51d89b85bb5eba9a4efb82c0dd11a1194947e3ede6", "_expires": "2027-01-11T08:26:45.000Z", "_created": "2026-10-03T08:23:47.000Z", "_published": "2026-10-03T08:26:47.721Z", "_jobs": [ { "job": 111164702020, "time": 142, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "11269366491" }, { "job": 111164701982, "time": 134, "config": "linux-release-x86_64", "r": "4.6.1", "check": "OK", "artifact": "11269062077" }, { "job": 111164701986, "time": 103, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "OK", "artifact": "11269435866" }, { "job": 111164702002, "time": 101, "config": "macos-release-arm64", "r": "4.6.1", "check": "OK", "artifact": "11269550468" }, { "job": 111164161440, "time": 204, "config": "source", "r": "4.6.1", "check": "OK", "artifact": "11268654823" }, { "job": 111164701925, "time": 110, "config": "wasm-release", "r": "4.6.0", "check": "OK", "artifact": "11269017095" }, { "job": 111164701993, "time": 76, "config": "windows-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "11268709884" }, { "job": 111164702060, "time": 81, "config": "windows-oldrel-x86_64", "r": "4.5.3", "check": "OK", "artifact": "11269780036" }, { "job": 111164702062, "time": 102, "config": "windows-release-x86_64", "r": "4.6.1", "check": "OK", "artifact": "11269331431" } ], "_host": "GitHub-Actions", "_buildurl": "https://github.com/r-universe/dwinsemius/actions/runs/37109356788", "_status": "success", "_upstream": "https://github.com/dwinsemius/nhanesr", "_commit": { "id": "013da89ccc1a59ee9ce442dcc8d066d6352eaa23", "author": "David Winsemius ", "committer": "David Winsemius ", "message": "Rebuild pkgdown site: NHANES III column-selection functions\n\nNew reference pages for nhanes3_files, nhanes3_download, nhanes3_layout and nhanes3_read,\nthe new reference section, the updated package page, NHANES III article, news, search index\nand sitemap. Two pages whose only differences were temp-folder names and download timings\nin their example output were left as committed.\n\nCo-Authored-By: Claude Sonnet 5.5 \n", "time": 1791001809 }, "_maintainer": { "name": "David Winsemius", "email": "dwinsemius@comcast.net", "login": "dwinsemius", "description": "Retired. Former Medical director for Heritage Labs (since acquired by CRL) and for several life insurance companies. Prev. Asst Professor of Family Med, UCONN", "uuid": 5042744 }, "_distro": "resolute", "_registered": true, "_dependencies": [ { "package": "R", "version": ">= 4.1.0", "role": "Depends" }, { "package": "httr2", "version": ">= 1.0.0", "role": "Imports" }, { "package": "haven", "version": ">= 2.5.0", "role": "Imports" }, { "package": "readr", "version": ">= 2.1.0", "role": "Imports" }, { "package": "rlang", "version": ">= 1.1.0", "role": "Imports" }, { "package": "cli", "version": ">= 3.6.0", "role": "Imports" }, { "package": "stats", "role": "Imports" }, { "package": "utils", "role": "Imports" }, { "package": "tools", "role": "Imports" }, { "package": "foreign", "role": "Suggests" }, { "package": "SAScii", "role": "Suggests" }, { "package": "survey", "role": "Suggests" }, { "package": "survival", "role": "Suggests" }, { "package": "mgcv", "role": "Suggests" }, { "package": "rvest", "role": "Suggests" }, { "package": "Hmisc", "role": "Suggests" }, { "package": "testthat", "version": ">= 3.0.0", "role": "Suggests" }, { "package": "knitr", "role": "Suggests" }, { "package": "rmarkdown", "role": "Suggests" } ], "_owner": "dwinsemius", "_selfowned": true, "_usedby": 0, "_updates": [ { "week": "2026-22", "n": 37 }, { "week": "2026-23", "n": 5 }, { "week": "2026-25", "n": 5 }, { "week": "2026-26", "n": 7 }, { "week": "2026-27", "n": 4 }, { "week": "2026-28", "n": 3 }, { "week": "2026-32", "n": 1 }, { "week": "2026-35", "n": 4 }, { "week": "2026-39", "n": 5 }, { "week": "2026-40", "n": 17 } ], "_tags": [], "_stars": 3, "_contributors": [ { "user": "dwinsemius", "count": 37, "uuid": 5042744 }, { "user": "claude", "count": 3, "uuid": 81847 } ], "_userbio": { "uuid": 5042744, "type": "user", "name": "David Winsemius", "followers": 0, "description": "Retired. Former Medical director for Heritage Labs (since acquired by CRL) and for several life insurance companies. Prev. Asst Professor of Family Med, UCONN" }, "_downloads": { "count": 362, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/nhanesR" }, "_devurl": "https://github.com/dwinsemius/nhanesr", "_pkgdown": "https://dwinsemius.github.io/nhanesR/", "_searchresults": 35, "_rbuild": "4.6.1", "_assets": [ "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/manual.pdf", "extra/NEWS.html", "extra/NEWS.txt", "extra/nhanesR.html", "extra/readme.html", "extra/readme.md", "LICENSE" ], "_homeurl": "https://github.com/dwinsemius/nhanesr", "_realowner": "dwinsemius", "_cranurl": true, "_releases": [ { "version": "0.1.5", "date": "2026-07-17" }, { "version": "0.1.6", "date": "2026-08-25" } ], "_exports": [ "mortality_tabulation", "NH_describe", "NH_label", "nhanes_cache_dir", "nhanes_cycles", "nhanes_download", "nhanes_download_analyte", "nhanes_followup_summary", "nhanes_harmonize", "nhanes_lmf_cycles", "nhanes_manifest", "nhanes_merge", "nhanes_mortality_download", "nhanes_mortality_link", "nhanes_mortality_parse", "nhanes_search_variables", "nhanes_stack", "nhanes_survival_prep", "nhanes_ucod_labels", "nhanes_variable_map", "nhanes3_download", "nhanes3_files", "nhanes3_layout", "nhanes3_read", "nhis_data_years", "nhis_download", "nhis_lmf_years", "nhis_mortality_download", "nhis_mortality_link", "nhis_mortality_parse", "svycph_fuse", "svycph_set_basehaz", "tabulation_grid", "weighted_basehaz" ], "_help": [ { "page": "mortality_tabulation", "title": "Tabulate deaths, person-years and crude mortality rates", "topics": [ "mortality_tabulation" ] }, { "page": "NH_describe", "title": "NHANES-annotated variable descriptions", "topics": [ "NH_describe" ] }, { "page": "NH_label", "title": "Attach CDC variable descriptions as Hmisc-style labels", "topics": [ "NH_label" ] }, { "page": "nhanes_cache_dir", "title": "Get or set the nhanesR local cache directory", "topics": [ "nhanes_cache_dir" ] }, { "page": "nhanes_cycles", "title": "List available NHANES cycles", "topics": [ "nhanes_cycles" ] }, { "page": "nhanes_download", "title": "Download and cache NHANES XPT data files", "topics": [ "nhanes_download" ] }, { "page": "nhanes_download_analyte", "title": "Download NHANES files for an analyte using the CDC variable catalog", "topics": [ "nhanes_download_analyte" ] }, { "page": "nhanes_followup_summary", "title": "Summarize mortality follow-up by cycle", "topics": [ "nhanes_followup_summary" ] }, { "page": "nhanes_harmonize", "title": "Harmonize variable names across NHANES cycles and stack into one data frame", "topics": [ "nhanes_harmonize" ] }, { "page": "nhanes_lmf_cycles", "title": "List NHANES cycles with a public-use LMF", "topics": [ "nhanes_lmf_cycles" ] }, { "page": "nhanes_manifest", "title": "List available files for a NHANES cycle and component", "topics": [ "nhanes_manifest" ] }, { "page": "nhanes_merge", "title": "Merge NHANES component data frames by SEQN", "topics": [ "nhanes_merge" ] }, { "page": "nhanes_mortality_download", "title": "Download NHANES Public-Use Linked Mortality Files", "topics": [ "nhanes_mortality_download" ] }, { "page": "nhanes_mortality_link", "title": "Link mortality data onto an NHANES analytic dataset", "topics": [ "nhanes_mortality_link" ] }, { "page": "nhanes_mortality_parse", "title": "Parse NHANES Linked Mortality Files into data frames", "topics": [ "nhanes_mortality_parse" ] }, { "page": "nhanes_search_variables", "title": "Search NHANES variables by keyword", "topics": [ "nhanes_search_variables" ] }, { "page": "nhanes_stack", "title": "Stack NHANES data across multiple cycles", "topics": [ "nhanes_stack" ] }, { "page": "nhanes_survival_prep", "title": "Prepare an NHANES-LMF dataset for survival analysis", "topics": [ "nhanes_survival_prep" ] }, { "page": "nhanes_ucod_labels", "title": "Lookup table for UCOD_LEADING cause-of-death codes", "topics": [ "nhanes_ucod_labels" ] }, { "page": "nhanes_variable_map", "title": "Build a per-cycle variable map for an analyte", "topics": [ "nhanes_variable_map" ] }, { "page": "nhanes3_download", "title": "Download NHANES III files into the nhanesR cache", "topics": [ "nhanes3_download" ] }, { "page": "nhanes3_files", "title": "List the NHANES III data files and their CDC addresses", "topics": [ "nhanes3_files" ] }, { "page": "nhanes3_layout", "title": "The variables in an NHANES III file: names, labels and column positions", "topics": [ "nhanes3_layout" ] }, { "page": "nhanes3_read", "title": "Read chosen columns of an NHANES III file", "topics": [ "nhanes3_read" ] }, { "page": "nhis_data_years", "title": "List NHIS survey years with Household/Person data available", "topics": [ "nhis_data_years" ] }, { "page": "nhis_download", "title": "Download and parse an NHIS Household or Person file", "topics": [ "nhis_download" ] }, { "page": "nhis_lmf_years", "title": "List NHIS survey years with a public-use LMF", "topics": [ "nhis_lmf_years" ] }, { "page": "nhis_mortality_download", "title": "Download NHIS Public-Use Linked Mortality Files", "topics": [ "nhis_mortality_download" ] }, { "page": "nhis_mortality_link", "title": "Link NHIS mortality data onto an NHIS analytic dataset", "topics": [ "nhis_mortality_link" ] }, { "page": "nhis_mortality_parse", "title": "Parse NHIS Linked Mortality Files into data frames", "topics": [ "nhis_mortality_parse" ] }, { "page": "svycph_fuse", "title": "Fuse svycoxph and cph objects for rms ecosystem compatibility", "topics": [ "svycph_fuse" ] }, { "page": "svycph_set_basehaz", "title": "Substitute weighted baseline hazard into a fused cph object", "topics": [ "svycph_set_basehaz" ] }, { "page": "tabulation_grid", "title": "Pivot a mortality tabulation into a two-way grid", "topics": [ "tabulation_grid" ] }, { "page": "weighted_basehaz", "title": "Compute survey-weighted cumulative baseline hazard with variance", "topics": [ "weighted_basehaz" ] } ], "_readme": "https://github.com/dwinsemius/nhanesr/raw/HEAD/README.md", "_rundeps": [ "askpass", "bit", "bit64", "cli", "clipr", "cpp11", "crayon", "curl", "forcats", "glue", "haven", "hms", "httr2", "lifecycle", "magrittr", "openssl", "pillar", "pkgconfig", "prettyunits", "progress", "R6", "readr", "rlang", "sys", "tibble", "tidyselect", "tzdb", "utf8", "vctrs", "vroom", "withr" ], "_vignettes": [ { "source": "survival-framework-comparison.Rmd", "filename": "survival-framework-comparison.html", "title": "Comparing Survival Frameworks: Cox, Piecewise Exponential, and mgcv-Poisson", "engine": "knitr::rmarkdown", "headings": [ "Motivation", "Key references", "Notation", "Cox: the partial-likelihood contribution", "Piecewise exponential: the Poisson-trick contribution", "Profiling out $\\alpha_k$ recovers Cox", "mgcv-Poisson (PAMM): the same contribution, a penalized $\\alpha_k$", "Side-by-side comparison", "Design weights: why the effect on β differs from the effect on marginal means", "The marginal case: weighted mean as an intercept-only estimating equation", "The conditional case: Binder's (1992) weighted partial likelihood", "Why the numerator doesn't need weighting but the denominator does", "A runnable numeric demonstration", "Convergence of PEM toward Cox as $K \\to \\infty$", "Baseline cumulative hazard: three estimates, one true curve", "Design weights: conditional robustness vs. marginal sensitivity", "Discussion", "Current limitations of this document", "Session information" ], "created": "2026-08-09 22:56:00", "modified": "2026-08-09 22:56:00", "commits": 1 }, { "source": "nhanesR-overview.Rmd", "filename": "nhanesR-overview.html", "title": "Getting Started with nhanesR", "engine": "knitr::rmarkdown", "headings": [ "What nhanesR does", "Installation", "Setup and options", "Default cache location", "Permanent configuration via .Rprofile", "Checking and changing settings interactively", "Function map", "Stage 1 — Discovery", "Stage 2 — Variable search", "Stage 3 — Download", "Stage 4 — Harmonize and stack", "Stage 5 — Mortality linkage", "Stage 6 — Survival analysis preparation", "Cache management", "Typical workflow", "Further reading" ], "created": "2026-05-28 19:42:26", "modified": "2026-08-24 20:17:02", "commits": 7 }, { "source": "analyte-harmonization.Rmd", "filename": "analyte-harmonization.html", "title": "Navigating Variable Name Changes and Analyte Gaps in NHANES", "engine": "knitr::rmarkdown", "headings": [ "The problem", "The quality gap in published NHANES research", "Two structural barriers to full-cycle, properly-weighted analyses", "A pragmatic, hypothesis-first approach", "The analytic panel", "The CDC catalog gap for 1999–2002 BIOPRO data", "Step 1: Discovering where an analyte lives", "Example 1: A well-behaved analyte", "Example 2: A variable with a prefix change", "Example 3: An analyte missing from one cycle", "Example 4: An analyte confined to a few cycles", "Example 5: A questionnaire variable with a case change", "Step 2: Downloading with automatic harmonisation", "Downloading ALP across all available cycles", "Downloading ALT across all available cycles", "Downloading AST across its available cycles", "Downloading the questionnaire variable with a case change", "Example 6: Disambiguation by component — serum versus urine albumin", "Step 3: Assembling the multi-analyte base", "Step 4: Derived variables", "What the manual approach looks like", "Using nhanesR with AI coding assistants", "Further reading", "Summary of functions used", "Session information" ], "created": "2026-06-02 22:50:04", "modified": "2026-06-23 06:05:32", "commits": 4 }, { "source": "nhanes-iii.Rmd", "filename": "nhanes-iii.html", "title": "NHANES III (1988-1994): Fixed-Width Files, Cotinine, and Mortality", "engine": "knitr::rmarkdown", "headings": [ "Overview", "1. Download the files", "2. Read column positions from the SAS program", "3. Read only the columns you need", "The same steps with the package functions", "4. Missing-value codes", "5. Look up variables in the codebook", "6. Smoking status, checked against cotinine", "7. Link mortality", "8. Survey-weighted Cox model", "Notes" ], "created": "2026-09-30 23:53:37", "modified": "2026-10-03 04:21:33", "commits": 4 }, { "source": "nhanes-mortality-workflow.Rmd", "filename": "nhanes-mortality-workflow.html", "title": "NHANES Mortality Linkage: A Complete Workflow", "engine": "knitr::rmarkdown", "headings": [ "Overview", "Package options", "Background: NHANES structure", "1. What cycles and files are available?", "2. Discover variables", "3. Download laboratory data", "4. Download questionnaire data", "5. Harmonize across cycles", "6. Recode questionnaire variables", "7. Stack demographics and merge all components", "8. Link mortality and prepare the survival dataset", "9. Survey-weighted Cox model", "Choosing the correct survey weight", "Pooling across cycles", "Notes on data management", "Cross-cycle variable harmonization", "SEQN is a character identifier", "NHANES questionnaire coding", "Notes on the public-use LMF" ], "created": "2026-05-26 23:29:29", "modified": "2026-08-25 22:35:19", "commits": 15 }, { "source": "survey-weighted-survival.Rmd", "filename": "survey-weighted-survival.html", "title": "Survey-Weighted Survival Analysis: Fusing svycoxph and rms", "engine": "knitr::rmarkdown", "headings": [ "Background and Motivation", "Why not just use cph()?", "Why not just use svycoxph()?", "The fusion approach", "Key references", "Step 1: Examine object structures", "Comparing weighted and unweighted estimates", "Step 2: Identify Design slot dependencies", "Step 3: Implement the fusion", "Comparing anova.rms() output: survey-correct vs naive", "Step 4: Survey-weighted baseline hazard", "Step 5: Degrees of freedom correction", "Conclusions and current limitations", "What works", "Empirical demonstration of design effects", "When survey weighting is and is not necessary", "Current limitations", "The nhanesR package", "A broader methodological agenda", "Session information" ], "created": "2026-06-23 00:37:53", "modified": "2026-08-25 22:35:19", "commits": 3 }, { "source": "uacr-bridging.Rmd", "filename": "uacr-bridging.html", "title": "Urinary Albumin-to-Creatinine Ratio Across NHANES Cycles", "engine": "knitr::rmarkdown", "headings": [ "Overview", "Step 1 — Locate the variables", "Step 2 — Download and stack", "Step 3 — Calculate UACR", "Step 4 — Method comparability and bridging", "Known method changes", "Bridging equations for serum creatinine", "Step 5 — Survival analysis with survey weights", "Notes and caveats", "See also" ], "created": "2026-06-23 03:53:11", "modified": "2026-06-23 03:53:11", "commits": 1 } ], "_score": 6.565257343420214, "_indexed": true, "_nocasepkg": "nhanesr", "_universes": [ "dwinsemius" ], "_binaries": [ { "r": "4.7.0", "os": "linux", "version": "0.1.7", "date": "2026-10-03T08:26:04.000Z", "distro": "resolute", "commit": "013da89ccc1a59ee9ce442dcc8d066d6352eaa23", "fileid": "https://r2.ropensci.org/2032d5c9c93e7c7fc21b3a4dffc59909bcda6eb59fe1ce0a02fc620e37ce045a", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/dwinsemius/actions/runs/37109356788" }, { "r": "4.6.1", "os": "linux", "version": "0.1.7", "date": "2026-10-03T08:26:03.000Z", "distro": "resolute", "commit": "013da89ccc1a59ee9ce442dcc8d066d6352eaa23", "fileid": "https://r2.ropensci.org/e502ef9d4995c5f32bc81193de65c8c39f319236f24c72263e844a4b6f828b2f", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/dwinsemius/actions/runs/37109356788" }, { "r": "4.5.3", "os": "mac", "version": "0.1.7", "date": "2026-10-03T08:25:32.000Z", "commit": "013da89ccc1a59ee9ce442dcc8d066d6352eaa23", "fileid": "https://r2.ropensci.org/b80e96883eb34e927c9d189178491219ab71f2b6cf009debdaa4e55a11cca326", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/dwinsemius/actions/runs/37109356788" }, { "r": "4.6.1", "os": "mac", "version": "0.1.7", "date": "2026-10-03T08:25:28.000Z", "commit": "013da89ccc1a59ee9ce442dcc8d066d6352eaa23", "fileid": "https://r2.ropensci.org/75e5310a6cf956b6a880204cb38ea7ad97c95a43cb2fe7cf22fcb536c3ebf70e", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/dwinsemius/actions/runs/37109356788" }, { "r": "4.6.0", "os": "wasm", "version": "0.1.7", "date": "2026-10-03T08:25:58.000Z", "commit": "013da89ccc1a59ee9ce442dcc8d066d6352eaa23", "fileid": "https://r2.ropensci.org/272dda39a434c4dd47d879183e6691a8adf880b5ba87633567aa09c7a96e71c0", "status": "success", "buildurl": "https://github.com/r-universe/dwinsemius/actions/runs/37109356788" }, { "r": "4.7.0", "os": "win", "version": "0.1.7", "date": "2026-10-03T08:25:00.000Z", "commit": "013da89ccc1a59ee9ce442dcc8d066d6352eaa23", "fileid": "https://r2.ropensci.org/eb84bb01737ea00f9268991cf23bf9b480576d16bcdc8872acdee31b5497ce1b", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/dwinsemius/actions/runs/37109356788" }, { "r": "4.5.3", "os": "win", "version": "0.1.7", "date": "2026-10-03T08:24:58.000Z", "commit": "013da89ccc1a59ee9ce442dcc8d066d6352eaa23", "fileid": "https://r2.ropensci.org/7a1dd00c3395a6b46ba1338f84b94e0f27ec2f1b30d4d23cc89b9d6c1cc04af3", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/dwinsemius/actions/runs/37109356788" }, { "r": "4.6.1", "os": "win", "version": "0.1.7", "date": "2026-10-03T08:25:23.000Z", "commit": "013da89ccc1a59ee9ce442dcc8d066d6352eaa23", "fileid": "https://r2.ropensci.org/fafd7ff28e99de53882507e547a1593d5bd8b6137cfff2ceaf868fd969529a15", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/dwinsemius/actions/runs/37109356788" } ] }