ExhaledGasScavengingEfficiencyChecker

Exhaled Gas Scavenging Efficiency Checker

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

Utility description: Exhaled Gas Scavenging Efficiency Checker

Exhaled Gas Scavenging Efficiency Checker — Exhaled Gas Scavenging Efficiency Analyzer

ℹ️  Utility controls balance of administered and collected xenon:
    • Pure Xe-129 volume calculation
    • Collection efficiency (>90%)
    • Breathing circuit leak detection

⚠️  CRITICAL: Enriched xenon leak is direct financial loss!
    It can also lead to gas accumulation in the room.

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

Input format:
BatchNumber,ProductName,Administered_Volume_L,Captured_Exhaled_Volume_L,Administered_Xe_Conc_Percent,Captured_Xe_Conc_Percent,Min_Efficiency

Example:
  XE-SCAV-2026-001,HP-Xe-129,1.0,0.95,80.0,78.0,90.0

— WHY IS THIS NEEDED?
Scavenging efficiency control is critical for HP-MRI procedures:
• Patient exhales most of the administered hyperpolarized gas
• Scavenging systems must collect this gas for savings or safe disposal
• Low collection efficiency indicates mask leak, valve malfunction or tubing leak
• For enriched Xe-129, every lost liter costs a lot

⚠️  CRITICAL:
• Collection efficiency ≥90% — standard of good clinical practice
• Calculation based on pure xenon volume, not total mixture (accounting for O2/N2 dilution)
• Sharp drop in efficiency requires immediate procedure stop
• Xenon accumulation in room may be hazardous (risk of staff hypoxia in poor ventilation)

Key features:
• Correction for isotope concentration in inhaled and exhaled mixture
• Precise session mass-balance calculation
• Breathing circuit technical fault detection
• Support for various gas mixing protocols

Critical parameters:
• Scavenging Efficiency: ≥90%

💡 Usage tips:
1. Calibrate flow sensors before each research series
2. Check mask fit tightness to patient's face
3. Use fast-response gas analyzers for accurate concentration accounting
4. Maintain loss log for calculating economic efficiency of expensive isotope use
5. If low indicators observed, check one-way valves for sticking

⚠️ Note: Unlike standard drugs, gas can be "lost" into air. The utility helps turn invisible leak process into concrete numbers and percentages, allowing optimization of consumption of the most expensive MRI research components.

input.csv

BatchNumber,ProductName,Administered_Volume_L,Captured_Exhaled_Volume_L,Administered_Xe_Conc_Percent,Captured_Xe_Conc_Percent,Min_Efficiency
XE-SCAV-2026-001,HP-Xe-129 Session,1.0,0.95,80.0,78.0,90.0
XE-SCAV-2026-002,HP-Xe-129 Session,1.0,0.70,80.0,75.0,90.0
XE-SCAV-2026-003,HP-Xe-129 Session,0.5,0.48,90.0,89.0,90.0

URS & FS — user requirements and functional specification

URS & FS — User Requirements and Functional Specification

This document defines the controlled interface and behaviour of ExhaledGasScavengingEfficiencyChecker for “Exhaled Gas Scavenging Efficiency 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

  • Scavenging Efficiency: ≥90%

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 “Exhaled Gas Scavenging Efficiency 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-SCAV-2026-001Batch/lot identifier for traceability.
2ProductNamestringas specifiedHP-Xe-129 SessionName of the controlled product, gas, procedure or equipment.
3Administered_Volume_LdecimalL1.0Controlled input.csv field: Administered Volume L.
4Captured_Exhaled_Volume_LdecimalL0.95Controlled input.csv field: Captured Exhaled Volume L.
5Administered_Xe_Conc_Percentdecimal%80.0Xenon parameter: concentration, isotope fraction, activity, volume or purity depending on the field.
6Captured_Xe_Conc_Percentdecimal%78.0Xenon parameter: concentration, isotope fraction, activity, volume or purity depending on the field.
7Min_Efficiencydecimalas specified90.0Controlled input.csv field: Min Efficiency.
BatchNumber,ProductName,Administered_Volume_L,Captured_Exhaled_Volume_L,Administered_Xe_Conc_Percent,Captured_Xe_Conc_Percent,Min_Efficiency
XE-SCAV-2026-001,HP-Xe-129 Session,1.0,0.95,80.0,78.0,90.0
XE-SCAV-2026-002,HP-Xe-129 Session,1.0,0.70,80.0,75.0,90.0
XE-SCAV-2026-003,HP-Xe-129 Session,0.5,0.48,90.0,89.0,90.0

FS — Functional Specification

IDFunctionImplementation
FS-001CLI executionExhaledGasScavengingEfficiencyChecker.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 “Exhaled Gas Scavenging Efficiency 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": "exhaled-gas-scavenging-efficiency-checker",
  "primaryTag": "medical_devices",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "XE-SCAV-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "ProductName",
      "value": "HP-Xe-129 Session",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Administered_Volume_L",
      "value": "1.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Captured_Exhaled_Volume_L",
      "value": "0.95",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Administered_Xe_Conc_Percent",
      "value": "80.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Captured_Xe_Conc_Percent",
      "value": "78.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Min_Efficiency",
      "value": "90.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