PETACMapIntegrityChecker
PET AC Map Integrity Checker
PET/CT Attenuation-Correction Map Integrity Check
Checks summary metrics of the CT-derived attenuation map before quantitative PET reconstruction.
- physically plausible HU range;
- truncation artifacts and body width relative to FOV;
- invalid voxels and metal presence as a review factor.
This is a summary-metric check, not DICOM image analysis. Visual review and vendor reconstruction controls remain required.
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
URS & FS — user requirements and functional specification
URS — User Requirements Specification
- The utility shall accept input.csv with the headers defined by the data contract.
- Before calculation, the utility shall detect missing columns, type errors, empty mandatory values and illogical dates or ranges.
- The utility shall deterministically perform “PET/CT Attenuation-Correction Map Integrity Check”.
- Limits and rules shall be loaded from an approved profile or explicitly fixed in the validated version.
- Each record shall receive a clear final status: PASS, WARNING or FAIL, with the reason.
- The result shall retain source values, derived values, applied limits and individual check statuses.
- Invalid input shall not return a successful result. The output supports qualified review under an approved procedure.
FS — Functional Specification
- Run PETACMapIntegrityChecker.exe in demonstration mode or with input.csv output.json arguments.
- Read UTF-8 CSV and map columns to the data contract.
- Convert values to the expected types and validate mandatory fields.
- Perform calculations and rule checks for “PET/CT Attenuation-Correction Map Integrity Check”.
- Create individual checks and derive the overall status from the worst result.
- Write machine-readable output.json; populate errors when a valid calculation cannot be produced.
input.csv example
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
Minimum output.json structure
{
"utility": "PETACMapIntegrityChecker",
"source": "input.csv",
"status": "PASS|WARNING|FAIL",
"derivedValues": {},
"checks": [
{
"parameter": "example",
"value": 0,
"limit": "configured profile",
"status": "PASS",
"message": "criterion satisfied"
}
],
"errors": []
}
Minimum OQ scenarios
- A row within the approved profile shall return PASS.
- A non-critical limit violation shall return WARNING or a review status.
- A critical violation shall return FAIL or the applicable operational decision.
- A missing column, invalid type or impossible date shall populate errors and shall not return PASS.
Before operational use
- Reconcile formulas and limits with manufacturer documentation and the approved SOP.
- Fix the scanner model, software version and profile version.
- After an executable, formula or profile change, repeat affected tests.
- Retain the source CSV and JSON result together.
Included in packages
PET Scanner State QC Suite
14 utilities for PET/PET-CT scanner state control: Ge-68/Ga-68 source activity, blank sinogram, detector efficiency, normalization acquisition and factor distribution, normalization-file assignment, trending, energy window, TOF, attenuation-correction map, PET/CT cross-calibration and the daily operational decision.
OpenRPH organ/system: bone and musculoskeletal
Bone scintigraphy, MDP/PYP, marrow, bone-pain palliation, skeletal metastases and radiosynovectomy.
OpenRPH use case: PET scanner state, gamma camera and radiation physics
The linked medical-device/radiation-physics layer: PET detector QC, normalization, AC map, cross-calibration, TOF, gamma-camera uniformity, source strength and staff dose.
OpenRPH workflow: imaging QC and quantitative interpretation
Acquisition, uptake, clearance, perfusion, transit, ejection fraction, segmentation and quantitative imaging.
OpenRPH workflow: instruments, devices and radiation safety
PET/gamma-camera state, calibration, detector QC, energy window, TOF, shielding and radiation safety.
Open