DecayCorrectorExForGeGa

Decay Corrector Ex for Ge-68/Ga-68

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

Ge-68 and Ga-68 Source Decay Correction

Calculates expected source activity on the check date and compares it with the measured value.

  • activity calculation from half-life and dates;
  • measured-to-expected activity deviation;
  • minimum residual activity check for the selected procedure.

Half-life and acceptance limits shall come from the approved source profile or SOP.

input.csv

SourceID,Radionuclide,InitialActivityMBq,CalibrationDate,CheckDate,MeasuredActivityMBq,HalfLifeHours
GE68-PHANTOM-001,Ge-68,100.0,2025-01-01,2026-07-22,78.5,6502.8
GA68-SOURCE-002,Ga-68,50.0,2026-07-22,2026-07-22,48.0,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 “Ge-68 and Ga-68 Source Decay Correction”.
  • 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 DecayCorrectorExForGeGa.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 “Ge-68 and Ga-68 Source Decay Correction”.
  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,Radionuclide,InitialActivityMBq,CalibrationDate,CheckDate,MeasuredActivityMBq,HalfLifeHours
GE68-PHANTOM-001,Ge-68,100.0,2025-01-01,2026-07-22,78.5,6502.8
GA68-SOURCE-002,Ga-68,50.0,2026-07-22,2026-07-22,48.0,1.1285

Minimum output.json structure

{
  "utility": "DecayCorrectorExForGeGa",
  "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

RPH workflow: stability, storage, decay and waste

Kinetic stability, shelf life, decay correction, expiry, storage, trend and radioactive waste.

Open