NEWS

---

HCUPtools 1.0.1

Bug fixes

• download_ccsr() / read_ccsr(): Strip surrounding quotes from character columns in HCUP CSVs so ICD and CCSR values join reliably.
• ccsr_map(): Diagnosis mapping now expands CCSR Category 1–6 so cross-classifications appear in long and wide outputs; wide uses slot-aligned CCSR_1…CCSR_6; long diagnosis output includes is_default; fixed spurious wide column from unmatched rows.
• get_ccsr_description(): Normalize quoted CCSR codes when matching.
• list_ccsr_versions(): Merge scraped versions with direct file checks so current releases (e.g. v2026.1) appear.
• ccsr_changelog(): When version is explicit, skip interactive prompts for import format and sheet selection by default.
• CRAN / R CMD check: inst/CITATION now uses bibentry(); examples that require network, local files, or optional PDF tooling use \donttest{}; unused pkgdown removed from Suggests; non-package paths added to .Rbuildignore.

---

HCUPtools 1.0.0 (2025-12-10)

Features

CCSR Mapping Functions

• download_ccsr(): Download CCSR mapping files directly from HCUP website

  • Support for both diagnosis (ICD-10-CM) and procedure (ICD-10-PCS) mappings
  • Automatic version detection and "latest" version support
  • Intelligent caching to avoid redundant downloads
  • Proper encoding and leading zero preservation for ICD-10 codes

• read_ccsr(): Read CCSR mapping files from disk

  • Support for ZIP, CSV, Excel, and directory formats
  • Automatic cache discovery and interactive file selection
  • Optional data.table output for large datasets

• ccsr_map(): Map ICD-10 codes to CCSR categories

  • Multiple output formats: long (default), wide, and default-only
  • Support for cross-classification (one-to-many mappings)
  • Default category extraction for principal diagnosis analysis
  • Automatic type inference (diagnosis vs. procedure)

• get_ccsr_description(): Retrieve clinical descriptions for CCSR codes

  • Automatic download if mapping file not provided
  • Support for both diagnosis and procedure codes
  • Returns comprehensive description data frames

• list_ccsr_versions(): List available CCSR versions

  • Dynamic version discovery from HCUP website
  • Support for filtering by type (diagnosis/procedure)
  • Caching for improved performance

• ccsr_changelog(): Access CCSR change logs

  • Multiple formats: URL, text, view (PDF), download, and read (data table)
  • Interactive selection of change log files
  • Support for version ranges and specific versions
  • Automatic discovery of available change logs

HCUP Summary Trend Tables Functions

• download_trend_tables(): Download HCUP Summary Trend Tables

  • Interactive menu for table selection
  • Support for downloading all tables as ZIP file
  • Automatic fallback to individual downloads if ZIP unavailable
  • Dynamic discovery of available tables from HCUP website

• read_trend_table(): Read Summary Trend Table Excel files

  • Automatic cache discovery and interactive file selection
  • Interactive sheet selection (National, states, etc.)
  • Automatic metadata sheet detection and filtering
  • Support for data.table output

• list_trend_table_sheets(): List available sheets in trend table files

  • Identifies data sheets vs. metadata sheets
  • Provides sheet recommendations

Utility Functions

• hcup_citation(): Generate proper citations for HCUP resources
  • Support for CCSR and Summary Trend Tables
  • Multiple formats: text, BibTeX, and R citation objects
  • Automatic version detection for latest citations
  • Compliant with HCUP publishing requirements

Technical Details

• UTF-8 encoding support for proper handling of special characters
• ICD-10 codes preserved as character strings with leading zeros
• Intelligent file caching to reduce network requests
• Comprehensive error messages and validation
• User-friendly interactive selection for files and options
• Support for tibbles and optional data.table output
• Automatic latest version detection and historical version support

Documentation

• Comprehensive README with usage examples
• Detailed function documentation with roxygen2
• Vignette with complete workflow examples
• Legal disclaimer and compliance information
• Proper citation examples

Compliance

• Only accesses publicly available, free HCUP resources
• Does NOT access paid HCUP databases (NIS, KID, SID, NEDS, etc.)
• Facilitates direct download from official HCUP website
• Includes proper legal disclaimers and user responsibility statements
• Provides links to all relevant HCUP policies and agreements
• Package is not affiliated with AHRQ/HCUP