dsm5_bipolar_criteria: DSM-5 Criteria for Bipolar Disorder

In cliot: Clinical Indices and Outcomes Tools

DSM-5 Criteria for Bipolar Disorder

Description

Evaluates patient symptoms against the DSM-5 criteria for Bipolar I and Bipolar II Disorders. The function determines if a distinct period of abnormal mood qualifies as a Manic or Hypomanic episode based on symptom count, duration, and severity, and then applies diagnostic hierarchy (e.g., presence of Mania implies Bipolar I; Hypomania + Major Depression implies Bipolar II).

Usage

dsm5_bipolar_criteria(symptom_count, irritable_mood_only, duration_days,
                      hospitalized, psychotic_features, marked_impairment,
                      history_mde, substance_medical_excluded)

Arguments

symptom_count	Numeric. Number of Criterion B symptoms present (e.g., grandiosity, decreased sleep, pressured speech, flight of ideas, distractibility, increased activity, risk-taking).
irritable_mood_only	Numeric (0 or 1). Is the mood disturbance characterized ONLY by irritability (without elation/expansiveness)? (1 = Yes). If Yes, the symptom threshold increases from 3 to 4.
duration_days	Numeric. Duration of the mood disturbance in days.
hospitalized	Numeric (0 or 1). Did the episode require hospitalization? (1 = Yes).
psychotic_features	Numeric (0 or 1). Were psychotic features present? (1 = Yes).
marked_impairment	Numeric (0 or 1). Did the episode cause marked impairment in social or occupational functioning? (1 = Yes).
history_mde	Numeric (0 or 1). Is there a history of at least one Major Depressive Episode? (1 = Yes). Required for Bipolar II diagnosis.
substance_medical_excluded	Numeric (0 or 1). Have physiological effects of a substance or another medical condition been ruled out? (1 = Yes).

Value

A list containing:

Diagnosis	The provisional diagnosis (Bipolar I, Bipolar II, or Criteria Not Met).
Current_Episode_Type	Classification of the current/reported episode (Manic, Hypomanic, or None).

References

American Psychiatric Association. Diagnostic and Statistical Manual of Mental Disorders. 5th ed. Arlington, VA: American Psychiatric Association; 2013.

Examples

# Example 1: Bipolar I (Manic Episode)
# 3 symptoms, elated mood (irritable=0), 7 days duration, marked impairment
dsm5_bipolar_criteria(3, 0, 7, 0, 0, 1, 1, 1)

# Example 2: Bipolar II (Hypomanic + MDE)
# 4 symptoms, 4 days, no severe features, History of MDE
dsm5_bipolar_criteria(4, 0, 4, 0, 0, 0, 1, 1)

# Example 3: Criteria Not Met (Duration too short)
# 3 symptoms, 2 days, no hospitalization
dsm5_bipolar_criteria(3, 0, 2, 0, 0, 0, 1, 1)

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