VentilationPerfusionMismatchAnalyzer

Ventilation/Perfusion Mismatch Analyzer — V/Q — анализ вентиляционно-перфузионного несоответствия

Ventilation/Perfusion Mismatch Analyzer — V/Q — анализ вентиляционно-перфузионного несоответствия

ℹ️  Утилита выполняет:
    • Расчёт числа сегментарных эквивалентов mismatch, доли перфузионного дефекта и согласованности вентиляционных/перфузионных областей.
    • Проверку структуры input.csv и числовых значений
    • Формирование LabWare-совместимого output.json
    • Детерминированный итог PASS / FAIL / ERROR

⚠️  КРИТИЧНО: Любое несоответствие должно быть проверено квалифицированным специалистом до использования результата в рабочем процессе.

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

Формат input.csv:
BatchNumber,PerfusionDefectSegmentEquivalents,MatchedDefectSegmentEquivalents,TotalEvaluableSegments,PerfusionDefectExtentPercent,VentilationPerfusionAlignmentScore,MinAlignmentScore

Пример:
  VQ-MM-001,1,0.5,18,8,95,75

— ЗАЧЕМ ЭТО НУЖНО?
Расчёт числа сегментарных эквивалентов mismatch, доли перфузионного дефекта и согласованности вентиляционных/перфузионных областей.
Утилита входит в пакет «RPH: вентиляционно-перфузионные исследования лёгких» и может применяться как самостоятельная проверка или как элемент более широкого workflow ядерной медицины.

⚠️  КРИТИЧЕСКИ ВАЖНО:
• EvaluableSegments: >=12
• MismatchSegments: reportable >=0
• AlignmentScore: >= protocol minimum
• DefectExtent: <=50 for this QC profile

Ключевые особенности утилиты:
• Один исполняемый файл .NET 6 и один Program.cs
• Полный пример input.csv с проходной, пограничной и отрицательной строками
• LabWare-совместимый JSON: Header, Samples, Results, Status, StatusCode, ErrorMessage, Description и DescriptionEN
• CultureInfo.InvariantCulture для числовых значений
• Явные результаты по каждому параметру и пустой ErrorMessage для PASS

Критические параметры:
• EvaluableSegments: >=12
• MismatchSegments: reportable >=0
• AlignmentScore: >= protocol minimum
• DefectExtent: <=50 for this QC profile

💡 Советы по использованию:
1. Перед рабочим применением сверьте пределы с утверждённой спецификацией, инструкцией препарата, локальным SOP и конфигурацией оборудования.
2. Храните исходный input.csv вместе с output.json и версией исполняемого файла.
3. Для клинических расчётов используйте только проверенные исходные данные и утверждённый профиль протокола.
4. FAIL означает необходимость review, а не автоматическое медицинское решение.
5. Изменение лимитов должно проходить change control и повторную верификацию.

⚠️ Особенность: Утилита реализует детерминированный CSV → LabWare-compatible JSON workflow и не заменяет утверждённую методику, спецификацию, SOP или медицинское заключение.

Референсные пределы в этой версии являются консервативным стартовым профилем проекта FUZKK. Они должны быть подтверждены владельцем процесса до OQ/PQ и производственного применения.