Version 1.0.0 (2025-11-29)

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