ClarusC64/clinical-quad-perfusion-buffer-lag-coupling-trauma-deterioration-v0.7

What this repo does

This repository contains a Clarus v0.7 dataset modeling trauma deterioration using a quad-coupling system representation.

The dataset extends the v0.6 intervention layer by introducing uncertainty geometry.

The question addressed by earlier versions was:

Can the system be stabilized?

v0.7 adds a second critical question:

How confident are we in that conclusion?

This allows Clarus to distinguish three operational states:

• confident deterioration • confident stabilization • uncertain regime

This distinction matters in trauma environments where false confidence can produce dangerous decisions.

Core quad

The system state is represented by four structural variables.

• perfusion • buffer • lag • coupling

These variables capture the structural state of the trauma system rather than individual clinical measurements.

Clinical variable mapping

This mapping connects the structural quad variables to commonly observed trauma indicators.

Prediction target

Target column:

labeltraumadeterioration

Default v0.7 rule:

label = 1 if stabilizationsuccess = 1 AND trajectoryshift < -0.10

Relaxed variant (optional):

label = 1 if stabilization_success = 1

The stricter rule ensures that a stabilization must produce a meaningful trajectory correction, not merely a temporary improvement.

Row structure

Each row represents a trauma system state and contains:

• system state variables • trajectory dynamics • boundary geometry • uncertainty geometry • perturbation information • recovery dynamics • intervention vector • stabilization outcome • classification label

Uncertainty signals

v0.7 introduces explicit uncertainty modeling.

Two signals are required.

boundaryuncertainty trajectoryuncertainty

An optional support signal may also be present.

regime_confidence

boundary_uncertainty

Normalized variance in the boundary_distance estimate across perturbation samples.

Range: 0–1

Higher values indicate the instability boundary is poorly defined in the current region of the state space.

Low values indicate a stable boundary estimate.

trajectory_uncertainty

Normalized variance in the drift_gradient estimate across consecutive state snapshots.

Range: 0–1

Higher values indicate the direction of system motion is unstable or oscillating.

Low values indicate consistent directional drift.

regime_confidence

Confidence that the system is operating within the assumed trauma regime.

Low values indicate ambiguous system behavior or mixed failure signals.

Files

data/train.csv

Training rows include:

• intervention vectors • stabilizationsuccess • labeltrauma_deterioration

data/tester.csv

Tester rows exclude:

• stabilizationsuccess • labeltrauma_deterioration

However the following signals remain available during inference:

• boundaryuncertainty • trajectoryuncertainty • regime_confidence

These signals allow models to estimate prediction reliability.

Example v0.7 row

Example of a high-uncertainty stabilization scenario.

scenario_id: TRM7011 perfusion: 0.42 buffer: 0.37 lag: 0.71 coupling: 0.76

driftgradient: 0.52 driftvelocity: 0.47 drift_acceleration: 0.11

boundarydistance: 0.23 boundaryuncertainty: 0.46 trajectoryuncertainty: 0.41 regimeconfidence: 0.48

perturbationradius: 0.28 collapsetrigger: occult_bleeding

recoverydistance: 0.55 recoverygradient: -0.14 return_feasibility: 0.34

deltaperfusion: 0.17 deltabuffer: 0.15 deltalag: -0.08 deltacoupling: -0.07

trajectoryshift: -0.12 minimalintervention_path: transfusion+imaging

stabilizationsuccess: 1 labeltrauma_deterioration: 1

Interpretation:

The intervention succeeds.

However boundary and trajectory uncertainty are both high. The stabilization result therefore carries low confidence.

This illustrates why v0.7 evaluates trust in predictions, not just correctness.

Evaluation

Standard classification metrics:

• accuracy • precision • recall • f1

v0.7 also introduces uncertainty diagnostics.

• recallsuccessfulstabilization • failedrescuerate • highuncertaintyfalsepositiverate • boundarymisconfidencerate • trajectorymisconfidencerate

These metrics detect situations where a model produces confident predictions in uncertain conditions.

Dataset construction

This dataset is generated using the Clarus instability modeling framework.

The generation process follows three stages.

State sampling

System states are sampled across the quad space:

• perfusion • buffer • lag • coupling

Sampling includes both stable and near-boundary regions.

Trajectory estimation

Trajectory signals are computed for each state:

• driftgradient • driftvelocity • drift_acceleration

These values describe the motion of the system through the stability manifold.

Boundary estimation

Instability boundaries are estimated using perturbation sampling.

This produces:

• boundarydistance • boundaryuncertainty

Boundary uncertainty represents the variance of boundary estimates across perturbations.

Intervention simulation

Candidate intervention vectors modify system state:

• deltaperfusion • deltabuffer • deltalag • deltacoupling

Trajectory is recomputed after intervention to determine:

• trajectoryshift • stabilizationsuccess

Labels are assigned according to the v0.7 rule.

Dataset limitations

This dataset models instability geometry, not complete clinical records.

Important limitations:

• Quad variables represent abstract system states rather than full physiology • Intervention effects represent structural transitions rather than pharmacology • Uncertainty signals represent estimation uncertainty rather than device error

The dataset should therefore be interpreted as a system stability benchmark, not a direct clinical decision tool.

Intended use

Appropriate uses include:

• benchmarking instability detection models • studying intervention reasoning in dynamic systems • evaluating uncertainty calibration in safety-critical predictions • training models to recognize unstable stabilization scenarios

Not intended for:

• direct clinical deployment • real-time treatment recommendations • replacing medical judgment

Position in the Clarus dataset ladder

This dataset belongs to the Clarus instability modeling ladder.

The ladder reconstructs the geometry of system failure and recovery.

v0.1 cascade detection

v0.2 trajectory awareness

v0.3 cascade forecasting

v0.4 boundary discovery

v0.5 recovery geometry

v0.6 intervention reasoning

v0.7 uncertainty-aware intervention geometry

Relationship to other Clarus datasets

Clarus datasets apply the same instability geometry across domains.

These include:

• clinical systems • financial networks • infrastructure systems • AI coordination environments

Each domain models the same structural signals:

• system state • trajectory dynamics • boundary estimation • recovery pathways • intervention reasoning • uncertainty geometry

This enables transfer of structural reasoning across domains.

Research direction

Future Clarus datasets may extend the ladder through:

• regime transition modeling • multi-cascade coupling • adversarial perturbation environments • stability control policies

These developments move Clarus from a monitoring framework toward a general system stability instrument.

Structural note

Clarus v0.7 extends the intervention ladder.

The instrument now models:

• system state • trajectory • boundary • recovery • intervention • uncertainty

This transforms Clarus from a collapse detector into a calibrated system navigation instrument.

Production deployment

The dataset class is most useful where false confidence carries high operational risk, including:

• trauma monitoring • emergency triage • ICU escalation • hemorrhage control systems • unstable resuscitation environments

Enterprise and research collaboration

Potential applications include:

• clinical AI benchmarking • intervention pathway model evaluation • uncertainty calibration research • instability monitoring systems • safety evaluation for clinical decision support models

License

MIT