PatientHypoxiaRiskDuringXeBreathingChecker

Patient Hypoxia Risk During Xe Breathing Checker

medical_devices Hyperpolarized Xenon RPH Xe-129 medical gases CSV→JSON URS & FS rule-based
Open selection

Utility description: Patient Hypoxia Risk During Xe Breathing Checker

Patient Hypoxia Risk During Xe Breathing Checker — Patient Hypoxia Risk Analyzer during Xenon Inhalation

ℹ️  Utility evaluates patient safety during xenon inhalation:
    • Minimum SpO2 level
    • Inspired oxygen concentration (FiO2)
    • Desaturation depth
    • Recovery time

⚠️  CRITICAL: Xenon displaces oxygen from alveoli!
    Even short-term hypoxia can be dangerous for COPD patients.

Usage:
  PatientHypoxiaRiskDuringXeBreathingChecker.exe                            → demo mode (console output)
  PatientHypoxiaRiskDuringXeBreathingChecker.exe input.csv output.json      → evaluate your data

Input format:
BatchNumber,ProductName,Inspired_O2_Percent,Xe_Conc_Percent,Baseline_SpO2,Hemoglobin,Min_Monitored_SpO2,Avg_Monitored_SpO2,Duration_Sec,Critical_Threshold,Warning_Threshold

Example:
  XE-HYPOXIA-2026-001,HP-Xe-129,21.0,79.0,98.0,14.5,92.0,95.0,15,90.0,94.0

— WHY IS THIS NEEDED?
Hypoxia control is critical for HP-MRI procedure safety:
• Inhaling pure xenon gas mixture (without added O2) causes sharp drop in oxygen partial pressure
• This leads to rapid decrease in saturation (SpO2)
• For patients with lung pathologies (COPD, fibrosis), even short hypoxia can be fatal
• Utility helps assess risk before procedure and monitor it during inhalation

⚠️  CRITICAL:
• SpO2 must not drop below 90% (critical threshold)
• Using oxygen-enriched mixture (e.g., 30% O2 / 70% Xe) is significantly safer
• Desaturation depth should not exceed 5% from baseline
• Saturation recovery time must be minimal (<60 sec)

Key features:
• Risk assessment based on patient physiological parameters
• Inspired mixture composition control
• Hypoxic episode depth and duration calculation
• Recovery time prediction

Critical parameters:
• Min SpO2: ≥90%
• FiO2: ≥21%
• Desaturation Depth: ≤5%
• Recovery Time: <60 sec

💡 Usage tips:
1. Always measure baseline SpO2 before procedure
2. Use pulse oximeter with fast response time
3. For patients with low baseline saturation, necessarily use oxygen-enriched mixture
4. Limit breath-hold time to 15-20 seconds
5. Have 100% oxygen mask ready for emergency desaturation

⚠️ Note: Unlike standard MRI where patient breathes air, here they inhale inert gas which physically prevents body from receiving oxygen at that moment. The utility turns this physiological fact into a manageable safety parameter.

input.csv

BatchNumber,ProductName,Inspired_O2_Percent,Xe_Conc_Percent,Baseline_SpO2,Hemoglobin,Min_Monitored_SpO2,Avg_Monitored_SpO2,Duration_Sec,Critical_Threshold,Warning_Threshold
XE-HYPOXIA-2026-001,HP-Xe-129 Inhalation (21% O2),21.0,79.0,98.0,14.5,92.0,95.0,15,90.0,94.0
XE-HYPOXIA-2026-002,HP-Xe-129 Inhalation (30% O2),30.0,70.0,97.0,14.0,96.0,97.0,15,90.0,94.0
XE-HYPOXIA-2026-003,HP-Xe-129 (High Risk),21.0,79.0,94.0,12.0,88.0,91.0,20,90.0,94.0

URS & FS — user requirements and functional specification

URS & FS — User Requirements and Functional Specification

This document defines the controlled interface and behaviour of PatientHypoxiaRiskDuringXeBreathingChecker for “Patient Hypoxia Risk During Xe Breathing Checker”. Limits from the source description are an initial configuration and shall be reconciled with the approved specification, study protocol, equipment instructions and local SOPs before production use.

Domain constraints and critical parameters

  • Min SpO2: ≥90%
  • FiO2: ≥21%
  • Desaturation Depth: ≤5%
  • Recovery Time: <60 sec

URS — User Requirements Specification

IDRequirementCriticalityAcceptance criterion
URS-001The utility shall accept input.csv with the exact headers defined by the data contract.HighThe file is processed without manual header renaming.
URS-002The utility shall perform a deterministic assessment for “Patient Hypoxia Risk During Xe Breathing Checker”.HighPASS / WARNING / FAIL is produced for each row.
URS-003Required fields, types, ranges, units and data consistency shall be validated before domain rules.HighSchema errors are separated from nonconformities.
URS-004Critical limits from the description and approved local configuration shall create a critical finding.HighA critical rule violation results in FAIL.
URS-005The result shall be written to machine-readable output.json.HighJSON contains source values, checks, warnings and failures.
URS-006The conformity decision shall not use machine learning.MediumThe result is reproducible from explicit rules and inputs.
URS-007Traceability of batch, source file, rule version and final status shall be retained.HighQA/QC can reproduce the decision.
URS-008The utility shall have exactly one primary portal tag: medical_devices.MediumThe other api / instrumental / medical_devices tags are absent.
URS-009Documentation shall support IQ/OQ/PQ or equivalent CSA/CSV verification.MediumThe contract, test scenarios and change-control rules are supplied with the utility.

