PETACMapIntegrityChecker

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

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

Пример input.csv

StudyID,PatientID,MinHU,MaxHU,MeanAirHU,MeanBoneHU,TruncationArtifactsCount,HasMetalImplants,BodyWidthCM,ScannerFOV_CM,InvalidVoxelsCount
PET-CT-2026-001,PAT-AC-001,-1020,2500,-998,850,0,false,45,70,0
PET-CT-2026-002,PAT-AC-002,-1024,3100,-950,900,2,false,75,70,0
PET-CT-2026-003,PAT-AC-003,-1020,2000,-1005,800,0,true,50,70,5

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

{
  "utility": "PETACMapIntegrityChecker",
  "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-результат вместе.