XeOxygenMixtureSafetyBlenderQC

Xe-O2 Mixture Safety Blender QC

medical_devices Hyperpolarized Xenon RPH Xe-129 medical gases CSV→JSON URS & FS rule-based
Открыть подборку

Описание утилиты: Xe-O2 Mixture Safety Blender QC

Xe-O2 Mixture Safety Blender QC — Контроль качества смесителя безопасности Xe/O2

ℹ️  Утилита проверяет точность медицинского газового смесителя:
    • Ошибка потоков O2 и Xe
    • Концентрация кислорода на выходе (безопасность)
    • Точность соотношения смешивания

⚠️  КРИТИЧНО: Смеситель — последнее звено защиты от гипоксии!
    Любая ошибка в дозировке O2 может стоить пациенту жизни.

Использование:
  XeOxygenMixtureSafetyBlenderQC.exe                            → демо-режим (вывод в консоль)
  XeOxygenMixtureSafetyBlenderQC.exe input.csv output.json      → оценка ваших данных

Формат input.csv:
BatchNumber,ProductName,Target_O2_Flow,Measured_O2_Flow,Target_Xe_Flow,Measured_Xe_Flow,Output_O2_Percent,Min_Safe_O2,Max_Flow_Error

Пример:
  BLEND-QC-2026-001,Blender v2,0.5,0.51,1.5,1.48,20.5,19.0,5.0

— ЗАЧЕМ ЭТО НУЖНО?
Контроль работы смесителя критичен для безопасности HP-MRI процедур:
• Смеситель объединяет чистый ксенон и медицинский кислород в безопасную пропорцию
• Отказ расходомеров (MFC) или клапанов может привести к подаче чистого ксенона (асфиксия)
• Точность смешивания влияет на предсказуемость уровня поляризации (T1)
• Регулярная верификация смесителя требуется протоколами GMP и FDA
• Утилита помогает выявить дрейф калибровки до того, как он станет опасным

⚠️  КРИТИЧЕСКИ ВАЖНО:
• Ошибка потока каждого газа ≤5%
• Концентрация кислорода на выходе строго ≥19% (или выше по протоколу)
• Соотношение смешивания должно соответствовать рецептуре с высокой точностью
• Автоматическая блокировка при обнаружении опасных отклонений

Ключевые особенности утилиты:
• Сравнение целевых и фактических потоков газов
• Абсолютный контроль безопасности выходной концентрации O2
• Расчет ошибки соотношения смешивания
• Поддержка различных моделей медицинских смесителей

Критические параметры:
• Flow Error: ≤5%
• Output O2: ≥19%
• Mixing Ratio Error: ≤5%

💡 Советы по использованию:
1. Проводите тестовые прогоны с азотом перед использованием дорогого ксенона
2. Используйте независимый газоанализатор для проверки выхода смесителя
3. Калибруйте расходомеры не реже одного раза в месяц
4. Следите за перепадами давления на входе, они влияют на точность MFC
5. Ведите журнал калибровок для аудита безопасности

⚠️ Особенность: В отличие от обычной дозирующей аппаратуры, здесь ошибка измеряется не в миллилитрах, а в риске для жизни. Утилита обеспечивает двойной контроль: инженерный (точность потоков) и клинический (безопасность дыхания).

input.csv

BatchNumber,ProductName,Target_O2_Flow,Measured_O2_Flow,Target_Xe_Flow,Measured_Xe_Flow,Output_O2_Percent,Min_Safe_O2,Max_Flow_Error
BLEND-QC-2026-001,Precision Blender v2.0,0.5,0.51,1.5,1.48,20.5,19.0,5.0
BLEND-QC-2026-002,Precision Blender v2.0 (Drift),0.5,0.45,1.5,1.55,18.0,19.0,5.0
BLEND-QC-2026-003,Precision Blender v2.0 (High Error),0.5,0.60,1.5,1.30,25.0,19.0,5.0

