Pulmonary Dynamic Flow-Volume Loop (FEF25-75) Skill

Dynamic Spirometry Flow-Volume Loop and Maximum Mid-Expiratory Flow ($\text{FEF}_{25-75%} / \text{MMEF}$) Analyzer based on respiratory mechanics.

flowchart TD
    A[Maximal Flow-Volume Loop: FVC, FEV1, FEF25-75] --> B[Compute FEV1/FVC % & % Predicted FEF25-75]
    A --> C[Calculate FEF50 / FIF50 Ratio]
    B & C --> D{Pattern Evaluation}
    D -- FEV1/FVC < 70% --> E[Classical Obstructive Defect]
    D -- FEF50/FIF50 > 1.5 --> F[Variable Extrathoracic Obstruction]
    D -- FEF25-75 < 65% & Normal FEV1/FVC --> G[Isolated Small Airway Disease]

Features

• Zero PIP Dependencies: Implemented strictly with Python Standard Library (math, json, sys, typing).
• Small Airway Sensitivity: Detects subtle peripheral bronchiolar narrowing overlooked by standard $\text{FEV}_1$.
• Anatomical Differential: Discriminates extrathoracic vs intrathoracic upper airway limitations.
• Dual Architecture: Native Python import and Model Context Protocol (MCP) JSON-RPC 2.0 stdio server.

Quickstart

python example_usage.py

License

Apache-2.0