readmit (version 0.0.1)

hsr_payment_summary: Extract payment summary information from a Hospital-Specific Report (HSR)

Description

Parses the Table 1 payment summary from the HSR, including (but not limited to) the payment penalty, peer group the hospital was compared against, and dual proportion that determines peer group assignment.

Note: CMS changed the format of Hospital-Specific Reports (HSRs) for FY2026 (see here). The current HSR functions support formats through FY2025.

Usage

hsr_payment_summary(file)
hsr_count_dual_stays(file)
hsr_count_total_stays(file)
hsr_dual_proportion(file)
hsr_peer_group(file)
hsr_neutrality_modifier(file)
hsr_payment_adjustment_factor(file)
hsr_payment_penalty(file)

Value

• hsr_payment_summary() returns a tibble::tibble() containing the full Table 1 parsed from the report.

• Additional convenience functions extract specific columns from this table, and always return a numeric value.

Arguments

file

File path to a report. For convenience functions, this can also be the pre-parsed table from hsr_extract_payment_summary() (to minimize file I/O).

Examples

# Access a report
my_report <- hsr_mock_reports("FY2025_HRRP_MockHSR.xlsx")

# Full payment summary table
payment_summary <- hsr_payment_summary(my_report)
payment_summary


# Extract individual components (from file)
hsr_payment_penalty(my_report)

# Or existing extract
hsr_payment_penalty(payment_summary)