BladderVoidingEfficiencyAnalyzer

Bladder Voiding Efficiency Analyzer

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

Описание утилиты: Анализ эффективности опорожнения мочевого пузыря

Bladder Voiding Efficiency Analyzer — Анализ эффективности опорожнения мочевого пузыря

ℹ️  Утилита рассчитывает процент эвакуации активности из мочевого пузыря:
    • Эффективность опорожнения (норма >90%)
    • Процент остаточной активности (норма <10%)
    • Коррекция на фон и радиоактивный распад Tc-99m

⚠️  КРИТИЧНО: Низкая эффективность (<80%) может указывать на патологию!
    Остаточная активность создает артефакты на почках и повышает дозу облучения.
    Важно для дифференциальной диагностики обструкций и рефлюксов.

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

Формат input.csv:
PatientID,StudyDate,PreVoidCounts,PostVoidCounts,BackgroundCounts,AcquisitionTimePreSec,AcquisitionTimePostSec,DecayCorrectionFactor,ResidualVolumeML

Пример:
  PAT-RENAL-001,2026-07-21,150000,15000,500,60,60,1.05,20.0

— ЗАЧЕМ ЭТО НУЖНО?
При динамической ренографии (с Tc-99m MAG3 или DTPA) мочевой пузырь накапливает радиоактивную мочу.
Полное опорожнение критически важно для:
• Точной оценки функции почек (чтобы активность из пузыря не "засвечивала" лоханки)
• Выявления пузырно-мочеточникового рефлюкса (ПМР)
• Диагностики нейрогенного мочевого пузыря или обструкции шейки
• Снижения лучевой нагрузки на пациента (остаточная моча продолжает облучать ткани)

⚠️  КРИТИЧЕСКИ ВАЖНО:
• Эффективность опорожнения >90% — норма для взрослого здорового человека.
• Остаточная активность <10% — гарантирует отсутствие значимых артефактов.
• Коррекция на распад — обязательна, если между кадрами "до" и "после" прошло более 5-10 минут.
• Фоновая коррекция — необходима для учета рассеянного излучения от окружающих тканей.

Ключевые особенности утилиты:
• Автоматический расчет чистых счетчиков (Net Counts) с вычетом фона.
• Учет радиоактивного распада Tc-99m (T½=6ч) между измерениями.
• Расчет процента остаточной активности (Residual Activity Percent).
• Интеграция с данными об остаточном объеме мочи (если доступен).
• Генерация предупреждений при подозрении на патологическую задержку мочи.

Критические параметры:
• Эффективность опорожнения: >90.0%
• Остаточная активность: <10.0%
• Чистые счетчики до опорожнения: >0
• Коэффициент распада: 1.0–1.5 (типичный диапазон для коротких интервалов)

💡 Советы по использованию:
1. ROI (Region of Interest) мочевого пузыря должен быть одинаковым на кадрах "до" и "после".
2. Фон измеряется в области рядом с пузырем, но вне проекции почек и кишечника.
3. Пациент должен выпить воду перед исследованием для обеспечения достаточного диуреза.
4. При низкой эффективности (<80%) рекомендуется повторное сканирование после катетеризации или ультразвукового измерения остаточного объема.
5. У детей норма эффективности может быть ниже из-за неполного контроля над сфинктером.

⚠️ Особенность: Накопление Tc-99m в мочевом пузыре — это не побочный эффект, а ожидаемый путь экскреции. Однако неспособность полностью опорожнить пузырь является серьезным клиническим признаком. Эта утилита помогает количественно оценить этот параметр, переводя визуальную оценку в точные цифры для медицинской карты.

input.csv

PatientID,StudyDate,PreVoidCounts,PostVoidCounts,BackgroundCounts,AcquisitionTimePreSec,AcquisitionTimePostSec,DecayCorrectionFactor,ResidualVolumeML
PAT-RENAL-001,2026-07-21,150000,15000,500,60,60,1.05,20.0
PAT-RENAL-002,2026-07-21,120000,60000,400,60,60,1.02,150.0
PAT-RENAL-003,2026-07-21,180000,5000,600,60,60,1.08,10.0

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

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

  • Утилита должна принимать input.csv с заголовками, указанными в контракте данных.
  • До расчёта утилита должна выявлять отсутствующие поля, ошибки типов и некорректные значения.
  • Утилита должна детерминированно выполнять функцию «Анализ эффективности опорожнения мочевого пузыря».
  • Проверки должны учитывать следующие критерии: Эффективность опорожнения: >90.0%; Остаточная активность: <10.0%; Чистые счетчики до опорожнения: >0; Коэффициент распада: 1.0–1.5 (типичный диапазон для коротких интервалов).
  • Для обработанной записи должен формироваться понятный статус PASS, WARNING или FAIL с причиной.
  • Результат должен записываться в output.json и сохранять исходные значения, использованные в проверке.
  • Расчёт используется как поддержка специалиста; итог не является автономным диагнозом или назначением.

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

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

Пример input.csv

PatientID,StudyDate,PreVoidCounts,PostVoidCounts,BackgroundCounts,AcquisitionTimePreSec,AcquisitionTimePostSec,DecayCorrectionFactor,ResidualVolumeML
PAT-RENAL-001,2026-07-21,150000,15000,500,60,60,1.05,20.0

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

{
  "utility": "BladderVoidingEfficiencyAnalyzer",
  "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: головной мозг и ЦНС

Brain perfusion, dopamine transporter, amyloid/tau, receptor imaging и neurological SPECT/PET.

Открыть

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

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

Открыть