irae_hypothyroidism_grading: irAE Grading for Hypothyroidism

In cliot: Clinical Indices and Outcomes Tools

irAE Grading for Hypothyroidism

Description

Calculates the CTCAE severity grade for hypothyroidism associated with immune checkpoint inhibitor (ICPi) therapy. Grading relies on the presence of symptoms, the impact on Activities of Daily Living (ADL), and the presence of life-threatening consequences (e.g., myxedema coma).

Usage

irae_hypothyroidism_grading(symptomatic, adl_limitation, life_threatening)

Arguments

symptomatic	Numeric (0 or 1). Are symptoms present? (1 = Yes).
adl_limitation	Numeric (0, 1, or 2). Limitation of Activities of Daily Living. 0: No limitation. 1: Limiting instrumental ADL (e.g., preparing meals, shopping). 2: Limiting self-care ADL (e.g., bathing, dressing, feeding).
life_threatening	Numeric (0 or 1). Are there life-threatening consequences? (1 = Yes).

Value

A list containing:

CTCAE_Grade	The calculated adverse event grade (1-4).
Definition	Clinical description of the grade.
Management_Recommendation	Guidance on ICPi continuation and thyroid replacement based on ASCO guidelines.

References

Brahmer JR, Lacchetti C, Schneider BJ, et al. Management of Immune-Related Adverse Events in Patients Treated With Immune Checkpoint Inhibitor Therapy: American Society of Clinical Oncology Clinical Practice Guideline. J Clin Oncol. 2018;36(17):1714-1768. doi:10.1200/JCO.2017.77.6385

Examples

# Example 1: Grade 2 (Symptomatic)
# Symptoms Present, Instrumental ADL limited, Not life-threatening
irae_hypothyroidism_grading(1, 1, 0)

# Example 2: Grade 1 (Asymptomatic)
# TSH elevated but patient feels fine
irae_hypothyroidism_grading(0, 0, 0)

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