PETEnergyWindowStabilityChecker
PET Energy Window Stability Checker
Стабильность энергетического окна PET
Проверяет положение 511-keV photopeak, энергетическое разрешение и параметры установленного окна.
- сдвиг photopeak относительно 511 keV;
- energy resolution FWHM;
- центр окна и доля scatter events.
Energy window и допустимое разрешение зависят от детектора и vendor configuration; профиль должен быть версионирован.
input.csv
ScannerID,CheckDate,MeasuredPeakEnergyKeV,EnergyResolutionPercent,LowerLevelDiscriminatorKeV,UpperLevelDiscriminatorKeV,RandomsRateKcps,ScatterFractionPercent PET-SIEMENS-01,2026-07-22,510.5,11.5,425.0,650.0,15.0,38.0 PET-GE-02,2026-07-22,515.0,12.0,430.0,660.0,18.0,40.0 PET-PHILIPS-03,2026-07-22,505.0,14.5,420.0,640.0,12.0,35.0
URS & FS — пользовательские требования и функциональная спецификация
URS — требования пользователя
- Утилита должна принимать input.csv с заголовками, указанными в контракте данных.
- До расчёта утилита должна выявлять отсутствующие колонки, ошибки типов, пустые обязательные значения и нелогичные даты или диапазоны.
- Утилита должна детерминированно выполнять функцию «Стабильность энергетического окна PET».
- Пределы и правила должны загружаться из утверждённого профиля либо быть явно зафиксированы в валидируемой версии.
- Для каждой записи должен формироваться понятный итоговый статус: PASS, WARNING или FAIL, с указанием причины.
- Результат должен сохранять исходные значения, вычисленные показатели, применённые пределы и отдельные статусы проверок.
- Ошибка входных данных не должна возвращаться как успешный результат. Итог используется квалифицированным специалистом в рамках утверждённой процедуры.
FS — функциональная спецификация
- Запуск PETEnergyWindowStabilityChecker.exe в demo-режиме или с аргументами input.csv output.json.
- Чтение UTF-8 CSV и сопоставление колонок с контрактом.
- Преобразование значений к ожидаемым типам и проверка обязательных полей.
- Выполнение расчётов и правил для функции «Стабильность энергетического окна PET».
- Формирование массива отдельных checks и итогового статуса по принципу наихудшего результата.
- Запись machine-readable output.json; errors заполняется при невозможности корректного расчёта.
Пример input.csv
ScannerID,CheckDate,MeasuredPeakEnergyKeV,EnergyResolutionPercent,LowerLevelDiscriminatorKeV,UpperLevelDiscriminatorKeV,RandomsRateKcps,ScatterFractionPercent PET-SIEMENS-01,2026-07-22,510.5,11.5,425.0,650.0,15.0,38.0 PET-GE-02,2026-07-22,515.0,12.0,430.0,660.0,18.0,40.0 PET-PHILIPS-03,2026-07-22,505.0,14.5,420.0,640.0,12.0,35.0
Минимальная структура output.json
{
"utility": "PETEnergyWindowStabilityChecker",
"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.
Открыть