URS & FS — пользовательские требования и функциональная спецификация

URS & FS — спецификация пользователя и функциональная спецификация

Документ описывает контролируемый интерфейс и поведение утилиты XeOxygenMixtureSafetyBlenderQC для объекта «Xe-O2 Mixture Safety Blender QC». Пределы из исходного описания являются стартовой конфигурацией и до продуктивного применения должны быть сверены с утверждённой спецификацией, протоколом исследования, инструкцией к оборудованию и локальными SOP.

Предметные ограничения и критические параметры

  • Flow Error: ≤5%
  • Output O2: ≥19%
  • Mixing Ratio Error: ≤5%

URS — пользовательские требования

IDТребованиеКритичностьКритерий приёмки
URS-001Утилита должна принимать input.csv с точными заголовками из контракта данных.HighФайл обрабатывается без ручного переименования колонок.
URS-002Утилита должна выполнять детерминированную проверку для «Xe-O2 Mixture Safety Blender QC».HighДля каждой строки формируется PASS / WARNING / FAIL.
URS-003Обязательные поля, типы, диапазоны, единицы и согласованность данных должны проверяться до предметных правил.HighОшибки схемы отделены от несоответствий.
URS-004Критические пределы из описания и утверждённой локальной конфигурации должны приводить к critical finding.HighНарушение критического правила приводит к FAIL.
URS-005Результат должен формироваться в машинно-читаемом output.json.HighJSON содержит исходные значения, проверки, предупреждения и отказы.
URS-006Решение о соответствии не должно использовать машинное обучение.MediumРезультат воспроизводим по явным правилам и входным данным.
URS-007Должна сохраняться трассируемость серии, исходного файла, версии правил и итогового статуса.HighQA/QC может воспроизвести решение.
URS-008Утилита должна иметь ровно один основной портальный тег: medical_devices.MediumДругие теги api / instrumental / medical_devices отсутствуют.
URS-009Документация должна поддерживать IQ/OQ/PQ или эквивалентную CSA/CSV-проверку.MediumКонтракт, тестовые сценарии и change-control правила доступны вместе с утилитой.

Контракт input.csv

#ПолеТипЕдиницаПримерНазначение
1BatchNumberstringas specifiedBLEND-QC-2026-001Идентификатор серии/партии для трассируемости.
2ProductNamestringas specifiedPrecision Blender v2.0Наименование контролируемого продукта, газа, процедуры или оборудования.
3Target_O2_Flowdecimalas specified0.5Содержание или поток кислорода; параметр безопасности дыхательной смеси и/или сохранения поляризации.
4Measured_O2_Flowdecimalas specified0.51Содержание или поток кислорода; параметр безопасности дыхательной смеси и/или сохранения поляризации.
5Target_Xe_Flowdecimalas specified1.5Параметр ксенона: концентрация, изотопная доля, активность, объём или чистота в зависимости от поля.
6Measured_Xe_Flowdecimalas specified1.48Параметр ксенона: концентрация, изотопная доля, активность, объём или чистота в зависимости от поля.
7Output_O2_Percentdecimal%20.5Содержание или поток кислорода; параметр безопасности дыхательной смеси и/или сохранения поляризации.
8Min_Safe_O2decimalas specified19.0Содержание или поток кислорода; параметр безопасности дыхательной смеси и/или сохранения поляризации.
9Max_Flow_Errordecimalas specified5.0Расход газа или целевой поток для контроля смесителя/подачи.
BatchNumber,ProductName,Target_O2_Flow,Measured_O2_Flow,Target_Xe_Flow,Measured_Xe_Flow,Output_O2_Percent,Min_Safe_O2,Max_Flow_Error
BLEND-QC-2026-001,Precision Blender v2.0,0.5,0.51,1.5,1.48,20.5,19.0,5.0
BLEND-QC-2026-002,Precision Blender v2.0 (Drift),0.5,0.45,1.5,1.55,18.0,19.0,5.0
BLEND-QC-2026-003,Precision Blender v2.0 (High Error),0.5,0.60,1.5,1.30,25.0,19.0,5.0

