Terbium149QualityChecker

Terbium-149

radiopharmaceuticals QC URS & FS input.csv output.json alpha therapy radiochemical purity radionuclidic purity
Open selection

Utility description: Terbium-149

Terbium-149 Quality Checker — Alpha Theranostics (Ph. Eur., USP)

ℹ️  The utility checks RCP, long-lived impurities (Tb-155/156), free terbium, specific activity.
ℹ️  Does not use machine learning — rule-based logic only.
⚠️  CRITICAL! Tb-155/156 impurities ≤1.0%. Free Tb ≤5%. SA ≥100 MBq/nmol!

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

Input format:
BatchNumber,Radiopharmaceutical,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_nmol,Long_Lived_Tb_Impurities_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:
TB149-DOTA-2026-001,Tb-149-DOTATATE,99.5,98.0,200.0,0.4,1.5,5.0,6.5,5.0,0,5.0,0,0,0,0,0

— WHY IS THIS NEEDED?
Terbium-149 — unique alpha-emitter for theranostics (T1/2 = 4.1 h):
• Long-Lived Impurities: Accelerator production often yields Tb-155 and Tb-156 (T1/2 ~5.3 days). Their presence increases patient dose without therapeutic benefit. Limit is strict (≤1.0%).
• Radiochemical Purity: Free Tb³⁺ ion accumulates in bones and liver. For alpha therapy, this is critical due to high LET. RCP must be ≥95%.
• Specific Activity: Must be high (≥100 MBq/nmol) for efficient receptor saturation with low mass.
• Short Half-life: Requires rapid logistics and synthesis.
⚠️ CRITICAL:
• Radionuclidic Purity: ≥ 99.0%
• Radiochemical Purity: ≥ 95.0%
• Long-Lived Impurities (Tb-155/156): ≤ 1.0%
• Free Terbium: ≤ 5.0%
• Specific Activity: ≥ 100 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-149 and free ion control, which is critical for alpha therapy safety.

input.csv

BatchNumber,Radiopharmaceutical,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_nmol,Long_Lived_Tb_Impurities_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
TB149-DOTA-2026-001,Tb-149-DOTATATE,99.5,98.0,200.0,0.4,1.5,5.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 Terbium149QualityChecker used to control: Terbium-149. The utility is intended for QC use and applies deterministic rules, not machine learning.

2. Execution modes

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

3. Key source-derived controls

  • Terbium-149 Quality Checker — Alpha Theranostics (Ph. Eur., USP)
  • ⚠️ CRITICAL! Tb-155/156 impurities ≤1.0%. Free Tb ≤5%. SA ≥100 MBq/nmol!
  • BatchNumber,Radiopharmaceutical,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_nmol,Long_Lived_Tb_Impurities_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
  • Terbium-149 — unique alpha-emitter for theranostics (T1/2 = 4.1 h):
  • • Long-Lived Impurities: Accelerator production often yields Tb-155 and Tb-156 (T1/2 ~5.3 days). Their presence increases patient dose without therapeutic benefit. Limit is strict (≤1.0%).
  • • Radiochemical Purity: Free Tb³⁺ ion accumulates in bones and liver. For alpha therapy, this is critical due to high LET. RCP must be ≥95%.
  • • Specific Activity: Must be high (≥100 MBq/nmol) for efficient receptor saturation with low mass.
  • ⚠️ CRITICAL:
  • • Radionuclidic Purity: ≥ 99.0%
  • • Radiochemical Purity: ≥ 95.0%
  • • Long-Lived Impurities (Tb-155/156): ≤ 1.0%
  • • Free Terbium: ≤ 5.0%
  • • Specific Activity: ≥ 100 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-149 and free ion control, which is critical for alpha therapy 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
1BatchNumberstringTB149-DOTA-2026-001Batch or lot identifier.
2RadiopharmaceuticalstringTb-149-DOTATATEProduct/radiopharmaceutical type; affects control interpretation.
3Radionuclidic_Purity_Percentdecimal99.5Radionuclidic purity; critical radiation safety attribute.
4Radiochemical_Purity_Percentdecimal98.0Radiochemical purity; verifies radionuclide binding and target chemical form.
5Specific_Activity_MBq_nmoldecimal200.0Activity of the radiopharmaceutical material or finished product.
6Long_Lived_Tb_Impurities_Percentdecimal0.4Controlled input parameter from input.csv.
7Free_Terbium_Ion_Percentdecimal1.5Free radionuclide/ion; critical due to non-target uptake and toxicity.
8Target_Material_Residue_ppmdecimal5.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,Long_Lived_Tb_Impurities_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
TB149-DOTA-2026-001,Tb-149-DOTATATE,99.5,98.0,200.0,0.4,1.5,5.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-149, 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": "terbium149-quality-checker",
  "api": "Terbium-149",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "TB149-DOTA-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Radiopharmaceutical",
      "value": "Tb-149-DOTATATE",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Radionuclidic_Purity_Percent",
      "value": "99.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Radiochemical_Purity_Percent",
      "value": "98.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Specific_Activity_MBq_nmol",
      "value": "200.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Long_Lived_Tb_Impurities_Percent",
      "value": "0.4",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Free_Terbium_Ion_Percent",
      "value": "1.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Target_Material_Residue_ppm",
      "value": "5.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 workflow: synthesis, labelling and kit reconstitution

Radiolabelling, synthesis, chelation, reducing agent, pH/stoichiometry and kit preparation.

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