RadionuclideImpurityChecker

Radionuclide Impurity Checker — Универсальная утилита для расчёта примесей-радионуклидов по данным гамма-спектрометрии

ℹ️  Утилита автоматически рассчитывает процент примеси радионуклида с коррекцией на период полураспада. Активность приводится к эталонному времени (времени калибровки/производства).
ℹ️  Поддерживает любые комбинации радионуклидов — достаточно указать периоды полураспада.
ℹ️  Не использует машинное обучение — только физические расчёты по формуле: A_ref = A_meas × exp(λ × t)

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

Формат input.csv:
BatchNumber,MainRadionuclide,MainActivityMeasMBq,ImpurityRadionuclide,ImpurityActivityMeasMBq,TimeDiffHours,MainHalfLifeHours,ImpurityHalfLifeHours

Пояснение полей:
• BatchNumber — номер серии препарата
• MainRadionuclide — основной радионуклид (например, "Lu-177")
• MainActivityMeasMBq — активность основного радионуклида при измерении (МБк)
• ImpurityRadionuclide — примесь-радионуклид (например, "Lu-177m")
• ImpurityActivityMeasMBq — активность примеси при измерении (МБк)
• TimeDiffHours — время от эталонного момента (калибровки) до измерения в часах (≥0)
• MainHalfLifeHours — период полураспада основного радионуклида (часы)
• ImpurityHalfLifeHours — период полураспада примеси (часы)

⚠️ КРИТИЧЕСКИ ВАЖНО:
• Входные активности ДОЛЖНЫ быть измерены в ОДИН И ТОТ ЖЕ момент времени!
• Время измерения ДОЛЖНО быть позже эталонного времени (TimeDiffHours ≥ 0)
• Активности должны быть получены из гамма-спектрометрии с корректной калибровкой детектора
• Периоды полураспада должны соответствовать справочным данным

— КАК ЭТО РАБОТАЕТ?
1. Утилита рассчитывает фактор распада для основного радионуклида:
   λ_main = ln(2) / T½_main
   Factor_main = exp(λ_main × TimeDiffHours)
   
2. Рассчитывает фактор распада для примеси аналогично
   
3. Приводит активности к эталонному времени:
   A_main_ref = A_main_meas × Factor_main
   A_imp_ref = A_imp_meas × Factor_imp
   
4. Рассчитывает процент примеси:
   Impurity % = (A_imp_ref / A_main_ref) × 100%
   
5. Сравнивает с фармакопейным пределом для данной комбинации радионуклидов
   (если комбинация неизвестна — используется предел 1.0% с пометкой "Default")

📌 Встроенные фармакопейные пределы:
• Lu-177 + Lu-177m: ≤0.1% (Ph. Eur. / EMA для Lutathera®)
• I-131 + I-132: ≤0.1% (USP <823>)
• Ra-223 + Ra-226: ≤0.001% (спецификация Xofigo®)
• Tc-99m + Mo-99: ≤0.015% (Ph. Eur. для генераторов)
• Sr-89 + Sr-85: ≤0.02% (Ph. Eur.)
• Ga-68 + Ge-68: ≤0.001% (Ph. Eur. для генераторов)

💡 Советы по использованию:
1. Получите активности основного радионуклида и примеси из гамма-спектрометра (уже скорректированные на эффективность детектора и вероятность излучения)
2. Определите время между калибровкой (эталонным временем) и измерением в часах
3. Используйте точные периоды полураспада из справочника (см. ниже)
4. Для неизвестных комбинаций утилита использует предел 1.0% — ВСЕГДА сверяйтесь со спецификацией вашего препарата!

📚 Справочник периодов полураспада (часы):
Lu-177: 160.08    | Lu-177m: 3840      | I-131: 192        | I-132: 2.3
Ra-223: 277.2     | Ra-226: 1295040    | Mo-99: 66         | Tc-99m: 6.01
Sr-89: 1295       | Sr-85: 15984       | Ga-68: 1.13       | Ge-68: 21360
F-18: 1.83        | Cu-64: 12.7        | Y-90: 64.1        | In-111: 67.3

⚠️ ВАЖНО:
• Примеси-радионуклиды увеличивают лучевую нагрузку на пациента БЕЗ терапевтического эффекта!
• Некоторые примеси имеют длительный период полураспада (например, Lu-177m: 160 дней) — даже 0.1% создаёт значительную хроническую нагрузку
• Для диагностических препаратов примеси снижают качество изображения и увеличивают дозу
• Утилита НЕ заменяет валидированный метод анализа, но позволяет быстро оценить результаты гамма-спектрометрии