input.csv data contract

#FieldTypeUnitSamplePurpose
1BatchNumberstringas specifiedXE-HYPOXIA-2026-001Batch/lot identifier for traceability.
2ProductNamestringas specifiedHP-Xe-129 Inhalation (21% O2)Name of the controlled product, gas, procedure or equipment.
3Inspired_O2_Percentdecimal%21.0Oxygen concentration or flow; a breathing-mixture safety and/or polarization-retention parameter.
4Xe_Conc_Percentdecimal%79.0Xenon parameter: concentration, isotope fraction, activity, volume or purity depending on the field.
5Baseline_SpO2decimalas specified98.0Oxygen concentration or flow; a breathing-mixture safety and/or polarization-retention parameter.
6Hemoglobindecimalas specified14.5Controlled input.csv field: Hemoglobin.
7Min_Monitored_SpO2decimalas specified92.0Oxygen concentration or flow; a breathing-mixture safety and/or polarization-retention parameter.
8Avg_Monitored_SpO2decimalas specified95.0Oxygen concentration or flow; a breathing-mixture safety and/or polarization-retention parameter.
9Duration_Secdecimals15Controlled input.csv field: Duration Sec.
10Critical_Thresholddecimalas specified90.0Controlled input.csv field: Critical Threshold.
11Warning_Thresholddecimalas specified94.0Controlled input.csv field: Warning Threshold.
BatchNumber,ProductName,Inspired_O2_Percent,Xe_Conc_Percent,Baseline_SpO2,Hemoglobin,Min_Monitored_SpO2,Avg_Monitored_SpO2,Duration_Sec,Critical_Threshold,Warning_Threshold
XE-HYPOXIA-2026-001,HP-Xe-129 Inhalation (21% O2),21.0,79.0,98.0,14.5,92.0,95.0,15,90.0,94.0
XE-HYPOXIA-2026-002,HP-Xe-129 Inhalation (30% O2),30.0,70.0,97.0,14.0,96.0,97.0,15,90.0,94.0
XE-HYPOXIA-2026-003,HP-Xe-129 (High Risk),21.0,79.0,94.0,12.0,88.0,91.0,20,90.0,94.0

FS — Functional Specification

IDFunctionImplementation
FS-001CLI executionPatientHypoxiaRiskDuringXeBreathingChecker.exe supports demo mode and input.csv output.json mode.
FS-002CSV importRead UTF-8 CSV and validate header, column count and order.
FS-003Schema validationValidate required values, empties, types and basic plausibility.
FS-004Domain rule engineApply explicit rules for “Patient Hypoxia Risk During Xe Breathing Checker” and locally approved limits.
FS-005Status aggregationFAIL for a critical finding; WARNING for a non-critical deviation; PASS for conformity.
FS-006JSON exportWrite source values, applied rules, statuses, warnings, failures and configuration version.
FS-007Audit supportRetain a result structure suitable for review, investigation, IQ/OQ and change control.
FS-008Integration contractLIMS/ELN/MES or an instrument wrapper creates CSV; the utility returns JSON.

output.json example

{
  "utilityId": "patient-hypoxia-risk-during-xe-breathing-checker",
  "primaryTag": "medical_devices",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "XE-HYPOXIA-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "ProductName",
      "value": "HP-Xe-129 Inhalation (21% O2)",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Inspired_O2_Percent",
      "value": "21.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Xe_Conc_Percent",
      "value": "79.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Baseline_SpO2",
      "value": "98.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Hemoglobin",
      "value": "14.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Min_Monitored_SpO2",
      "value": "92.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Avg_Monitored_SpO2",
      "value": "95.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    }
  ],
  "warnings": [],
  "criticalFindings": []
}

OQ/PQ test scenarios

IDScenarioExpected result
OQ-001Valid example rowPASS or an allowed WARNING under local rules.
OQ-002Required column missingSchema error; domain checks do not mask it.
OQ-003Non-numeric value in numeric fieldType-conversion error.
OQ-004Critical parameter outside its limitFAIL and a critical finding.
OQ-005Boundary valueThe result follows the configured ≤ / ≥ / < / > operator.
PQ-001Real site dataAgreed QA/QC review retaining CSV, JSON, version and checksum.

QA/QC and change control

  • Do not change column names without updating the validator, documentation and test set.
  • Retain input.csv, output.json, executable version, rule version and checksums.
  • Before production use, verify local limits and execute IQ/OQ/PQ or equivalent CSA.
  • Changes affecting patient safety, dosimetry, gas composition, polarization or equipment require documented impact assessment.

Included in packages

Rph Hyperpolarized Xenon Lifecycle QC Suite

29 utilities for the hyperpolarized xenon lifecycle: isotope composition and gas purity, SEOP and polarization, T1/storage/transport, safe blending and delivery, MRI/SPECT QC, dosimetry, scavenging, recovery and recycling.

Open

RPH isotope family: xenon and gas tracers

Xe-127, Xe-129 and Xe-133 for ventilation, hyperpolarized imaging, gas QC and safety.

Open

RPH organ/system: pulmonary and ventilation

Lung perfusion, MAA, V/Q, aerosol, xenon ventilation, shunt and pulmonary dosimetry.

Open

RPH use case: xenon, ventilation and medical gases

Xe-129, Xe-133, Xe-127, hyperpolarization, SEOP, T1, mixing, scavenging, transport, recovery and ventilation imaging.

Open