ReducingAgentStoichiometryCalculator

Reducing Agent Stoichiometry Calculator

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

Описание утилиты: Калькулятор стехиометрии восстановителя (SnCl2)

Reducing Agent Stoichiometry Calculator — Калькулятор стехиометрии восстановителя (SnCl2)

ℹ️  Утилита рассчитывает оптимальный объем раствора хлорида олова(II):
    • На основе массы лиганда и активности Tc-99m
    • С учетом коэффициента избытка (для компенсации окисления)
    • С проверкой на токсичность и риск образования коллоидов

⚠️  КРИТИЧНО: Недостаток олова → низкая эффективность мечения!
    Избыток олова → образование коллоидов Sn/Tc и накопление в печени!
    Расчет помогает стандартизировать процесс приготовления наборов.

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

Формат input.csv:
KitName,LigandMassMg,LigandMolecularWeight,Tc99mActivityGBq,SnCl2ConcentrationMgPerML,ExcessFactor,VolumeToReconstituteML

Пример:
  Tc99m-MAG3-Kit,1.0,384.4,2.0,1.0,50.0,5.0

— ЗАЧЕМ ЭТО НУЖНО?
Восстановление технеция-99m из степени окисления +7 (пертехнетат) до низших степеней (+4, +5) требует присутствия восстановителя.
Хлорид олова(II) (SnCl2) — самый распространенный агент.
• Стехиометрия реакции сложна из-за быстрого окисления Sn(II) до Sn(IV) кислородом воздуха.
• Необходим значительный избыток Sn(II) относительно Tc-99m (часто в 1000-10000 раз по молям).
• Однако избыток Sn(II) может привести к образованию коллоидного гидроксида олова, который захватывает Tc-99m, создавая примесь, накапливающуюся в печени и селезенке.
• Эта утилита помогает найти баланс между достаточным количеством для мечения и безопасным уровнем.

⚠️  КРИТИЧЕСКИ ВАЖНО:
• Молярное отношение Sn/Лиганд должно быть достаточно высоким для обеспечения кинетики реакции.
• Концентрация Sn в итоговом растворе не должна превышать пределы токсичности (обычно < 5 мкг/мл для инъекций, но в наборах локально выше).
• Раствор SnCl2 должен быть свежим и защищенным от кислорода (под азотом).
• pH среды критически влияет на стабильность Sn(II) (в кислой среде стабильнее).

Ключевые особенности утилиты:
• Расчет количества атомов Tc-99m на основе активности (через постоянную распада).
• Определение теоретического минимума массы олова.
• Применение пользовательского коэффициента избытка (Excess Factor).
• Оценка риска коллоидообразования на основе финальной концентрации.
• Поддержка различных лигандов (MAG3, DTPA, HMPAO, MDP и др.).

Критические параметры:
• Молярное отношение Sn/Ligand: > 1.0 (практически 10-100)
• Финальная концентрация Sn: < 5.0 мг/мл (в зоне реакции)
• Объем добавляемого восстановителя: должен быть точным (микролитры)

💡 Советы по использованию:
1. Используйте высокочистый SnCl2, растворенный в разбавленной HCl для предотвращения гидролиза.
2. Коэффициент избытка (ExcessFactor) зависит от возраста набора и герметичности флакона. Для старых наборов увеличивайте его.
3. Если расчет показывает очень малый объем (< 1 мкл), рассмотрите возможность разведения исходного раствора SnCl2 для повышения точности дозирования.
4. Всегда проверяйте pH после добавления восстановителя и лиганда.
5. Для высокоактивных препаратов (> 5 ГБк) может потребоваться увеличение массы Sn для предотвращения радиолиза.

⚠️ Особенность: Стехиометрия мечения Tc-99m — это не просто химия, это гонка со временем и радиолизом. Правильный расчет количества олова — залог высокой радиохимической чистоты. Ошибка в расчетах приводит к браку всей партии дорогостоящего изотопа.

input.csv

KitName,LigandMassMg,LigandMolecularWeight,Tc99mActivityGBq,SnCl2ConcentrationMgPerML,ExcessFactor,VolumeToReconstituteML
Tc99m-MAG3-Kit,1.0,384.4,2.0,1.0,50.0,5.0
Tc99m-DTPA-Kit,2.0,393.3,3.0,0.5,100.0,10.0
Tc99m-HMPAO-Kit,0.5,350.0,1.5,2.0,20.0,5.0

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

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

  • Утилита должна принимать input.csv с заголовками, указанными в контракте данных.
  • До расчёта утилита должна выявлять отсутствующие поля, ошибки типов и некорректные значения.
  • Утилита должна детерминированно выполнять функцию «Калькулятор стехиометрии восстановителя (SnCl2)».
  • Проверки должны учитывать следующие критерии: Молярное отношение Sn/Ligand: > 1.0 (практически 10-100); Финальная концентрация Sn: < 5.0 мг/мл (в зоне реакции); Объем добавляемого восстановителя: должен быть точным (микролитры).
  • Для обработанной записи должен формироваться понятный статус PASS, WARNING или FAIL с причиной.
  • Результат должен записываться в output.json и сохранять исходные значения, использованные в проверке.
  • Результат помогает проверить данные серии; решение о выпуске остаётся за уполномоченным QA/QC-персоналом.

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

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

Пример input.csv

KitName,LigandMassMg,LigandMolecularWeight,Tc99mActivityGBq,SnCl2ConcentrationMgPerML,ExcessFactor,VolumeToReconstituteML
Tc99m-MAG3-Kit,1.0,384.4,2.0,1.0,50.0,5.0

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

{
  "utility": "ReducingAgentStoichiometryCalculator",
  "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: кости и опорно-двигательная система

Bone scintigraphy, MDP/PYP, marrow, bone-pain palliation, skeletal metastases и radiosynovectomy.

Открыть

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: 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.

Открыть