PETNormalizationFileAssignmentChecker
PET Normalization File Assignment Checker
medical_devices RPH PET scanner state PET QC CSV→JSON URS & FS rule-based PET
Открыть подборкуПроверка назначения файла нормализации PET
Проверяет, что исследованию назначен утверждённый normalization file для нужного сканера, версии ПО и конфигурации детекторов.
- совпадение ScannerID и detector configuration;
- совместимость версии ПО и срок действия;
- hash integrity и approval status.
Допустимый возраст файла задаётся manufacturer procedure; универсальный срок 30 дней не применяется без утверждения.
input.csv
ScannerID,StudyID,AssignedNormFile,NormFileScannerID,NormFileSoftwareVersion,CurrentScannerSoftwareVersion,NormFileCreationDate,FileAgeDays,ExpectedHash,ActualHash,IsApproved,DetectorConfig,CurrentDetectorConfig PET-SIEMENS-01,PAT-STUDY-2026-001,NORM_20260722_V01.map,PET-SIEMENS-01,VE11A,VE11A,2026-07-22,0,A1B2C3D4,A1B2C3D4,true,Standard,Standard PET-SIEMENS-01,PAT-STUDY-2026-002,NORM_20260101_V05.map,PET-SIEMENS-01,VE11A,VE11A,2026-01-01,200,A1B2C3D4,A1B2C3D4,true,Standard,Standard PET-GE-02,PAT-STUDY-2026-003,NORM_GE_OLD.map,PET-SIEMENS-01,VE11A,MP23,2026-07-20,2,X9Y8Z7,X9Y8Z7,false,Standard,Standard
URS & FS — пользовательские требования и функциональная спецификация
URS — требования пользователя
- Утилита должна принимать input.csv с заголовками, указанными в контракте данных.
- До расчёта утилита должна выявлять отсутствующие колонки, ошибки типов, пустые обязательные значения и нелогичные даты или диапазоны.
- Утилита должна детерминированно выполнять функцию «Проверка назначения файла нормализации PET».
- Пределы и правила должны загружаться из утверждённого профиля либо быть явно зафиксированы в валидируемой версии.
- Для каждой записи должен формироваться понятный итоговый статус: PASS, WARNING или FAIL, с указанием причины.
- Результат должен сохранять исходные значения, вычисленные показатели, применённые пределы и отдельные статусы проверок.
- Ошибка входных данных не должна возвращаться как успешный результат. Итог используется квалифицированным специалистом в рамках утверждённой процедуры.
FS — функциональная спецификация
- Запуск PETNormalizationFileAssignmentChecker.exe в demo-режиме или с аргументами input.csv output.json.
- Чтение UTF-8 CSV и сопоставление колонок с контрактом.
- Преобразование значений к ожидаемым типам и проверка обязательных полей.
- Выполнение расчётов и правил для функции «Проверка назначения файла нормализации PET».
- Формирование массива отдельных checks и итогового статуса по принципу наихудшего результата.
- Запись machine-readable output.json; errors заполняется при невозможности корректного расчёта.
Пример input.csv
ScannerID,StudyID,AssignedNormFile,NormFileScannerID,NormFileSoftwareVersion,CurrentScannerSoftwareVersion,NormFileCreationDate,FileAgeDays,ExpectedHash,ActualHash,IsApproved,DetectorConfig,CurrentDetectorConfig PET-SIEMENS-01,PAT-STUDY-2026-001,NORM_20260722_V01.map,PET-SIEMENS-01,VE11A,VE11A,2026-07-22,0,A1B2C3D4,A1B2C3D4,true,Standard,Standard PET-SIEMENS-01,PAT-STUDY-2026-002,NORM_20260101_V05.map,PET-SIEMENS-01,VE11A,VE11A,2026-01-01,200,A1B2C3D4,A1B2C3D4,true,Standard,Standard PET-GE-02,PAT-STUDY-2026-003,NORM_GE_OLD.map,PET-SIEMENS-01,VE11A,MP23,2026-07-20,2,X9Y8Z7,X9Y8Z7,false,Standard,Standard
Минимальная структура output.json
{
"utility": "PETNormalizationFileAssignmentChecker",
"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.
Открыть