acc_aha_hf_staging: ACC/AHA Heart Failure Staging

In cliot: Clinical Indices and Outcomes Tools

ACC/AHA Heart Failure Staging

Description

Determines the stage of Heart Failure (A, B, C, or D) based on the American College of Cardiology (ACC) and American Heart Association (AHA) guidelines. This classification emphasizes the development and progression of the disease, from patients at risk to those with refractory symptoms.

Usage

acc_aha_hf_staging(risk_factors, structural_disease, hf_symptoms, refractory_hf)

Arguments

risk_factors	Numeric (0 or 1). Patient has risk factors for HF (e.g., hypertension, diabetes, obesity, metabolic syndrome, family history of cardiomyopathy, or use of cardiotoxins) but no structural heart disease or symptoms.
structural_disease	Numeric (0 or 1). Patient has structural heart disease (e.g., prior MI, LV remodeling/LVH, low EF, valvular disease) but has never had signs or symptoms of HF.
hf_symptoms	Numeric (0 or 1). Patient has structural heart disease with prior or current symptoms of HF (e.g., dyspnea, fatigue, reduced exercise tolerance).
refractory_hf	Numeric (0 or 1). Patient has refractory HF requiring specialized interventions (e.g., marked symptoms at rest despite maximal medical therapy).

Value

A list containing:

Stage	The calculated ACC/AHA Stage (A, B, C, or D).
Description	Clinical description of the patient's status.
Management_Guidance	General therapeutic goals associated with the stage.

References

Yancy CW, Jessup M, Bozkurt B, et al. 2013 ACCF/AHA Guideline for the Management of Heart Failure. Circulation. 2013;128(16):e240-e327. doi:10.1161/CIR.0b013e31829e8776

Examples

# Example 1: Stage C (Symptomatic)
# Patient with structural disease and dyspnea
acc_aha_hf_staging(1, 1, 1, 0)

# Example 2: Stage A (At Risk)
# Hypertension only, no structural disease or symptoms
acc_aha_hf_staging(1, 0, 0, 0)

cliot documentation built on Dec. 1, 2025, 1:06 a.m.