Gallium68GeneratorQualityChecker
Gallium68 Generator
Gallium-68 Generator Quality Checker — ⁶⁸Ge/⁶⁸Ga generator for PET diagnostics (Ph. Eur. 2.14.1, USP <823>, EMA) ℹ️ Utility checks critical eluate parameters: germanium-68 breakthrough (calculated as % of Ga-68 activity), eluate volume, eluate pH, metallic impurities (aluminium, iron), endotoxins, sterility. ℹ️ Does not use machine learning — only mathematical calculation of breakthrough percentages and pharmacopoeial limit checks. ⚠️ CRITICAL: Ge-68 breakthrough (≤0.001%) — unacceptable due to 271-day half-life! Even 0.0011% creates chronic radiation burden to patient with each use of eluate! Usage: Gallium68GeneratorQualityChecker.exe → demo mode (console output) Gallium68GeneratorQualityChecker.exe input.csv output.json → evaluate your data Input format: BatchNumber,Ga68ActivityMBq,Ge68ActivityMBq,EluateVolumeMl,EluatePH,AluminiumPPM,IronPPM,EndotoxinsEU,SterilityTest Field explanation: • Ga68ActivityMBq — gallium-68 activity in eluate at measurement time (MBq) • Ge68ActivityMBq — germanium-68 activity in same eluate sample (MBq) • EluateVolumeMl — volume of obtained eluate (mL) • EluatePH — pH of eluate • AluminiumPPM — aluminium content (ppm) • IronPPM — iron content (ppm) • EndotoxinsEU — endotoxins (EU/vial) • SterilityTest — sterility (0=sterile, 1=contaminated) Example: Ga68-Gen-2026-001,1000.0,0.01,7.5,2.0,5.0,5.0,100.0,0 → Ge-68 breakthrough = (0.01 / 1000.0) × 100% = 0.001% (at limit) — WHY IS THIS NEEDED? ⁶⁸Ge/⁶⁸Ga generators — primary source of gallium-68 for PET diagnostics of neuroendocrine tumors and prostate cancer: • Daily production of sterile, apyrogenic eluate with Ga-68 • Used for radiolabeling peptides (DOTATATE, PSMA) in radiopharmaceutical laboratories • Generator contains Ge-68 (T½=271 days) decaying to Ga-68 (T½=68 min) ⚠️ CRITICAL: • Ge-68 breakthrough ≤0.001% — Ge-68 has 271-DAY half-life! Even 0.0011% creates SIGNIFICANT CHRONIC RADIATION BURDEN to patient with each study. Unacceptable for clinical use! • Eluate volume 5.0–10.0 mL — ensures optimal Ga-68 concentration for subsequent radiolabeling • Eluate pH 1.5–3.0 — critical for radiolabeling efficiency. Outside range — reduced labeling yield! • Aluminium ≤10 ppm — concentrations ≥10 ppm cause bone uptake artifacts on PET • Iron ≤10 ppm — affects stability and labeling efficiency • Endotoxins ≤175 EU/vial — critical for subsequent intravenous administration of radiolabeled product • Sterility — MANDATORY for eluate used in sterile product manufacturing ⚠️ Special attention: Ge-68 breakthrough measured 10 minutes after elution (when Ga-68 partially decayed, Ge-68 remains). Ge-68 and Ga-68 activity measurements MUST be performed at the SAME TIME with decay correction! Calculation: (Ge-68 Activity / Ga-68 Activity) × 100%. Generator is considered unfit if Ge-68 breakthrough exceeds limit even by 0.0001%! Control performed BEFORE EACH elution. Critical parameters: • Ge-68 breakthrough: ≤0.001% of Ga-68 activity (Ph. Eur. 2.14.1, USP <823>, EMA) • Eluate volume: 5.0–10.0 mL • Eluate pH: 1.5–3.0 • Aluminium: ≤10 ppm • Iron: ≤10 ppm • Endotoxins: ≤175 EU/vial • Sterility: no microbial growth ⚠️ Note: Utility calculates breakthrough percentage AUTOMATICALLY from measured activities. This eliminates human error in manual calculations. All activity measurements must be decay-corrected and performed on calibrated detector. Generator is considered unfit if Ge-68 breakthrough exceeds limit even by 0.0001%! Regular breakthrough control is mandatory for clinical use of generator.
input.csv
BatchNumber,Ga68ActivityMBq,Ge68ActivityMBq,EluateVolumeMl,EluatePH,AluminiumPPM,IronPPM,EndotoxinsEU,SterilityTest Ga68-Gen-2026-001,1000.0,0.01,7.5,2.0,5.0,5.0,100.0,0 Ga68-Gen-2026-002,850.0,0.015,6.0,1.8,8.0,7.0,120.0,0
URS & FS — user requirements and functional specification
This document defines user requirements and functional specification for the quality-control utility. It supports deployment discussion, IQ/OQ preparation and QC workflow integration.
1. Scope
The Gallium68 Generator Quality Checker utility is used for Gallium68 Generator. The actual input.csv is the source of truth for the input structure; control criteria are defined by the executable and the domain description.
The utility does not use machine learning; decisions are produced by deterministic rules.
Categories: Radiopharmaceuticals
Tags: decay correction, endotoxins, impurities, microbiology, PET, radionuclide purity, radiopharma, SPECT, sterility
2. Execution modes
Gallium68GeneratorQualityChecker.exe → demo mode (console output) Gallium68GeneratorQualityChecker.exe input.csv output.json → evaluate your data
3. Key controlled areas
- purity and impurities
- microbiology and pathogens
- pH and physicochemical parameters
- activity, decay and radiochemical purity
4. Domain limits and critical parameters
- ⚠️ CRITICAL: Ge-68 breakthrough (≤0.001%) — unacceptable due to 271-day half-life! Even 0.0011% creates chronic radiation burden to patient with each use of eluate!
- ⚠️ CRITICAL:
- Ge-68 breakthrough ≤0.001% — Ge-68 has 271-DAY half-life! Even 0.0011% creates SIGNIFICANT CHRONIC RADIATION BURDEN to patient with each study. Unacceptable for clinical use!
- Eluate volume 5.0–10.0 mL — ensures optimal Ga-68 concentration for subsequent radiolabeling
- Eluate pH 1.5–3.0 — critical for radiolabeling efficiency. Outside range — reduced labeling yield!
- Aluminium ≤10 ppm — concentrations ≥10 ppm cause bone uptake artifacts on PET
- Iron ≤10 ppm — affects stability and labeling efficiency
- Endotoxins ≤175 EU/vial — critical for subsequent intravenous administration of radiolabeled product
- Sterility — MANDATORY for eluate used in sterile product manufacturing
- ⚠️ Special attention: Ge-68 breakthrough measured 10 minutes after elution (when Ga-68 partially decayed, Ge-68 remains). Ge-68 and Ga-68 activity measurements MUST be performed at the SAME TIME with decay correction! Calculation: (Ge-68 Activity / Ga-68 Activity) × 100%. Generator is considered unfit if Ge-68 breakthrough exceeds limit even by 0.0001%! Control performed BEFORE EACH elution.
- Critical parameters:
- Ge-68 breakthrough: ≤0.001% of Ga-68 activity (Ph. Eur. 2.14.1, USP <823>, EMA)
- Eluate volume: 5.0–10.0 mL
- Eluate pH: 1.5–3.0
- Aluminium: ≤10 ppm
- Iron: ≤10 ppm
- Endotoxins: ≤175 EU/vial
- Sterility: no microbial growth
- ⚠️ Note: Utility calculates breakthrough percentage AUTOMATICALLY from measured activities. This eliminates human error in manual calculations. All activity measurements must be decay-corrected and performed on calibrated detector. Generator is considered unfit if Ge-68 breakthrough exceeds limit even by 0.0001%! Regular breakthrough control is mandatory for clinical use of generator.
5. URS — user requirements
| ID | Requirement | Criticality | Acceptance criterion |
|---|---|---|---|
| URS-001 | The system shall accept an input.csv file for Gallium68 Generator with the exact columns listed in the “Input data contract” section. | High | A file with the correct header is processed without manual editing; missing mandatory columns produce FAIL/import error. |
| URS-002 | The system shall support execution without arguments in demo mode and execution with input.csv output.json for user data. | Medium | Both execution scenarios produce a predictable result or clear diagnostic error. |
| URS-003 | The system shall perform rule-based controls for: purity and impurities, microbiology and pathogens, pH and physicochemical parameters, activity, decay and radiochemical purity. | High | Each controlled parameter receives a status and message; the result does not depend on hidden Excel formulas or ML. |
| URS-004 | The system shall preserve traceability between batch/lot, source values, applied rules and final verdict. | High | Output includes batch identifier, source values, parameter statuses and critical findings. |
| URS-005 | The system shall generate machine-readable output.json for LIMS/ELN/MES, batch record and QA/QC review. | High | JSON contains overall status, check array, warnings, failures and source-file reference. |
| URS-006 | The system shall support use in the client validation package: URS/FS, IQ/OQ preparation, installation and operational scenario checks. | High | The document, test scenarios and reproducible CSV/JSON flow are suitable for audit and internal approval. |
| URS-007 | The system shall clearly separate technical data errors from specification nonconformities. | Medium | Schema/type errors are not mixed with pharmacopoeial deviations and are reported separately. |
6. input.csv data contract
The source of truth for the input schema is the actual input.csv header. Column names are technical identifiers and are not translated.
| # | Column | Type | Unit | Description | Sample | Control rule |
|---|---|---|---|---|---|---|
| 1 | BatchNumber | identifier | as specified | Batch Number | Ga68-Gen-2026-001 | mandatory field; used for batch/lot traceability |
| 2 | Ga68ActivityMBq | decimal | MBq | Ga68 Activity MBq | 1000.0 | mandatory numeric value; rule comparison is performed by the utility |
| 3 | Ge68ActivityMBq | decimal | MBq | Ge68 Activity MBq | 0.01 | mandatory numeric value; rule comparison is performed by the utility |
| 4 | EluateVolumeMl | decimal | as specified | Eluate Volume Ml | 7.5 | mandatory numeric value; rule comparison is performed by the utility |
| 5 | EluatePH | decimal | as specified | Eluate PH | 2.0 | mandatory numeric value; rule comparison is performed by the utility |
| 6 | AluminiumPPM | decimal | ppm | Aluminium PPM | 5.0 | mandatory numeric value; rule comparison is performed by the utility |
| 7 | IronPPM | decimal | ppm | Iron PPM | 5.0 | mandatory numeric value; rule comparison is performed by the utility |
| 8 | EndotoxinsEU | decimal | as specified | Endotoxins EU | 100.0 | numeric value; critical safety attribute compared with endotoxin limit |
| 9 | SterilityTest | boolean / flag | 0/1 | Sterility Test | 0 | valid flag required; prohibited organisms and growth are normally expected as 0 / absent |
CSV example
BatchNumber,Ga68ActivityMBq,Ge68ActivityMBq,EluateVolumeMl,EluatePH,AluminiumPPM,IronPPM,EndotoxinsEU,SterilityTest Ga68-Gen-2026-001,1000.0,0.01,7.5,2.0,5.0,5.0,100.0,0
7. FS — functional specification
| ID | Function | Implementation description |
|---|---|---|
| FS-001 | CLI entry point | The executable Gallium68GeneratorQualityChecker.exe supports demo mode and input.csv output.json processing mode. |
| FS-002 | CSV parser | The import module reads CSV, validates header, column presence/order, value count and encoding. Decimal values are expected with a dot separator. |
| FS-003 | Field conversion | Each column is converted to the expected type: identifier, text, decimal number, date/time or boolean flag. |
| FS-004 | Domain rule engine | For Gallium68 Generator, explicit rules are applied: range, minimum, maximum, absence of prohibited flag, data completeness or calculation-based check. |
| FS-005 | Criticality handling | Critical violations produce FAIL; non-critical deviations and incomplete data produce WARNING; full conformance produces PASS. |
| FS-006 | JSON writer | output.json stores overall status, per-parameter results, source values, warnings, failures and diagnostic messages. |
| FS-007 | Integration contract | The CSV → JSON format is stable for invocation from LIMS/ELN/MES, scheduled task or wrapper service. |
| FS-008 | Error handling | Schema error, missing file, non-numeric value or JSON write failure returns diagnosable error without silent PASS. |
8. output.json contract
The output file must be suitable for automated processing, audit review and correlation with the source input.csv row.
{
"utility": "Gallium68GeneratorQualityChecker",
"api": "Gallium68 Generator",
"batchNumber": "Ga68-Gen-2026-001",
"overallStatus": "PASS|WARNING|FAIL",
"checkedAtUtc": "2026-05-18T00:00:00Z",
"checks": [
{
"parameter": "BatchNumber",
"value": "Ga68-Gen-2026-001",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Ga68ActivityMBq",
"value": "1000.0",
"unit": "MBq",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Ge68ActivityMBq",
"value": "0.01",
"unit": "MBq",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "EluateVolumeMl",
"value": "7.5",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "EluatePH",
"value": "2.0",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "AluminiumPPM",
"value": "5.0",
"unit": "ppm",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "IronPPM",
"value": "5.0",
"unit": "ppm",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "EndotoxinsEU",
"value": "100.0",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
}
],
"criticalFindings": [],
"sourceFile": "input.csv"
}9. OQ/PQ test scenarios
| ID | Scenario | Expected result |
|---|---|---|
| TC-001 | Valid CSV with expected header and sample row | All rows are processed; output contains PASS/WARNING/FAIL and parameter-level detail. |
| TC-002 | A mandatory input.csv column is missing | Import is rejected or the row receives FAIL with schema reference. |
| TC-003 | A numeric field contains text or a blank value | Type conversion error is recorded; the result is not hidden as PASS. |
| TC-004 | A parameter is outside specification or critical limit | Critical parameters produce FAIL; non-critical deviations produce WARNING according to the rule. |
| TC-005 | Positive pathogen/microbiological flag or microbiological limit excursion | Critical FAIL is produced with the offending parameter. |
| TC-008 | Incorrect activity, reference time or radiochemical purity | FAIL/WARNING is produced with calculation traceability. |
10. QA/QC, CSV and change control
- Before production use, the client records executable version, checksum, specification/monograph version, test CSV, expected JSON and IQ/OQ results.
- Column names must not be changed without updating the validator and test scenarios.
- The source CSV, output.json and utility version should be stored together as an evidence package.
- Any change in control rules must go through change control and repeated OQ scenario verification.
Included in packages
Andrology QC Suite
QC package for andrology: androgens, erectile-dysfunction medicines, BPH/prostate products, fertility and related hormonal checks.
OpenEndocrinology QC Suite
QC package for endocrinology: thyroid, pituitary/peptide hormones, corticosteroids, sex hormones and selected metabolic medicines.
OpenNeurology QC Suite
QC package for neurology and neuropsychiatry: antiepileptics, antiparkinsonian medicines, antidepressants, antipsychotics, analgesics and neurological diagnostic radiopharmaceuticals.
OpenPetRad QC Suite
A specialised utility package for radiopharmaceutical quality control: PET, SPECT, therapeutic radionuclides, generators and decay calculations.
OpenRadiology QC Suite
QC package for radiology and diagnostic imaging: radiopharmaceuticals, PET/SPECT, contrast media, iodinated and gadolinium products, plus particle, sterility and endotoxin checks.
OpenRPH isotope family: Ga/Ge
Ga-67, Ga-68 and Ge-68: generator, radiolabelling, PET/SPECT and purity workflows.
OpenRPH organ/system: bone and musculoskeletal
Bone scintigraphy, MDP/PYP, marrow, bone-pain palliation, skeletal metastases and radiosynovectomy.
OpenRPH organ/system: brain and CNS
Brain perfusion, dopamine transporter, amyloid/tau, receptor imaging and neurological SPECT/PET.
OpenRPH organ/system: endocrine, thyroid and NET
Radioiodine, thyroid/parathyroid, somatostatin receptor, MIBG and neuroendocrine workflows.
OpenRPH organ/system: oncology and theranostics
Tumour imaging, PSMA/FAPI/receptor tracers, immuno-PET, targeted radionuclide therapy and radioembolization.
OpenRPH use case: PET/SPECT oncology diagnostics and receptor imaging
F-18, Ga-68, Cu-64, Zr-89, In-111 and other diagnostic tracers: synthesis, purity, receptor targeting, immuno-PET and generator-based workflows.
OpenRPH workflow: generators and isotope purity
Generator eluate, breakthrough, radionuclidic purity, isotope mix and starting radionuclides.
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.
OpenRPH workflow: product release QC
Assay, purity, sterility, endotoxins, pH, impurities, appearance and batch-release checks.
OpenRPH workflow: stability, storage, decay and waste
Kinetic stability, shelf life, decay correction, expiry, storage, trend and radioactive waste.
OpenRPH workflow: synthesis, labelling and kit reconstitution
Radiolabelling, synthesis, chelation, reducing agent, pH/stoichiometry and kit preparation.
OpenRPH: combined radiopharmaceutical QC package
RPH combines PetRad, PetRad2 and PetRad3 into one umbrella package for PET/SPECT, therapeutic radionuclides, generators, labelled compounds, decay calculations, sterility, endotoxins and radiochemical/radionuclidic purity.
OpenUrology QC Suite
QC package for urology: BPH, urolithiasis, overactive bladder, urinary-tract infection medicines and supporting antimicrobial QC checks.
Open