Analyse oscillatory ventilation (beta)
analyze_eovAnalyses exercise oscillatory ventilation and the ventilatory control loop behind it in an uploaded recording. Beta: developed on one heart failure cohort, transportability untested. Needs end-tidal CO2; without it the analysis is refused with that reason.
Returns cpet_id and one envelope in results: status ("ok" or
"not_analysable"), findings, quality (good/acceptable/poor, of the INPUT,
not of the answer), confidence ("low" or "normal" with the reasons, never a
number), notes, provenance, and error/message when it could not run.
Counts one unit of the key's monthly allowance, a repeated call included.
Licensed separately (get_capabilities lists this key's analyses).
The findings answer three different questions:
GRADE and BURDEN: how MUCH oscillation there was.
MARGIN.LOOP_GAIN: how CLOSE the control loop is to oscillating on its own, 0 stable and 1 self-sustaining. Defined even when the grade is "none": a grade saturates and this does not.
LOOP: the factorisation, when an oscillation is clear enough to invert.
g = plant_gain x controller_gain.delay_scomes from the phase and is NOT a factor ofg.
And three limits:
margin.corroboratedfalse: end-tidal CO2 did not oppose ventilation at that period, so what resonates is not the chemoreflex loop. It is ventilatory variability, not instability.delay_sis the whole lag in the return path, not a circulation time. "Circulation" would be an interpretation, not a measurement.co2_amplitude_suspect: the end-tidal CO2 waveform was distorted (a clipped sample) while ventilation stayed clean. Plant gain is then a LOWER bound and controller gain an UPPER one.
An absent note does not mean an absent finding.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cpet_id": "<cpet_id>"
},
"name": "analyze_eov"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cpet_id | Yes | Handle from upload_cpet, create_upload or get_sample_cpet. |