RoomAirXeConcentrationMonitor
Room Air Xe Concentration Monitor
medical_devices Hyperpolarized Xenon RPH Xe-129 medical gases CSV→JSON URS & FS rule-based
Open selectionUtility description: Room Air Xe Concentration Monitor
Room Air Xe Concentration Monitor — Room Air Xenon Concentration Monitor
ℹ️ Utility controls environmental safety in laboratory/cabinet:
• Xenon concentration (ppm)
• Calculated oxygen level reduction
• Ventilation efficiency (ACH)
⚠️ CRITICAL: Xenon is heavier than air and accumulates at the bottom!
Sensors must be installed at floor level.
Usage:
RoomAirXeConcentrationMonitor.exe → demo mode (console output)
RoomAirXeConcentrationMonitor.exe input.csv output.json → evaluate your data
Input format:
BatchNumber,ProductName,Measured_Xe_ppm,Room_Volume_m3,Ventilation_ACH,Max_Allowed_Xe_ppm,O2_Risk_Threshold
Example:
ROOM-MON-2026-001,MRI Suite,200,50,8,5000,19.5
— WHY IS THIS NEEDED?
Room atmosphere control is critical for staff safety:
• Leaks from patient breathing circuit or recovery systems fill room with xenon
• Xenon is odorless and colorless, so its presence is unnoticed without sensors
• As an inert gas, it displaces oxygen, creating risk of silent hypoxia for staff
• Xenon is significantly heavier than air, so it accumulates in lower layers of room
• Regulators require air quality monitoring in medical gas usage zones
⚠️ CRITICAL:
• Xenon concentration ≤5000 ppm (0.5%) as warning limit
• Oxygen level must not drop below 19.5%
• Ventilation must provide minimum 6-8 air changes per hour (ACH)
• Sensors must be calibrated and placed in gas accumulation zones
Key features:
• Hypoxia risk calculation based on current gas concentration
• Supply-exhaust ventilation efficiency assessment
• Sanitary norms compliance check (SanPiN / OSHA)
• Gas dissipation time prediction during emergency ventilation
Critical parameters:
• Xe Concentration: ≤5000 ppm
• O2 Level: ≥19.5%
• Ventilation: ≥6 ACH
• Risk Score: <5
💡 Usage tips:
1. Install xenon sensors at height 10-20 cm from floor
2. Integrate monitor with emergency ventilation system (turbo-mode on threshold exceedance)
3. Regularly check recovery system connection tightness
4. Use portable gas analyzers to check "dead zones" in room
5. Maintain background concentration log to detect slow leaks
⚠️ Note: Unlike toxic gases where PEL (Permissible Exposure Limit) matters due to poison, here limit is dictated by physics of oxygen displacement. The utility helps prevent situations where staff loses consciousness without visible cause.input.csv
BatchNumber,ProductName,Measured_Xe_ppm,Room_Volume_m3,Ventilation_ACH,Max_Allowed_Xe_ppm,O2_Risk_Threshold ROOM-MON-2026-001,MRI Control Room,200,50,8,5000,19.5 ROOM-MON-2026-002,Scanner Room (Leak Detected),8000,40,4,5000,19.5 ROOM-MON-2026-003,Recovery Area,50,60,10,5000,19.5
URS & FS — user requirements and functional specification
URS & FS — User Requirements and Functional Specification
This document defines the controlled interface and behaviour of RoomAirXeConcentrationMonitor for “Room Air Xe Concentration Monitor”. 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
- Xe Concentration: ≤5000 ppm
- O2 Level: ≥19.5%
- Ventilation: ≥6 ACH
- Risk Score: <5
URS — User Requirements Specification
| ID | Requirement | Criticality | Acceptance criterion |
|---|---|---|---|
| URS-001 | The utility shall accept input.csv with the exact headers defined by the data contract. | High | The file is processed without manual header renaming. |
| URS-002 | The utility shall perform a deterministic assessment for “Room Air Xe Concentration Monitor”. | High | PASS / WARNING / FAIL is produced for each row. |
| URS-003 | Required fields, types, ranges, units and data consistency shall be validated before domain rules. | High | Schema errors are separated from nonconformities. |
| URS-004 | Critical limits from the description and approved local configuration shall create a critical finding. | High | A critical rule violation results in FAIL. |
| URS-005 | The result shall be written to machine-readable output.json. | High | JSON contains source values, checks, warnings and failures. |
| URS-006 | The conformity decision shall not use machine learning. | Medium | The result is reproducible from explicit rules and inputs. |
| URS-007 | Traceability of batch, source file, rule version and final status shall be retained. | High | QA/QC can reproduce the decision. |
| URS-008 | The utility shall have exactly one primary portal tag: medical_devices. | Medium | The other api / instrumental / medical_devices tags are absent. |
| URS-009 | Documentation shall support IQ/OQ/PQ or equivalent CSA/CSV verification. | Medium | The contract, test scenarios and change-control rules are supplied with the utility. |
input.csv data contract
| # | Field | Type | Unit | Sample | Purpose |
|---|---|---|---|---|---|
| 1 | BatchNumber | string | as specified | ROOM-MON-2026-001 | Batch/lot identifier for traceability. |
| 2 | ProductName | string | as specified | MRI Control Room | Name of the controlled product, gas, procedure or equipment. |
| 3 | Measured_Xe_ppm | decimal | ppm | 200 | Xenon parameter: concentration, isotope fraction, activity, volume or purity depending on the field. |
| 4 | Room_Volume_m3 | decimal | m³ | 50 | Room or workplace-monitoring parameter. |
| 5 | Ventilation_ACH | decimal | ACH | 8 | Controlled input.csv field: Ventilation ACH. |
| 6 | Max_Allowed_Xe_ppm | decimal | ppm | 5000 | Xenon parameter: concentration, isotope fraction, activity, volume or purity depending on the field. |
| 7 | O2_Risk_Threshold | decimal | as specified | 19.5 | Oxygen concentration or flow; a breathing-mixture safety and/or polarization-retention parameter. |
BatchNumber,ProductName,Measured_Xe_ppm,Room_Volume_m3,Ventilation_ACH,Max_Allowed_Xe_ppm,O2_Risk_Threshold ROOM-MON-2026-001,MRI Control Room,200,50,8,5000,19.5 ROOM-MON-2026-002,Scanner Room (Leak Detected),8000,40,4,5000,19.5 ROOM-MON-2026-003,Recovery Area,50,60,10,5000,19.5
FS — Functional Specification
| ID | Function | Implementation |
|---|---|---|
| FS-001 | CLI execution | RoomAirXeConcentrationMonitor.exe supports demo mode and input.csv output.json mode. |
| FS-002 | CSV import | Read UTF-8 CSV and validate header, column count and order. |
| FS-003 | Schema validation | Validate required values, empties, types and basic plausibility. |
| FS-004 | Domain rule engine | Apply explicit rules for “Room Air Xe Concentration Monitor” and locally approved limits. |
| FS-005 | Status aggregation | FAIL for a critical finding; WARNING for a non-critical deviation; PASS for conformity. |
| FS-006 | JSON export | Write source values, applied rules, statuses, warnings, failures and configuration version. |
| FS-007 | Audit support | Retain a result structure suitable for review, investigation, IQ/OQ and change control. |
| FS-008 | Integration contract | LIMS/ELN/MES or an instrument wrapper creates CSV; the utility returns JSON. |
output.json example
{
"utilityId": "room-air-xe-concentration-monitor",
"primaryTag": "medical_devices",
"overallStatus": "PASS|WARNING|FAIL",
"sourceFile": "input.csv",
"checks": [
{
"parameter": "BatchNumber",
"value": "ROOM-MON-2026-001",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "ProductName",
"value": "MRI Control Room",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Measured_Xe_ppm",
"value": "200",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Room_Volume_m3",
"value": "50",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Ventilation_ACH",
"value": "8",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Max_Allowed_Xe_ppm",
"value": "5000",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "O2_Risk_Threshold",
"value": "19.5",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
}
],
"warnings": [],
"criticalFindings": []
}
OQ/PQ test scenarios
| ID | Scenario | Expected result |
|---|---|---|
| OQ-001 | Valid example row | PASS or an allowed WARNING under local rules. |
| OQ-002 | Required column missing | Schema error; domain checks do not mask it. |
| OQ-003 | Non-numeric value in numeric field | Type-conversion error. |
| OQ-004 | Critical parameter outside its limit | FAIL and a critical finding. |
| OQ-005 | Boundary value | The result follows the configured ≤ / ≥ / < / > operator. |
| PQ-001 | Real site data | Agreed 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.
OpenRPH isotope family: xenon and gas tracers
Xe-127, Xe-129 and Xe-133 for ventilation, hyperpolarized imaging, gas QC and safety.
OpenRPH organ/system: pulmonary and ventilation
Lung perfusion, MAA, V/Q, aerosol, xenon ventilation, shunt and pulmonary dosimetry.
OpenRPH use case: xenon, ventilation and medical gases
Xe-129, Xe-133, Xe-127, hyperpolarization, SEOP, T1, mixing, scavenging, transport, recovery and ventilation imaging.
Open