Tc99mMAALungShuntFractionCalculator

Tc-99m MAA Lung Shunt Fraction Calculator — Tc-99m MAA — расчёт фракции лёгочного шунта

Tc-99m MAA Lung Shunt Fraction Calculator — Tc-99m MAA — расчёт фракции лёгочного шунта

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

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

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

Формат input.csv:
BatchNumber,LungCounts,LiverCounts,LungBackgroundCounts,LiverBackgroundCounts,MaxAllowedLungShuntPercent

Пример:
  MAA-LSF-001,120000,1000000,10000,20000,20

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

⚠️  КРИТИЧЕСКИ ВАЖНО:
• CorrectedLungCounts: >0
• CorrectedLiverCounts: >0
• LungShuntFraction: <= protocol maximum

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

Критические параметры:
• CorrectedLungCounts: >0
• CorrectedLiverCounts: >0
• LungShuntFraction: <= protocol maximum

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

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

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