PETSourceStrengthLogger

PET Source Strength Logger

instrumental RPH PET scanner state PET QC CSV→JSON URS & FS rule-based PET
Open selection

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

  1. Run PETSourceStrengthLogger.exe in demonstration mode or with input.csv output.json arguments.
  2. Read UTF-8 CSV and map columns to the data contract.
  3. Convert values to the expected types and validate mandatory fields.
  4. Perform calculations and rule checks for “PET QC Source Activity Log”.
  5. Create individual checks and derive the overall status from the worst result.
  6. 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.

Open

RPH isotope family: Ga/Ge

Ga-67, Ga-68 and Ge-68: generator, radiolabelling, PET/SPECT and purity workflows.

Open

RPH 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.

Open

RPH workflow: instruments, devices and radiation safety

PET/gamma-camera state, calibration, detector QC, energy window, TOF, shielding and radiation safety.

Open