Tc99mMAG3LabelingEfficiencyAnalyzer

Tc-99m MAG3 Labeling Efficiency Analyzer

api RPH Tc-99m renal imaging nuclear medicine CSV→JSON URS & FS rule-based
Открыть подборку

Описание утилиты: Анализатор эффективности мечения MAG3 технецием-99m

Tc-99m MAG3 Labeling Efficiency Analyzer — Анализатор эффективности мечения MAG3 технецием-99m

ℹ️  Утилита контролирует качество препарата для нефросцинтиграфии:
    • Радиоchemical чистота (>90%)
    • Свободный пертехнетат (<5%)
    • Гидролизованный/коллоидный Tc (<5%)
    • pH среды

⚠️  КРИТИЧНО: Примеси меняют биораспределение!
    Свободный Tc идет в щитовидку, коллоиды — в печень.

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

Формат input.csv:
BatchNumber,ProductName,Complex_Percent,Free_Tc_Percent,Hydrolyzed_Percent,pH,Incubation_Min,Activity_MBq,Min_RCP,Max_Free,Max_Hydro

Пример:
  MAG3-2026-001,Tc-99m MAG3,96.5,2.0,1.5,7.4,10,740,90,5,5

— ЗАЧЕМ ЭТО НУЖНО?
Контроль качества Tc-99m MAG3 критичен для диагностики функции почек:
• MAG3 выводится канальцами почек, обеспечивая высокое отношение сигнал/фон
• Свободный $^{99m}TcO_4^-$ накапливается в щитовидной железе, слюнных железах и желудке, создавая фон
• Гидролизованный восстановленный технеций (коллоиды) захватывается ретикулоэндотелиальной системой печени и селезенки
• Это может имитировать патологию или скрыть реальные дефекты накопления в почках
• USP и Ph.Eur. требуют RCP не менее 90-95%

⚠️  КРИТИЧЕСКИ ВАЖНО:
• Радиоchemical чистота ≥90% (предпочтительно ≥95%)
• Свободный пертехнетат ≤5%
• Коллоидные примеси ≤5%
• pH должен быть нейтральным или слабощелочным для стабильности комплекса

Ключевые особенности утилиты:
• Раздельный контроль двух основных типов примесей (свободный и гидролизованный)
• Проверка pH как фактора стабильности
• Соответствие стандартам USP <823> и Ph.Eur.
• Поддержка данных ИТЛХ (ITLC) и ВЭЖХ

Критические параметры:
• RCP: ≥90%
• Free Tc: ≤5%
• Hydrolyzed Tc: ≤5%

💡 Советы по использованию:
1. Используйте две разные хроматографические системы для разделения всех трех форм (например, ацетон и физиологический раствор)
2. Контролируйте время инкубации (обычно 10-15 минут при комнатной температуре)
3. Избегайте попадания пузырьков воздуха в набор (окисление $Sn^{2+}$)
4. Проверяйте активность генератора $^{99}Mo/^{99m}Tc$ на прорыв молибдена
5. Используйте препарат в течение 6-8 часов после элюирования

⚠️ Особенность: MAG3 более устойчив к трансхелатированию, чем DTPA, но более чувствителен к условиям восстановления, чем DMSA. Утилита помогает найти баланс между эффективностью мечения и стабильностью препарата.

input.csv

BatchNumber,ProductName,Complex_Percent,Free_Tc_Percent,Hydrolyzed_Percent,pH,Incubation_Min,Activity_MBq,Min_RCP,Max_Free,Max_Hydro
MAG3-2026-001,Tc-99m MAG3 Standard,96.5,2.0,1.5,7.4,10,740,90,5,5
MAG3-2026-002,Tc-99m MAG3 (High Free),85.0,12.0,3.0,7.4,10,740,90,5,5
MAG3-2026-003,Tc-99m MAG3 (Colloids),92.0,1.0,7.0,6.0,10,740,90,5,5

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

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

  • Утилита должна принимать input.csv с заголовками, указанными в контракте данных.
  • До расчёта утилита должна выявлять отсутствующие поля, ошибки типов и некорректные значения.
  • Утилита должна детерминированно выполнять функцию «Анализатор эффективности мечения MAG3 технецием-99m».
  • Проверки должны учитывать следующие критерии: RCP: ≥90%; Free Tc: ≤5%; Hydrolyzed Tc: ≤5%.
  • Для обработанной записи должен формироваться понятный статус PASS, WARNING или FAIL с причиной.
  • Результат должен записываться в output.json и сохранять исходные значения, использованные в проверке.
  • Результат помогает проверить данные серии; решение о выпуске остаётся за уполномоченным QA/QC-персоналом.

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

  1. Запуск: Tc99mMAG3LabelingEfficiencyAnalyzer.exe в demo-режиме или с аргументами input.csv output.json.
  2. Чтение CSV в UTF-8; проверка заголовка и обязательных колонок.
  3. Преобразование значений к ожидаемым типам и проверка допустимости.
  4. Выполнение расчёта или правил для функции «Анализатор эффективности мечения MAG3 технецием-99m».
  5. Формирование отдельных проверок и итогового статуса.
  6. Запись машинно-читаемого JSON; при ошибке входных данных результат не должен выглядеть как успешный.

