PETNormalizationTrendChecker

PET Normalization Trend Checker

instrumental RPH PET scanner state PET QC CSV→JSON URS & FS rule-based PET
Открыть подборку

Тренд факторов нормализации и состояния PET-детекторов

Сравнивает текущую normalization с предыдущей и installation baseline для выявления постепенного дрейфа.

  • дрейф среднего фактора;
  • изменение CV;
  • новые dead detectors и отклонение от baseline.

Сравниваемые normalization runs должны относиться к одной конфигурации сканера и совместимым версиям ПО.

input.csv

ScannerID,CurrentNormID,PreviousNormID,BaselineNormID,CurrentMeanFactor,PreviousMeanFactor,BaselineMeanFactor,CurrentCV,PreviousCV,BaselineCV,CurrentDeadDetectors,PreviousDeadDetectors,BaselineDeadDetectors,TrendPeriodDays
PET-SIEMENS-01,NORM-2026-07-22,NORM-2026-06-22,NORM-INSTALL-2024,1.005,1.002,1.000,1.5,1.4,1.2,0,0,0,30
PET-GE-02,NORM-2026-07-20,NORM-2026-06-20,NORM-INSTALL-2023,1.080,1.010,1.000,3.5,2.0,1.5,2,0,0,30
PET-PHILIPS-03,NORM-2026-07-21,NORM-2026-06-21,NORM-INSTALL-2025,1.001,1.000,1.000,1.2,1.2,1.2,0,0,0,30

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

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

  • Утилита должна принимать input.csv с заголовками, указанными в контракте данных.
  • До расчёта утилита должна выявлять отсутствующие колонки, ошибки типов, пустые обязательные значения и нелогичные даты или диапазоны.
  • Утилита должна детерминированно выполнять функцию «Тренд факторов нормализации и состояния PET-детекторов».
  • Пределы и правила должны загружаться из утверждённого профиля либо быть явно зафиксированы в валидируемой версии.
  • Для каждой записи должен формироваться понятный итоговый статус: PASS, WARNING или FAIL, с указанием причины.
  • Результат должен сохранять исходные значения, вычисленные показатели, применённые пределы и отдельные статусы проверок.
  • Ошибка входных данных не должна возвращаться как успешный результат. Итог используется квалифицированным специалистом в рамках утверждённой процедуры.

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

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

Пример input.csv

ScannerID,CurrentNormID,PreviousNormID,BaselineNormID,CurrentMeanFactor,PreviousMeanFactor,BaselineMeanFactor,CurrentCV,PreviousCV,BaselineCV,CurrentDeadDetectors,PreviousDeadDetectors,BaselineDeadDetectors,TrendPeriodDays
PET-SIEMENS-01,NORM-2026-07-22,NORM-2026-06-22,NORM-INSTALL-2024,1.005,1.002,1.000,1.5,1.4,1.2,0,0,0,30
PET-GE-02,NORM-2026-07-20,NORM-2026-06-20,NORM-INSTALL-2023,1.080,1.010,1.000,3.5,2.0,1.5,2,0,0,30
PET-PHILIPS-03,NORM-2026-07-21,NORM-2026-06-21,NORM-INSTALL-2025,1.001,1.000,1.000,1.2,1.2,1.2,0,0,0,30

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

{
  "utility": "PETNormalizationTrendChecker",
  "source": "input.csv",
  "status": "PASS|WARNING|FAIL",
  "derivedValues": {},
  "checks": [
    {
      "parameter": "example",
      "value": 0,
      "limit": "configured profile",
      "status": "PASS",
      "message": "criterion satisfied"
    }
  ],
  "errors": []
}

Минимальные OQ-сценарии

  • Строка в пределах профиля должна вернуть PASS.
  • Строка с нарушенным некритическим пределом должна вернуть WARNING или review-status.
  • Критическое нарушение должно вернуть FAIL либо соответствующее эксплуатационное решение.
  • Отсутствующая колонка, неверный тип или невозможная дата должны заполнить errors и не возвращать PASS.

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

  • Сверить формулы и пределы с manufacturer documentation и утверждённым SOP.
  • Зафиксировать scanner model, software version и версию профиля.
  • После изменения executable, формул или профиля повторить затронутые тесты.
  • Хранить source CSV и JSON-результат вместе.

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

PET Scanner State QC Suite

14 утилит для контроля состояния PET/PET-CT сканера: активность источников Ge-68/Ga-68, blank sinogram, эффективность детекторов, сбор и распределение факторов нормализации, назначение normalization file, тренды, энергетическое окно, TOF, attenuation-correction map, PET/CT cross-calibration и итоговое ежедневное решение.

Открыть

RPH use case: PET scanner state, gamma camera и radiation physics

Связанный слой medical-device/radiation-physics: PET detector QC, normalization, AC map, cross-calibration, TOF, gamma-camera uniformity, source strength и staff dose.

Открыть

RPH workflow: instruments, devices и radiation safety

PET/gamma-camera state, calibration, detector QC, energy window, TOF, shielding и radiation safety.

Открыть

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

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

Открыть