Tc99mLabelingReactionpHOptimizationTool

Tc-99m Labeling Reaction pH Optimization Tool

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

Описание утилиты: Оптимизация pH реакции мечения

Tc-99m Labeling Reaction pH Optimization Tool — Оптимизация pH реакции мечения

ℹ️  Утилита рассчитывает необходимый объем буфера для достижения целевого pH:
    • Учитывает тип препарата (DMSA, MAG3, HMPAO...)
    • Рассчитывает объем буфера без чрезмерного разбавления
    • Оценивает риск нестабильности комплекса

⚠️  КРИТИЧНО: Неправильный pH — главная причина брака мечения!
    DMSA требует кислой среды, HMPAO — щелочной. Ошибка ведет к гидролизу.
    Не добавляйте более 20% буфера от объема элюата.

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

Формат input.csv:
KitName,EluateVolumeML,EluatePH,TargetPH,LigandBufferCapacity,BufferType,BufferConcentrationM,BufferPH

Пример:
  Tc99m-DMSA,5.0,5.5,5.0,0.5,Citrate,0.1,4.5

— ЗАЧЕМ ЭТО НУЖНО?
Элюат генератора Tc-99m имеет переменный pH (обычно 4.5-7.5), который зависит от возраста генератора и объема элюции.
Каждый радиофармпрепарат требует строго определенного pH для стабильного комплексообразования:
• DMSA: pH 4.0-6.0 (кислая среда предотвращает гидролиз Sn и стабилизирует комплекс).
• MAG3: pH 5.0-7.0 (нейтральная/слабокислая для оптимальной кинетики).
• HMPAO: pH 7.0-8.5 (щелочная среда необходима для образования липофильного комплекса).
• DTPA: pH 4.0-8.0 (широкий диапазон, но лучше нейтральный).

⚠️  КРИТИЧЕСКИ ВАЖНО:
• Добавление слишком большого объема буфера разбавляет удельную активность препарата.
• Использование неправильного типа буфера (например, фосфата вместо цитрата) может привести к осаждению технеция.
• pH должен проверяться AFTER добавления всех компонентов, но BEFORE нагревания (если требуется).
• Буфер должен быть апирогенным и стерильным.

Ключевые особенности утилиты:
• База данных оптимальных pH для основных препаратов Tc-99m.
• Расчет объема буфера с учетом его концентрации и pH.
• Предупреждение о чрезмерном разбавлении (>25% объема).
• Оценка стабильности комплекса в заданных условиях.
• Поддержка различных типов буферов (Цитрат, Фосфат, Ацетат, Карбонат).

Критические параметры:
• Целевой pH: должен попадать в узкий диапазон препарата
• Объем буфера: < 20-25% от объема элюата
• Концентрация буфера: 0.05–0.5 М
• Стабильность: Score > 7/10

💡 Советы по использованию:
1. Всегда используйте микропипетки для добавления малых объемов буфера.
2. Если расчет показывает необходимость большого объема буфера, используйте более концентрированный раствор буфера.
3. Для HMPAO стабилизация pH критична в первые 30 минут после мечения.
4. Проверяйте pH индикаторными полосками, если нет электронного pH-метра для малых объемов.
5. Записывайте фактический pH в протокол приготовления каждой партии.

⚠️ Особенность: pH является "невидимым убийцей" качества радиофармпрепаратов. Визуально раствор может выглядеть чистым, но если pH сдвинут на 0.5 единицы, эффективность мечения может упасть с 98% до 60%, что приведет к ложным диагнозам у пациентов. Эта утилита устраняет человеческий фактор в этом сложном химическом балансе.

input.csv

KitName,EluateVolumeML,EluatePH,TargetPH,LigandBufferCapacity,BufferType,BufferConcentrationM,BufferPH
Tc99m-DMSA,5.0,5.5,5.0,0.5,Citrate,0.1,4.5
Tc99m-MAG3,10.0,6.0,6.5,1.0,Phosphate,0.2,7.0
Tc99m-HMPAO,5.0,5.0,7.5,0.8,Carbonate,0.1,9.0

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

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

  • Утилита должна принимать input.csv с заголовками, указанными в контракте данных.
  • До расчёта утилита должна выявлять отсутствующие поля, ошибки типов и некорректные значения.
  • Утилита должна детерминированно выполнять функцию «Оптимизация pH реакции мечения».
  • Проверки должны учитывать следующие критерии: Целевой pH: должен попадать в узкий диапазон препарата; Объем буфера: < 20-25% от объема элюата; Концентрация буфера: 0.05–0.5 М; Стабильность: Score > 7/10.
  • Для обработанной записи должен формироваться понятный статус PASS, WARNING или FAIL с причиной.
  • Результат должен записываться в output.json и сохранять исходные значения, использованные в проверке.
  • Результат помогает проверить данные серии; решение о выпуске остаётся за уполномоченным QA/QC-персоналом.

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

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

Пример input.csv

KitName,EluateVolumeML,EluatePH,TargetPH,LigandBufferCapacity,BufferType,BufferConcentrationM,BufferPH
Tc99m-DMSA,5.0,5.5,5.0,0.5,Citrate,0.1,4.5

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

{
  "utility": "Tc99mLabelingReactionpHOptimizationTool",
  "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: почки и мочевыводящие пути

Ренография, 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: стабильность, хранение, распад и отходы

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

Открыть

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

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

Открыть