RadiolysisStabilityChecker

Radiolysis Stability Checker

radiopharmaceuticals QC URS & FS input.csv output.json alpha therapy radiochemical purity radionuclidic purity
Открыть подборку

Описание утилиты: Radiolysis Stability Checker

Radiolysis Stability Checker — Оценка стабильности РФП

ℹ️  Прогнозирует снижение РХЧ из-за авторадиолиза на основе активности, объема и времени.
ℹ️  Учитывает наличие радиопротекторов (аскорбат, этанол).

Использование:
  RadiolysisStabilityChecker.exe                            → демо-режим
  RadiolysisStabilityChecker.exe input.csv output.json      → расчет

Формат input.csv:
BatchNumber,Radiopharmaceutical,Initial_Activity_MBq,Volume_mL,Initial_RCP_Percent,Has_Radioprotector,Radioprotector_Type,Radioprotector_Concentration_mM,EOS_Time_ISO,Check_Time_ISO,Radionuclide

Пример:
LU177-STAB-001,Lu-177-DOTATATE,7400.0,5.0,99.5,true,Ascorbic,10.0,2026-05-20T08:00:00,2026-05-20T16:00:00,Lu-177

— ЗАЧЕМ ЭТО НУЖНО?
При высокой удельной активности радиофармпрепараты подвержены радиолизу — саморазрушению под действием собственного излучения.
• Прогнозирование: Утилита оценивает, насколько упадет радиохимическая чистота (РХЧ) к моменту инъекции или конца срока годности.
• Факторы риска: Высокая концентрация активности (МБк/мл), отсутствие радиопротекторов, длительное время хранения.
• Альфа-излучатели (Ac-225): Обладают высокой ЛПЭ (линейной передачей энергии), вызывая быстрый радиолиз даже при низких активностях.
• Радиопротекторы: Аскорбиновая кислота, гентизиновая кислота или этанол значительно замедляют деградацию.

⚠️ ВАЖНО:
• Модель является упрощенной. Реальная кинетика радиолиза сложна и зависит от многих факторов (pH, примеси, материал флакона).
• Используйте этот инструмент для предварительной оценки и планирования логистики.
• Всегда подтверждайте РХЧ экспериментально (ТСХ/ВЭЖХ) перед введением пациенту.

input.csv

BatchNumber,Radiopharmaceutical,Initial_Activity_MBq,Volume_mL,Initial_RCP_Percent,Has_Radioprotector,Radioprotector_Type,Radioprotector_Concentration_mM,EOS_Time_ISO,Check_Time_ISO,Radionuclide
LU177-STAB-001,Lu-177-DOTATATE,7400.0,5.0,99.5,true,Ascorbic,10.0,2026-05-20T08:00:00,2026-05-20T16:00:00,Lu-177
AC225-STAB-001,Ac-225-PSMA,10.0,1.0,98.0,false,None,0.0,2026-05-20T08:00:00,2026-05-20T12:00:00,Ac-225

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

1. Область применения

Документ описывает требования и функциональное поведение утилиты RadiolysisStabilityChecker для контроля: Radiolysis Stability Checker. Утилита предназначена для ОКК/QC и использует детерминированные правила, а не машинное обучение.

2. Режимы запуска

  • RadiolysisStabilityChecker.exe — демонстрационный режим или справка.
  • RadiolysisStabilityChecker.exe input.csv output.json — обработка пользовательских данных и запись результата.

3. Ключевые предметные ограничения

  • BatchNumber,Radiopharmaceutical,Initial_Activity_MBq,Volume_mL,Initial_RCP_Percent,Has_Radioprotector,Radioprotector_Type,Radioprotector_Concentration_mM,EOS_Time_ISO,Check_Time_ISO,Radionuclide
  • • Прогнозирование: Утилита оценивает, насколько упадет радиохимическая чистота (РХЧ) к моменту инъекции или конца срока годности.
  • ⚠️ ВАЖНО:
  • • Модель является упрощенной. Реальная кинетика радиолиза сложна и зависит от многих факторов (pH, примеси, материал флакона).

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

IDТребованиеКритичностьКритерий приемки
URS-001Утилита должна принимать input.csv с точными заголовками, указанными в контракте данных.HighФайл обрабатывается без ручного изменения заголовков.
URS-002Утилита должна проверять обязательность, типы данных, диапазоны, единицы и критические фармацевтические/радиохимические пределы.HighДля каждой строки формируется статус PASS/WARNING/FAIL.
URS-003Утилита должна выявлять критические отклонения, связанные с радионуклидной/радиохимической чистотой, примесями, свободным радионуклидом, pH, эндотоксинами и стерильностью, если такие поля присутствуют.HighКритическое отклонение приводит к FAIL или явному critical finding.
URS-004Утилита должна формировать output.json с машинно-читаемыми результатами, исходными значениями, предупреждениями и отказами.HighJSON пригоден для LIMS/ELN/MES-интеграции и QA/QC review.
URS-005Утилита не должна использовать машинное обучение для решения о соответствии.MediumРешение основано на заданных правилах и порогах.
URS-006Утилита должна сохранять трассируемость между номером серии, входными значениями, примененными правилами и итоговым статусом.HighВыход содержит идентификатор серии и перечень проверенных параметров.
URS-007Документация должна поддерживать подготовку IQ/OQ и инспекционное обсуждение FDA/EMA/Росздравнадзора или локального регулятора.MediumURS/FS и тестовые сценарии доступны вместе с утилитой.

