Terbium155QualityChecker

Terbium-155

radiopharmaceuticals QC URS & FS input.csv output.json alpha therapy PET SPECT
Open selection

Utility description: Terbium-155

Terbium-155 Quality Checker — SPECT Diagnostics (Ph. Eur., USP)

ℹ️  The utility checks RCP, other Tb isotopes, free terbium, specific activity.
ℹ️  Does not use machine learning — rule-based logic only.
⚠️  CRITICAL! Other Tb isotopes ≤1.0%. Free Tb ≤5%. SA ≥50 MBq/nmol!

Usage:
  Terbium155QualityChecker.exe                            → demo mode
  Terbium155QualityChecker.exe input.csv output.json      → evaluate data

Input format:
BatchNumber,Radiopharmaceutical,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_nmol,Other_Tb_Isotopes_Percent,Free_Terbium_Ion_Percent,Target_Material_Residue_ppm,pH_Value,Ethanol_Content_Percent,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected

Example:
TB155-DOTA-2026-001,Tb-155-DOTATATE,99.9,98.5,120.0,0.05,1.0,2.0,6.5,5.0,0,5.0,0,0,0,0,0

— WHY IS THIS NEEDED?
Terbium-155 — gamma emitter for SPECT diagnostics (T1/2 = 5.32 d):
• Other Tb Isotopes: Accelerator production may yield Tb-149 (alpha), Tb-152 (PET), Tb-156 (beta). Their presence creates unnecessary dose and image background. Limit is strict (≤1.0%).
• Radiochemical Purity: Free Tb³⁺ ion accumulates in bones and liver, creating background on SPECT images and increasing dose. RCP must be ≥95%.
• Specific Activity: Must be high (≥50 MBq/nmol) for high-quality SPECT images with high contrast.
• Theranostics: Tb-155 is used for planning therapy with Tb-149 or Tb-161, so its biodistribution must be identical.
⚠️ CRITICAL:
• Radionuclidic Purity: ≥ 99.0%
• Radiochemical Purity: ≥ 95.0%
• Other Tb Isotopes: ≤ 1.0%
• Free Terbium: ≤ 5.0%
• Specific Activity: ≥ 50 MBq/nmol
• pH: 4.5–7.5
• Endotoxins: ≤ 17.5 EU/mL
• Sterility: No growth
• Appearance: Clear, particle-free
⚠️ Note: Utility focuses on specific accelerator-produced impurities of Tb-155 and free ion control, which is critical for SPECT image quality and patient safety.

input.csv

BatchNumber,Radiopharmaceutical,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_nmol,Other_Tb_Isotopes_Percent,Free_Terbium_Ion_Percent,Target_Material_Residue_ppm,pH_Value,Ethanol_Content_Percent,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected
TB155-DOTA-2026-001,Tb-155-DOTATATE,99.9,98.5,120.0,0.05,1.0,2.0,6.5,5.0,0,5.0,0,0,0,0,0

URS & FS — User Requirements and Functional Specification

1. Scope

This document defines requirements and functional behaviour for Terbium155QualityChecker used to control: Terbium-155. The utility is intended for QC use and applies deterministic rules, not machine learning.

2. Execution modes

  • Terbium155QualityChecker.exe — demo mode or help output.
  • Terbium155QualityChecker.exe input.csv output.json — process user data and write result.

