Skip to contents

Changelog

Source: NEWS.md

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