PETSourceStrengthLogger
PET Source Strength Logger
PET QC Source Activity Log
Links the source, certificate, phantom and PET scanner and compares measured activity with expected activity.
- certificate and phantom-geometry record;
- expected-activity calculation;
- measured deviation and ScannerID linkage.
The utility provides a calculation log; certificate status and source suitability are confirmed by controlled site records.
input.csv
SourceID,ScannerID,Radionuclide,CertificateNumber,PhantomGeometry,ReferenceActivityMBq,ReferenceDate,MeasuredActivityMBq,MeasurementDate,HalfLifeHours GE68-PHANTOM-001,PET-SIEMENS-01,Ge-68,CERT-2024-889,Uniform_Cylinder,150.0,2025-01-15,118.5,2026-07-22,6502.8 GA68-SOURCE-02,PET-GE-02,Ga-68,CERT-2026-101,Line_Source,50.0,2026-07-22,48.2,2026-07-22,1.1285
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 QC Source Activity Log”.
- 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 PETSourceStrengthLogger.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 QC Source Activity Log”.
- 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
SourceID,ScannerID,Radionuclide,CertificateNumber,PhantomGeometry,ReferenceActivityMBq,ReferenceDate,MeasuredActivityMBq,MeasurementDate,HalfLifeHours GE68-PHANTOM-001,PET-SIEMENS-01,Ge-68,CERT-2024-889,Uniform_Cylinder,150.0,2025-01-15,118.5,2026-07-22,6502.8 GA68-SOURCE-02,PET-GE-02,Ga-68,CERT-2026-101,Line_Source,50.0,2026-07-22,48.2,2026-07-22,1.1285
Minimum output.json structure
{
"utility": "PETSourceStrengthLogger",
"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 isotope family: Ga/Ge
Ga-67, Ga-68 and Ge-68: generator, radiolabelling, PET/SPECT and purity workflows.
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: instruments, devices and radiation safety
PET/gamma-camera state, calibration, detector QC, energy window, TOF, shielding and radiation safety.
Open