3. Key source-derived controls

  • Terbium-155 Quality Checker — SPECT Diagnostics (Ph. Eur., USP)
  • ⚠️ CRITICAL! Other Tb isotopes ≤1.0%. Free Tb ≤5%. SA ≥50 MBq/nmol!
  • BatchNumber,Radiopharmaceutical,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_nmol,Other_Tb_Isotopes_Percent,Free_Terbium_Ion_Percent,Target_Material_Residue_ppm,pH_Value,Ethanol_Content_Percent,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected
  • • Other Tb Isotopes: Accelerator production may yield Tb-149 (alpha), Tb-152 (PET), Tb-156 (beta). Their presence creates unnecessary dose and image background. Limit is strict (≤1.0%).
  • • Radiochemical Purity: Free Tb³⁺ ion accumulates in bones and liver, creating background on SPECT images and increasing dose. RCP must be ≥95%.
  • • Specific Activity: Must be high (≥50 MBq/nmol) for high-quality SPECT images with high contrast.
  • ⚠️ CRITICAL:
  • • Radionuclidic Purity: ≥ 99.0%
  • • Radiochemical Purity: ≥ 95.0%
  • • Other Tb Isotopes: ≤ 1.0%
  • • Free Terbium: ≤ 5.0%
  • • Specific Activity: ≥ 50 MBq/nmol
  • • pH: 4.5–7.5
  • • Endotoxins: ≤ 17.5 EU/mL
  • • Sterility: No growth
  • ⚠️ Note: Utility focuses on specific accelerator-produced impurities of Tb-155 and free ion control, which is critical for SPECT image quality and patient safety.

4. URS — user requirements

IDRequirementCriticalityAcceptance criterion
URS-001The utility shall accept input.csv with the exact headers defined in the data contract.HighThe file is processed without manual header changes.
URS-002The utility shall validate mandatory fields, data types, ranges, units, and critical pharmaceutical/radiochemical limits.HighEach row receives PASS/WARNING/FAIL status.
URS-003The utility shall detect critical deviations related to radionuclidic/radiochemical purity, impurities, free radionuclide, pH, endotoxins and sterility where such fields are present.HighA critical deviation produces FAIL or an explicit critical finding.
URS-004The utility shall generate output.json with machine-readable results, source values, warnings and failures.HighJSON is suitable for LIMS/ELN/MES integration and QA/QC review.
URS-005The utility shall not use machine learning to decide conformance.MediumThe decision is based on explicit rules and thresholds.
URS-006The utility shall preserve traceability between batch number, input values, applied rules and final status.HighThe output contains batch identifier and checked parameters.
URS-007The documentation shall support IQ/OQ preparation and inspection discussion with FDA/EMA/Roszdravnadzor or local regulator.MediumURS/FS and test scenarios are supplied with the utility.

5. input.csv contract

#FieldTypeSamplePurpose
1BatchNumberstringTB155-DOTA-2026-001Batch or lot identifier.
2RadiopharmaceuticalstringTb-155-DOTATATEProduct/radiopharmaceutical type; affects control interpretation.
3Radionuclidic_Purity_Percentdecimal99.9Radionuclidic purity; critical radiation safety attribute.
4Radiochemical_Purity_Percentdecimal98.5Radiochemical purity; verifies radionuclide binding and target chemical form.
5Specific_Activity_MBq_nmoldecimal120.0Activity of the radiopharmaceutical material or finished product.
6Other_Tb_Isotopes_Percentdecimal0.05Controlled input parameter from input.csv.
7Free_Terbium_Ion_Percentdecimal1.0Free radionuclide/ion; critical due to non-target uptake and toxicity.
8Target_Material_Residue_ppmdecimal2.0Controlled input parameter from input.csv.
9pH_Valuedecimal6.5Solution pH; stability and administration compatibility parameter.
10Ethanol_Content_Percentdecimal5.0Controlled input parameter from input.csv.
11SterilityTestflag 0/10Sterility test result; 0 usually means no contamination.
12Bacterial_Endotoxins_EU_per_mLdecimal5.0Bacterial endotoxins; critical criterion for parenteral administration.
13Appearance_Scoredecimal0Visual appearance and visible defect assessment.
14Microbial_Count_TAMCdecimal0Microbiological attribute; positive result is a critical deviation.
15Microbial_Count_TYMCdecimal0Microbiological attribute; positive result is a critical deviation.
16EColi_Detectedflag 0/10Microbiological attribute; positive result is a critical deviation.
17Salmonella_Detectedflag 0/10Microbiological attribute; positive result is a critical deviation.
BatchNumber,Radiopharmaceutical,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_nmol,Other_Tb_Isotopes_Percent,Free_Terbium_Ion_Percent,Target_Material_Residue_ppm,pH_Value,Ethanol_Content_Percent,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected
TB155-DOTA-2026-001,Tb-155-DOTATATE,99.9,98.5,120.0,0.05,1.0,2.0,6.5,5.0,0,5.0,0,0,0,0,0