Пример input.csv

BatchNumber,ProductName,Complex_Percent,Free_Tc_Percent,Hydrolyzed_Percent,pH,Incubation_Min,Activity_MBq,Min_RCP,Max_Free,Max_Hydro
MAG3-2026-001,Tc-99m MAG3 Standard,96.5,2.0,1.5,7.4,10,740,90,5,5

Минимальная структура output.json

{
  "utility": "Tc99mMAG3LabelingEfficiencyAnalyzer",
  "source": "input.csv",
  "status": "PASS|WARNING|FAIL",
  "checks": [
    {
      "parameter": "example",
      "status": "PASS",
      "message": "criterion satisfied"
    }
  ],
  "errors": []
}

Проверка перед эксплуатацией

  • Пределы и коэффициенты должны быть утверждены до рабочего использования.
  • После изменения executable или правил следует повторить затронутые тесты.
  • Исходный CSV и JSON-результат следует хранить вместе в контролируемом процессе.

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

Радиофармпрепараты для диагностики и терапии: контроль качества

36 утилит для клинически ориентированного контроля радиофармпрепаратов и связанных процессов: PET/SPECT-трассеры, Tc-99m renal workflow, PRRT, PSMA-терапия, таргетная альфа-терапия, радиоэмболизация, костная паллиативная терапия, иммуно-PET и контроль генераторных радионуклидов.

Открыть

RPH isotope family: Tc-99m

Tc-99m РФП, kit preparation, генераторный контроль, SPECT workflows и расчётные утилиты.

Открыть

RPH organ/system: эндокринология, щитовидная железа и NET

Radioiodine, thyroid/parathyroid, somatostatin receptor, MIBG и neuroendocrine workflows.

Открыть

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

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

Открыть

RPH organ/system: почки и мочевыводящие пути

Ренография, GFR/ERPF, renal uptake, DMSA/MAG3/DTPA и bladder-related workflows.

Открыть

RPH Tc-99m: контроль качества ренальных радиофармпрепаратов и визуализации

16 утилит для полного Tc-99m renal workflow: контроль генераторного элюата и прорыва Mo-99, Sn(II), стехиометрии и pH мечения, радиохимической чистоты и стабильности MAG3, DTPA, DMSA(III) и глюкогептоната, однородности гамма-камеры, накопления и клиренса почек, эффективности опорожнения мочевого пузыря, дозиметрии пациента и decay-in-storage отходов.

Открыть

RPH use case: Tc-99m renal / нефроурология

Ренальные РФП и расчётные workflow: MAG3, DTPA, DMSA, глюкогептонат, генераторный Tc-99m, динамическая ренография, GFR/ERPF и дозиметрия.

Открыть

RPH workflow: генераторы и изотопная чистота

Generator eluate, breakthrough, radionuclidic purity, isotope mix и starting radionuclides.

Открыть

RPH workflow: imaging QC и количественная интерпретация

Acquisition, uptake, clearance, perfusion, transit, ejection fraction, segmentation и quantitative imaging.

Открыть

RPH workflow: product release QC

Assay, purity, sterility, endotoxins, pH, impurities, appearance и batch-release checks.

Открыть

RPH workflow: стабильность, хранение, распад и отходы

Kinetic stability, shelf life, decay correction, expiry, storage, trend и radioactive waste.

Открыть

RPH workflow: синтез, мечение и восстановление kit

Radiolabelling, synthesis, chelation, reducing agent, pH/stoichiometry и kit preparation.

Открыть