maggic_risk_score: MAGGIC Heart Failure Risk Calculator

In cliot: Clinical Indices and Outcomes Tools

MAGGIC Heart Failure Risk Calculator

Description

Calculates the MAGGIC (Meta-Analysis Global Group in Chronic Heart Failure) Risk Score to predict 1-year and 3-year mortality in patients with heart failure (both reduced and preserved ejection fraction).

Usage

maggic_risk_score(age, lvef, sbp, bmi, creatinine, nyha_class, sex, smoker,
                  diabetes, copd, heart_failure_duration_gt_18mo, beta_blocker_use,
                  acei_arb_use, creatinine_units = "mg/dL")

Arguments

age	Numeric. Patient age in years.
lvef	Numeric. Left Ventricular Ejection Fraction (%).
sbp	Numeric. Systolic Blood Pressure (mmHg).
bmi	Numeric. Body Mass Index (kg/m^2).
creatinine	Numeric. Serum Creatinine level.
nyha_class	Numeric (1-4). NYHA Functional Class.
sex	String. "Male" or "Female".
smoker	Numeric (0 or 1). Current smoker? (1 = Yes).
diabetes	Numeric (0 or 1). History of Diabetes? (1 = Yes).
copd	Numeric (0 or 1). History of COPD? (1 = Yes).
heart_failure_duration_gt_18mo	Numeric (0 or 1). Diagnosed with Heart Failure > 18 months ago? (1 = Yes).
beta_blocker_use	Numeric (0 or 1). Currently taking a Beta-blocker? (1 = Yes).
acei_arb_use	Numeric (0 or 1). Currently taking an ACE inhibitor or ARB? (1 = Yes).
creatinine_units	String. Units for creatinine. "mg/dL" (default) or "micromol/L" (or "umol/L").

Value

A list containing:

MAGGIC_Risk_Score	The calculated total integer score.
One_Year_Mortality_Risk	Estimated probability of death at 1 year.
Three_Year_Mortality_Risk	Estimated probability of death at 3 years.

References

Pocock SJ, Ariti CA, McMurray JJ, et al. Predicting survival in heart failure: a risk score based on 39 372 patients from 30 studies. Eur Heart J. 2013;34(19):1404-1413. doi:10.1093/eurheartj/ehs337

Examples

# Example 1: High Risk
# 75yo, EF 25, SBP 105, BMI 22, Cr 1.8, NYHA III, Male, COPD, No meds
maggic_risk_score(75, 25, 105, 22, 1.8, 3, "male", 0, 0, 1, 1, 0, 0)

# Example 2: Low Risk
# 50yo, EF 45, SBP 130, BMI 30, Cr 1.0, NYHA I, Female, No comorbidities, On meds
maggic_risk_score(50, 45, 130, 30, 1.0, 1, "female", 0, 0, 0, 0, 1, 1)

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