Terbium149QualityChecker
Terbium-149
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
| ID | Requirement | Criticality | Acceptance criterion |
|---|---|---|---|
| URS-001 | The utility shall accept input.csv with the exact headers defined in the data contract. | High | The file is processed without manual header changes. |
| URS-002 | The utility shall validate mandatory fields, data types, ranges, units, and critical pharmaceutical/radiochemical limits. | High | Each row receives PASS/WARNING/FAIL status. |
| URS-003 | The utility shall detect critical deviations related to radionuclidic/radiochemical purity, impurities, free radionuclide, pH, endotoxins and sterility where such fields are present. | High | A critical deviation produces FAIL or an explicit critical finding. |
| URS-004 | The utility shall generate output.json with machine-readable results, source values, warnings and failures. | High | JSON is suitable for LIMS/ELN/MES integration and QA/QC review. |
| URS-005 | The utility shall not use machine learning to decide conformance. | Medium | The decision is based on explicit rules and thresholds. |
| URS-006 | The utility shall preserve traceability between batch number, input values, applied rules and final status. | High | The output contains batch identifier and checked parameters. |
| URS-007 | The documentation shall support IQ/OQ preparation and inspection discussion with FDA/EMA/Roszdravnadzor or local regulator. | Medium | URS/FS and test scenarios are supplied with the utility. |
5. input.csv contract
| # | Field | Type | Sample | Purpose |
|---|---|---|---|---|
| 1 | BatchNumber | string | TB149-DOTA-2026-001 | Batch or lot identifier. |
| 2 | Radiopharmaceutical | string | Tb-149-DOTATATE | Product/radiopharmaceutical type; affects control interpretation. |
| 3 | Radionuclidic_Purity_Percent | decimal | 99.5 | Radionuclidic purity; critical radiation safety attribute. |
| 4 | Radiochemical_Purity_Percent | decimal | 98.0 | Radiochemical purity; verifies radionuclide binding and target chemical form. |
| 5 | Specific_Activity_MBq_nmol | decimal | 200.0 | Activity of the radiopharmaceutical material or finished product. |
| 6 | Long_Lived_Tb_Impurities_Percent | decimal | 0.4 | Controlled input parameter from input.csv. |
| 7 | Free_Terbium_Ion_Percent | decimal | 1.5 | Free radionuclide/ion; critical due to non-target uptake and toxicity. |
| 8 | Target_Material_Residue_ppm | decimal | 5.0 | Controlled input parameter from input.csv. |
| 9 | pH_Value | decimal | 6.5 | Solution pH; stability and administration compatibility parameter. |
| 10 | Ethanol_Content_Percent | decimal | 5.0 | Controlled input parameter from input.csv. |
| 11 | SterilityTest | flag 0/1 | 0 | Sterility test result; 0 usually means no contamination. |
| 12 | Bacterial_Endotoxins_EU_per_mL | decimal | 5.0 | Bacterial endotoxins; critical criterion for parenteral administration. |
| 13 | Appearance_Score | decimal | 0 | Visual appearance and visible defect assessment. |
| 14 | Microbial_Count_TAMC | decimal | 0 | Microbiological attribute; positive result is a critical deviation. |
| 15 | Microbial_Count_TYMC | decimal | 0 | Microbiological attribute; positive result is a critical deviation. |
| 16 | EColi_Detected | flag 0/1 | 0 | Microbiological attribute; positive result is a critical deviation. |
| 17 | Salmonella_Detected | flag 0/1 | 0 | Microbiological 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
| ID | Function | Implementation |
|---|---|---|
| FS-001 | CSV import | Read input.csv in UTF-8/CSV-compatible format; validate header and expected columns. |
| FS-002 | Schema validation | Validate mandatory fields and column count; report unknown or missing key fields. |
| FS-003 | Type conversion | Convert numeric, flag and text values; record invalid format as row-level error. |
| FS-004 | Rule engine | Apply domain rules for Terbium-149, including critical limits from the utility description. |
| FS-005 | Status aggregation | Generate final status: FAIL for critical failure, WARNING for non-critical deviation, PASS for conformance. |
| FS-006 | JSON export | Write output.json with check details, source values, warnings and critical findings. |
| FS-007 | Audit support | Keep 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
| ID | Scenario | Expected result |
|---|---|---|
| OQ-001 | Valid sample row | PASS or acceptable WARNING according to rules. |
| OQ-002 | Mandatory column is missing | Schema error or FAIL. |
| OQ-003 | Non-numeric value in numeric field | Type conversion error. |
| OQ-004 | Critical parameter outside limit | FAIL and critical finding. |
| PQ-001 | User real batch/lot | Approved 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.
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 organ/system: bone and musculoskeletal
Bone scintigraphy, MDP/PYP, marrow, bone-pain palliation, skeletal metastases and radiosynovectomy.
OpenRPH organ/system: endocrine, thyroid and NET
Radioiodine, thyroid/parathyroid, somatostatin receptor, MIBG and neuroendocrine workflows.
OpenRPH organ/system: hepatobiliary and GI
HIDA, mebrofenin, gallbladder, gastric emptying, GI transit, bleeding and liver/spleen imaging.
OpenRPH organ/system: oncology and theranostics
Tumour imaging, PSMA/FAPI/receptor tracers, immuno-PET, targeted radionuclide therapy and radioembolization.
OpenRPH 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.
OpenRPH workflow: generators and isotope purity
Generator eluate, breakthrough, radionuclidic purity, isotope mix and starting radionuclides.
OpenRPH workflow: product release QC
Assay, purity, sterility, endotoxins, pH, impurities, appearance and batch-release checks.
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.
Open