RenalPlasmaClearanceEstimator

Renal Plasma Clearance Estimator

medical_devices RPH Tc-99m renal imaging nuclear medicine CSV→JSON URS & FS rule-based

Описание утилиты: Оценка почечного плазменного клиренса (СКФ/GFR и ЭППП/ERPF)

Renal Plasma Clearance Estimator — Оценка почечного плазменного клиренса (СКФ/GFR и ЭППП/ERPF)

ℹ️ Утилита рассчитывает скорость клубочковой фильтрации (СКФ) или эффективный почечный плазмоток:
• На основе однопробного метода анализа крови
• С учетом введенной активности и концентрации в плазме
• С нормализацией на площадь поверхности тела (BSA)

⚠️ КРИТИЧНО: Точность зависит от времени взятия пробы!
DTPA: проба через 120 мин. MAG3: проба через 40-50 мин.
Ошибка в определении чистой введенной активности ведет к пропорциональной ошибке в результате.

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

Формат input.csv:
PatientID,StudyDate,InjectedActivityMBq,PreInjectionSampleCounts,PostInjectionSampleCounts,BloodSampleCountsPerML,TimePostInjectionMin,PatientWeightKg,PatientHeightCm,PatientAge,Gender,Radiopharmaceutical

Пример:
PAT-GFR-001,2026-07-21,100.0,500000,5000,2500,120,70,175,45,M,DTPA

— ЗАЧЕМ ЭТО НУЖНО?
Количественная оценка функции почек является золотым стандартом в нефрологии.
• Tc-99m DTPA фильтруется клубочками, поэтому его клиренс равен СКФ (GFR).
• Tc-99m MAG3 секретируется канальцами, поэтому его клиренс равен ЭППП (ERPF).
• Однопробный метод (взятие одной пробы крови через определенное время) менее точен, чем многопробный, но гораздо удобнее для пациента и клиники.
• Результаты нормализуются на стандартную площадь поверхности тела (1.73 м²) для сравнения между пациентами.

⚠️ КРИТИЧЕСКИ ВАЖНО:
• Чистая введенная активность = (Счетчики до - Счетчики после) / Счетчики до * Активность в шприце. Любая потеря препарата должна быть учтена.
• Время взятия пробы критично: для DTPA фаза распределения заканчивается к 120 мин, для MAG3 — к 40-50 мин.
• Объем плазмы оценивается косвенно через вес и рост пациента.
• Гематокрит влияет на объем плазмы; если известен точный гематокрит пациента, расчет можно уточнить.

Ключевые особенности утилиты:
• Автоматический расчет чистой введенной дозы по счетчикам шприца.
• Выбор модели расчета в зависимости от препарата (DTPA или MAG3).
• Нормализация результатов на площадь поверхности тела (формула Du Bois).
• Проверка оптимальности времени взятия пробы.
• Интерпретация результатов относительно возрастных норм.

Критические параметры:
• СКФ (GFR) норма: 90–120 мл/мин/1.73м²
• ЭППП (ERPF) норма: 400–600 мл/мин/1.73м²
• Время пробы DTPA: 110–130 мин
• Время пробы MAG3: 40–50 мин

💡 Советы по использованию:
1. Тщательно измеряйте активность шприца до и после инъекции в одинаковой геометрии (счетчике).
2. Проба крови должна быть взята точно в указанное время. Отклонение более чем на 5 минут требует корректировки коэффициента.
3. Для пациентов с ожирением или отеками оценка объема плазмы по весу может быть неточной.
4. Если клиренс ниже нормы, рекомендуется повторить исследование многопробным методом для построения полной кривой очищения.
5. Учитывайте прием лекарств, влияющих на почечный кровоток (например, НПВС), перед исследованием.

⚠️ Особенность: Эта утилита связывает фармацевтическую часть (активность препарата) с клинической физиологией. Она позволяет объективизировать функцию почек, что невозможно сделать только по визуальному осмотру сцинтиграммы. Результаты используются для стадирования хронической болезни почек (ХБП) и принятия решений о диализе или трансплантации.

input.csv

PatientID,StudyDate,InjectedActivityMBq,PreInjectionSampleCounts,PostInjectionSampleCounts,BloodSampleCountsPerML,TimePostInjectionMin,PatientWeightKg,PatientHeightCm,PatientAge,Gender,Radiopharmaceutical
PAT-GFR-001,2026-07-21,100.0,500000,5000,2500,120,70,175,45,M,DTPA
PAT-ERPF-002,2026-07-21,150.0,600000,6000,1800,45,80,180,50,F,MAG3
PAT-GFR-003,2026-07-21,80.0,400000,4000,4000,120,50,150,70,M,DTPA

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

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

Утилита должна принимать input.csv с заголовками, указанными в контракте данных.
До расчёта утилита должна выявлять отсутствующие поля, ошибки типов и некорректные значения.
Утилита должна детерминированно выполнять функцию «Оценка почечного плазменного клиренса (СКФ/GFR и ЭППП/ERPF)».
Проверки должны учитывать следующие критерии: СКФ (GFR) норма: 90–120 мл/мин/1.73м²; ЭППП (ERPF) норма: 400–600 мл/мин/1.73м²; Время пробы DTPA: 110–130 мин; Время пробы MAG3: 40–50 мин.
Для обработанной записи должен формироваться понятный статус PASS, WARNING или FAIL с причиной.
Результат должен записываться в output.json и сохранять исходные значения, использованные в проверке.
Расчёт используется как поддержка специалиста; итог не является автономным диагнозом или назначением.

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

Запуск: RenalPlasmaClearanceEstimator.exe в demo-режиме или с аргументами input.csv output.json.
Чтение CSV в UTF-8; проверка заголовка и обязательных колонок.
Преобразование значений к ожидаемым типам и проверка допустимости.
Выполнение расчёта или правил для функции «Оценка почечного плазменного клиренса (СКФ/GFR и ЭППП/ERPF)».
Формирование отдельных проверок и итогового статуса.
Запись машинно-читаемого JSON; при ошибке входных данных результат не должен выглядеть как успешный.

Пример input.csv

PatientID,StudyDate,InjectedActivityMBq,PreInjectionSampleCounts,PostInjectionSampleCounts,BloodSampleCountsPerML,TimePostInjectionMin,PatientWeightKg,PatientHeightCm,PatientAge,Gender,Radiopharmaceutical
PAT-GFR-001,2026-07-21,100.0,500000,5000,2500,120,70,175,45,M,DTPA

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

{
  "utility": "RenalPlasmaClearanceEstimator",
  "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: imaging QC и количественная интерпретация

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

Открыть