novel_pneumonia_risk_score: Novel Pneumonia Risk Score (PRS)

In cliot: Clinical Indices and Outcomes Tools

Novel Pneumonia Risk Score (PRS)

Description

Calculates the Novel Pneumonia Risk Score (PRS) to estimate the risk of developing community-acquired pneumonia in primary care patients. The score is based on age, sex, comorbidities (heart failure, COPD, epilepsy, Parkinson's), history of pneumonia, and current medication use (PPIs, opioids).

Usage

novel_pneumonia_risk_score(age, sex, heart_failure, copd, epilepsy,
                           parkinsons, previous_pneumonia, current_ppi_use,
                           current_opioid_use)

Arguments

age	Numeric. Patient age in years. (Score adds Age / 10).
sex	String. Patient sex ("Male" or "Female"). (Male adds 1 point).
heart_failure	Numeric (0 or 1). History of heart failure. (1 = Yes, +1 point).
copd	Numeric (0 or 1). History of COPD. (1 = Yes, +1 point).
epilepsy	Numeric (0 or 1). History of epilepsy. (1 = Yes, +1 point).
parkinsons	Numeric (0 or 1). History of Parkinson's disease. (1 = Yes, +1 point).
previous_pneumonia	Numeric (0 or 1). History of previous pneumonia (within the last 3 years). (1 = Yes, +3 points).
current_ppi_use	Numeric (0 or 1). Current use of Proton Pump Inhibitors (PPIs). (1 = Yes, +2 points).
current_opioid_use	Numeric (0 or 1). Current use of opioids. (1 = Yes, +2 points).

Value

A list containing:

PRS_Score	The calculated risk score.
Risk_Category	Classification (Low < 10, Medium 10-15, High > 15).

References

Hamilton F, et al. A simple clinical risk score to predict the risk of pneumonia in primary care. Eur Respir J. 2019.

Examples

# Example 1: Low Risk
# 50yo Female, No comorbidities
# Score = 5.0
novel_pneumonia_risk_score(50, "female", 0, 0, 0, 0, 0, 0, 0)

# Example 2: High Risk
# 75yo Male (+8.5), COPD (+1), Prev Pneumonia (+3), PPI (+2)
# Score = 7.5 + 1 + 1 + 3 + 2 = 14.5 (Medium/High border)
novel_pneumonia_risk_score(75, "male", 0, 1, 0, 0, 1, 1, 0)

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