6. FS — functional specification

IDFunctionImplementation
FS-001CSV importRead input.csv in UTF-8/CSV-compatible format; validate header and expected columns.
FS-002Schema validationValidate mandatory fields and column count; report unknown or missing key fields.
FS-003Type conversionConvert numeric, flag and text values; record invalid format as row-level error.
FS-004Rule engineApply domain rules for Terbium-155, including critical limits from the utility description.
FS-005Status aggregationGenerate final status: FAIL for critical failure, WARNING for non-critical deviation, PASS for conformance.
FS-006JSON exportWrite output.json with check details, source values, warnings and critical findings.
FS-007Audit supportKeep result structure suitable for review, deviation investigation and IQ/OQ preparation.

7. output.json example

{
  "utilityId": "terbium155-quality-checker",
  "api": "Terbium-155",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "TB155-DOTA-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Radiopharmaceutical",
      "value": "Tb-155-DOTATATE",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Radionuclidic_Purity_Percent",
      "value": "99.9",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Radiochemical_Purity_Percent",
      "value": "98.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Specific_Activity_MBq_nmol",
      "value": "120.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Other_Tb_Isotopes_Percent",
      "value": "0.05",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Free_Terbium_Ion_Percent",
      "value": "1.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Target_Material_Residue_ppm",
      "value": "2.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    }
  ],
  "criticalFindings": []
}

8. OQ/PQ test scenarios

IDScenarioExpected result
OQ-001Valid sample rowPASS or acceptable WARNING according to rules.
OQ-002Mandatory column is missingSchema error or FAIL.
OQ-003Non-numeric value in numeric fieldType conversion error.
OQ-004Critical parameter outside limitFAIL and critical finding.
PQ-001User real batch/lotApproved review result with input.csv and output.json retained.

9. QA/QC and change control

  • Do not rename columns without validator update.
  • Store input.csv, output.json, executable version and checksum.
  • Before production use perform IQ/OQ/PQ or equivalent CSV/CSA verification.
  • Critical radiopharmaceutical limits must be checked against the approved specification and local SOPs.

Included in packages

PetRad2: advanced radiopharmaceutical QC package

A curated set of new utilities for radionuclide control, targeted alpha therapy, specific activity, radiolysis stability and preliminary dosimetry calculations.

Open

Radiology QC Suite

QC package for radiology and diagnostic imaging: radiopharmaceuticals, PET/SPECT, contrast media, iodinated and gadolinium products, plus particle, sterility and endotoxin checks.

Open

RPH organ/system: bone and musculoskeletal

Bone scintigraphy, MDP/PYP, marrow, bone-pain palliation, skeletal metastases and radiosynovectomy.

Open

RPH organ/system: endocrine, thyroid and NET

Radioiodine, thyroid/parathyroid, somatostatin receptor, MIBG and neuroendocrine workflows.

Open

RPH organ/system: hepatobiliary and GI

HIDA, mebrofenin, gallbladder, gastric emptying, GI transit, bleeding and liver/spleen imaging.

Open

RPH organ/system: oncology and theranostics

Tumour imaging, PSMA/FAPI/receptor tracers, immuno-PET, targeted radionuclide therapy and radioembolization.

Open

RPH use case: radionuclide therapy and theranostics

Lu-177, Ac-225, Ra-223, Y-90, Ho-166, Sm-153, Sr-89, Re-188, Tb-161, I-131 and other therapeutic radiopharmaceuticals: activity, purity, free metal, daughters and toxicological constraints.

Open

RPH workflow: generators and isotope purity

Generator eluate, breakthrough, radionuclidic purity, isotope mix and starting radionuclides.

Open

RPH workflow: product release QC

Assay, purity, sterility, endotoxins, pH, impurities, appearance and batch-release checks.

Open

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

Open