FS — функциональная спецификация

IDФункцияРеализация
FS-001CLI executionXeOxygenMixtureSafetyBlenderQC.exe поддерживает demo mode и режим input.csv output.json.
FS-002CSV importЧтение UTF-8 CSV, проверка заголовка, количества и порядка колонок.
FS-003Schema validationПроверка обязательности, пустых значений, типов и базовой правдоподобности.
FS-004Domain rule engineПрименение явных правил для «Xe-O2 Mixture Safety Blender QC» и локально утверждённых пределов.
FS-005Status aggregationFAIL при critical finding; WARNING при некритическом отклонении; PASS при полном соответствии.
FS-006JSON exportЗапись исходных значений, применённых правил, статусов, warnings, failures и версии конфигурации.
FS-007Audit supportСохранение структуры результата для review, расследования, IQ/OQ и change control.
FS-008Integration contractLIMS/ELN/MES или приборный wrapper формирует CSV; утилита возвращает JSON.

Пример output.json

{
  "utilityId": "xe-oxygen-mixture-safety-blender-qc",
  "primaryTag": "medical_devices",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "BLEND-QC-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "ProductName",
      "value": "Precision Blender v2.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Target_O2_Flow",
      "value": "0.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Measured_O2_Flow",
      "value": "0.51",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Target_Xe_Flow",
      "value": "1.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Measured_Xe_Flow",
      "value": "1.48",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Output_O2_Percent",
      "value": "20.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Min_Safe_O2",
      "value": "19.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    }
  ],
  "warnings": [],
  "criticalFindings": []
}

OQ/PQ тестовые сценарии

IDСценарийОжидаемый результат
OQ-001Валидная строка из примераPASS или допустимый WARNING согласно локальным правилам.
OQ-002Отсутствует обязательная колонкаОшибка схемы; предметные проверки не маскируют ошибку.
OQ-003Нечисловое значение в числовом полеОшибка преобразования типа.
OQ-004Критический параметр за пределомFAIL и critical finding.
OQ-005Граничное значениеРезультат соответствует явно заданному оператору ≤ / ≥ / < / >.
PQ-001Реальные данные площадкиСогласованный QA/QC review с сохранением CSV, JSON, версии и контрольной суммы.

QA/QC и change control

  • Не менять имена колонок без обновления валидатора, документации и тестового набора.
  • Хранить input.csv, output.json, версию исполняемого файла, версию правил и контрольные суммы.
  • Перед продуктивным использованием выполнить локальную проверку пределов и IQ/OQ/PQ или эквивалентную CSA.
  • Изменения, влияющие на безопасность пациента, дозиметрию, газовую смесь, поляризацию или оборудование, требуют документированного impact assessment.

Входит в пакеты

Rph Hyperpolarized Xenon Lifecycle QC Suite

29 утилит для полного жизненного цикла гиперполяризованного ксенона: изотопный состав и чистота газа, SEOP и поляризация, T1/хранение/транспорт, безопасное смешивание и подача, MRI/SPECT QC, дозиметрия, scavenging, recovery и recycling.

Открыть

RPH isotope family: xenon and gas tracers

Xe-127, Xe-129 и Xe-133 для ventilation, hyperpolarized imaging, gas QC и safety.

Открыть

RPH organ/system: печень, желчные пути и ЖКТ

HIDA, mebrofenin, gallbladder, gastric emptying, GI transit, bleeding и liver/spleen imaging.

Открыть

RPH organ/system: лёгкие и вентиляция

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

Открыть

RPH use case: ксенон, вентиляция и медицинские газы

Xe-129, Xe-133, Xe-127, гиперполяризация, SEOP, T1, mixing, scavenging, transport, recovery и вентиляционная визуализация.

Открыть