get_ccsr_description: Get CCSR Category Descriptions

In HCUPtools: Access and Work with HCUP Resources and Datasets

Get CCSR Category Descriptions

Description

Retrieves the full clinical description for one or more CCSR category codes. This function helps users interpret CCSR codes by providing their meaningful clinical descriptions.

Usage

get_ccsr_description(ccsr_codes, map_df = NULL, type = NULL)

Arguments

ccsr_codes	Character vector of CCSR category codes (e.g., "ADM010", "NEP003", "CIR019").
map_df	Optional. A tibble containing CCSR mapping data with descriptions. If provided, descriptions are extracted from this data frame. If NULL (default), the function will attempt to download the latest mapping file to extract descriptions.
type	Character string specifying the type of CCSR codes. Must be one of: "diagnosis" (or "dx") or "procedure" (or "pr"). If NULL (default), the function will attempt to infer the type from the codes or mapping data.

Details

CCSR category codes follow specific naming conventions:

• Diagnosis codes: Typically start with letters (e.g., "ADM010", "NEP003")

• Procedure codes: Typically start with letters (e.g., "PRC001", "PRC002")

If a description is not found for a code, it will be marked as NA in the result.

Value

A tibble with columns:

• ccsr_code: The CCSR category code

• description: The full clinical description

• Additional metadata columns if available in the mapping data

Examples

# Get descriptions using downloaded mapping data
dx_map <- download_ccsr("diagnosis")
get_ccsr_description(c("ADM010", "NEP003", "CIR019"), map_df = dx_map)

# Get descriptions without pre-downloaded data (will download automatically)
get_ccsr_description(c("ADM010", "NEP003"), type = "diagnosis")

HCUPtools documentation built on July 13, 2026, 9:06 a.m.