5. Контракт input.csv

#ПолеТипПримерНазначение
1BatchNumberstringLU177-STAB-001Идентификатор серии/партии.
2RadiopharmaceuticalstringLu-177-DOTATATEТип продукта/радиофармпрепарата; влияет на интерпретацию контроля.
3Initial_Activity_MBqdecimal7400.0Активность радиофармацевтического материала или готового продукта.
4Volume_mLdecimal5.0Контролируемый входной параметр из input.csv.
5Initial_RCP_Percentdecimal99.5Контролируемый входной параметр из input.csv.
6Has_RadioprotectordecimaltrueКонтролируемый входной параметр из input.csv.
7Radioprotector_TypestringAscorbicКонтролируемый входной параметр из input.csv.
8Radioprotector_Concentration_mMdecimal10.0Контролируемый входной параметр из input.csv.
9EOS_Time_ISOdecimal2026-05-20T08:00:00Контролируемый входной параметр из input.csv.
10Check_Time_ISOdecimal2026-05-20T16:00:00Контролируемый входной параметр из input.csv.
11RadionuclidedecimalLu-177Контролируемый входной параметр из input.csv.
BatchNumber,Radiopharmaceutical,Initial_Activity_MBq,Volume_mL,Initial_RCP_Percent,Has_Radioprotector,Radioprotector_Type,Radioprotector_Concentration_mM,EOS_Time_ISO,Check_Time_ISO,Radionuclide
LU177-STAB-001,Lu-177-DOTATATE,7400.0,5.0,99.5,true,Ascorbic,10.0,2026-05-20T08:00:00,2026-05-20T16:00:00,Lu-177
AC225-STAB-001,Ac-225-PSMA,10.0,1.0,98.0,false,None,0.0,2026-05-20T08:00:00,2026-05-20T12:00:00,Ac-225

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

IDФункцияРеализация
FS-001CSV importПрочитать input.csv в UTF-8/CSV-совместимом формате, проверить наличие заголовка и ожидаемых колонок.
FS-002Schema validationПроверить обязательные поля и количество колонок; сообщить о неизвестных или отсутствующих ключевых полях.
FS-003Type conversionПреобразовать числовые, флаговые и текстовые значения; некорректный формат фиксировать как ошибку строки.
FS-004Rule engineПрименить предметные правила для Radiolysis Stability Checker, включая критические пределы из описания утилиты.
FS-005Status aggregationСформировать итоговый статус: FAIL при критическом отказе, WARNING при некритическом отклонении, PASS при соответствии.
FS-006JSON exportЗаписать output.json с детализацией проверок, исходными значениями, предупреждениями и critical findings.
FS-007Audit supportСохранять структуру результата пригодной для review, расследования отклонений и подготовки IQ/OQ.

7. Пример output.json

{
  "utilityId": "radiolysis-stability-checker",
  "api": "Radiolysis Stability Checker",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "LU177-STAB-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Radiopharmaceutical",
      "value": "Lu-177-DOTATATE",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Initial_Activity_MBq",
      "value": "7400.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Volume_mL",
      "value": "5.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Initial_RCP_Percent",
      "value": "99.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Has_Radioprotector",
      "value": "true",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Radioprotector_Type",
      "value": "Ascorbic",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Radioprotector_Concentration_mM",
      "value": "10.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    }
  ],
  "criticalFindings": []
}

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

IDСценарийОжидаемый результат
OQ-001Валидная строка из примераPASS или допустимый WARNING согласно правилам.
OQ-002Отсутствует обязательная колонкаОшибка схемы или FAIL.
OQ-003Нечисловое значение в числовом полеОшибка преобразования типа.
OQ-004Значение критического параметра за пределомFAIL и critical finding.
PQ-001Реальная серия/партия пользователяСогласованный результат review с сохранением input.csv и output.json.

9. QA/QC и change control

  • Не менять имена колонок без обновления валидатора.
  • Хранить input.csv, output.json, версию исполняемого файла и контрольную сумму.
  • Перед продуктивным использованием провести IQ/OQ/PQ или эквивалентную CSV/CSA-проверку.
  • Критические радиофармацевтические пределы должны быть сверены с утверждённой спецификацией и локальными SOP.

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

PetRad2: расширенный радиофармацевтический QC-пакет

Подборка новых утилит для контроля радионуклидов, таргетной альфа-терапии, удельной активности, радиолиза и предварительных дозиметрических расчётов.

Открыть

Радиология

Пакет для радиологии и диагностической визуализации: радиофармпрепараты, PET/SPECT, контрастные вещества, йодсодержащие и гадолиниевые препараты, а также проверки частиц, стерильности и эндотоксинов.

Открыть

RPH: объединённый радиофармацевтический QC-пакет

RPH объединяет PetRad, PetRad2 и PetRad3 в один обзорный пакет для PET/SPECT, терапевтических радионуклидов, генераторов, меченых соединений, расчётов распада, стерильности, эндотоксинов и радиохимической/радионуклидной чистоты.

Открыть