ClarusC64/clinical-quad-oxygen-demand-buffer-lag-coupling-respiratory-collapse-v0.2

What this repo does

This dataset evaluates whether machine learning models can detect respiratory collapse cascade transitions using both system state and system trajectory.

Earlier Clarus datasets in the v0.1 series tested whether models could classify system state alone.

Clarus v0.2 datasets add a trajectory signal so models must determine not only where the system is, but where it is moving inside state space.

This benchmark therefore tests whether models can read trajectory inside state space and detect approaching instability even when the current state still appears locally stable.

Core quad

oxygendemand physiologicalbuffer interventiondelay organcoupling

These variables represent interacting physiological pressures influencing respiratory stability.

All variables are normalized between 0 and 1.

Together they define the current position of the system inside the stability manifold.

Trajectory Layer

This dataset includes a trajectory variable called drift_gradient.

drift_gradient measures the directional alignment between the system motion vector and the instability gradient of the system potential field.

Positive values indicate motion toward cascade. Negative values indicate motion toward recovery.

This converts the dataset from a static cascade classifier into a trajectory-aware cascade detection benchmark.

The key test is whether models can read trajectory inside state space rather than relying only on static variable levels.

Drift definition

Let system state be represented by vector x(t)

Previous state

x(t−1)

System motion

Δx = x(t) − x(t−1)

Instability gradient

g = ∇Φ(x)

Drift alignment

drift_gradient = (Δx · g) / (||Δx|| ||g||)

Interpretation

+1 system moving directly toward collapse 0 neutral movement −1 system moving toward recovery

Operational meaning

A positive drift_gradient such as +0.65 means the respiratory trajectory is strongly aligned toward collapse even if the current oxygen demand state appears moderately stable.

This is the false stability detection problem encoded by v0.2 datasets.

Prediction target

labelrespiratorycollapse

The label identifies whether the system is undergoing a respiratory collapse cascade transition.

High drift toward cascade can trigger a positive label even when state variables remain within nominal ranges.

Binary simplification note

Respiratory collapse evolves continuously in clinical systems.

For benchmarking purposes the outcome is simplified to binary classification:

0 stable respiratory regime 1 respiratory collapse cascade

Row structure

scenarioid oxygendemand physiologicalbuffer interventiondelay organcoupling driftgradient labelrespiratorycollapse

State variables range between 0 and 1.

drift_gradient ranges between −1 and +1.

Files

data/train.csv data/tester.csv scorer.py README.md

Evaluation

Binary classification metrics

accuracy precision recallcascadedetection falsesaferate f1 confusion_matrix

Primary metric

recallcascadedetection

This prioritizes early cascade detection before visible deterioration.

License

MIT

Structural Note

Clarus datasets explore instability dynamics in coupled systems.

The v0.2 series introduces trajectory awareness to evaluate whether models can detect movement toward failure boundaries rather than relying only on static state classification.

Production Deployment

These datasets support experimentation and benchmarking across domains including:

clinical deterioration infrastructure instability financial contagion AI multi-agent systems supply chain collapse

Enterprise & Research Collaboration

Organizations interested in trajectory-aware cascade detection or operational early-warning systems may collaborate with the Clarus project.