Holmium166QualityChecker

Holmium-166

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

Utility description: Holmium-166

Holmium-166 Quality Checker — Radiopharmaceutical (SIRT/Therapy) (Ph. Eur., USP)

ℹ️  The utility checks particle size, RCP, free ions, sterility, endotoxins.
ℹ️  Does not use machine learning — rule-based logic only.
⚠️  CRITICAL! Particle size 20-50 um. Free ions ≤5%. Endotoxins ≤20 EU/mL!

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

Input format:
BatchNumber,Formulation_Type,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_mg,Particle_Size_Mean_um,Particle_Size_Min_um,Particle_Size_Max_um,Particles_Out_of_Range_Percent,Free_Holmium_Ion_Percent,Target_Material_Residue_ppm,pH_Value,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected

Example:
HO166-MS-2026-001,Microspheres,99.9,98.5,1500.0,35.0,20.0,50.0,2.0,1.0,5.0,6.5,0,10.0,0,0,0,0,0

— WHY IS THIS NEEDED?
Holmium-166 — beta/gamma-emitter for therapy (Liver SIRT):
• Particle Size: For microspheres, the 20–50 um range is critical. Particles <20 um may shunt to lungs causing radiation pneumonitis. Particles >50 um may occlude large vessels.
• Radiochemical Purity: Free $^{166}\text{Ho}^{3+}$ is osteotropic (accumulates in bones), leading to bone marrow toxicity. RCP must be ≥95%.
• Specific Activity: Must be high to ensure therapeutic dose in small volume.
• Sterility and Endotoxins: Drug is administered intra-arterially. Requirements are strict.
• Imaging: Gamma emission allows post-administration distribution control.
⚠️ CRITICAL:
• Radionuclidic Purity: ≥ 99.0%
• Radiochemical Purity: ≥ 95.0%
• Free Holmium Ions: ≤ 5.0%
• Mean Particle Size: 20–50 um
• Particles Out of Range: ≤ 5.0%
• pH: 4.0–8.0
• Endotoxins: ≤ 20.0 EU/mL (or per instruction)
• Sterility: No growth
• Appearance: Homogeneous suspension
⚠️ Note: Utility focuses on specific microsphere parameters for SIRT: particle size and absence of free ions. Deviation in particle size is a critical defect leading to severe complications (pneumonitis, embolism).

input.csv

BatchNumber,Formulation_Type,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_mg,Particle_Size_Mean_um,Particle_Size_Min_um,Particle_Size_Max_um,Particles_Out_of_Range_Percent,Free_Holmium_Ion_Percent,Target_Material_Residue_ppm,pH_Value,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected
HO166-MS-2026-001,Microspheres,99.9,98.5,1500.0,35.0,20.0,50.0,2.0,1.0,5.0,6.5,0,10.0,0,0,0,0,0

URS & FS — User Requirements and Functional Specification

1. Scope

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

2. Execution modes

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

3. Key source-derived controls

  • Holmium-166 Quality Checker — Radiopharmaceutical (SIRT/Therapy) (Ph. Eur., USP)
  • ℹ️ The utility checks particle size, RCP, free ions, sterility, endotoxins.
  • ⚠️ CRITICAL! Particle size 20-50 um. Free ions ≤5%. Endotoxins ≤20 EU/mL!
  • BatchNumber,Formulation_Type,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_mg,Particle_Size_Mean_um,Particle_Size_Min_um,Particle_Size_Max_um,Particles_Out_of_Range_Percent,Free_Holmium_Ion_Percent,Target_Material_Residue_ppm,pH_Value,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected
  • HO166-MS-2026-001,Microspheres,99.9,98.5,1500.0,35.0,20.0,50.0,2.0,1.0,5.0,6.5,0,10.0,0,0,0,0,0
  • • Particle Size: For microspheres, the 20–50 um range is critical. Particles <20 um may shunt to lungs causing radiation pneumonitis. Particles >50 um may occlude large vessels.
  • • Radiochemical Purity: Free $^{166}\text{Ho}^{3+}$ is osteotropic (accumulates in bones), leading to bone marrow toxicity. RCP must be ≥95%.
  • • Sterility and Endotoxins: Drug is administered intra-arterially. Requirements are strict.
  • ⚠️ CRITICAL:
  • • Radionuclidic Purity: ≥ 99.0%
  • • Radiochemical Purity: ≥ 95.0%
  • • Free Holmium Ions: ≤ 5.0%
  • • Particles Out of Range: ≤ 5.0%
  • • pH: 4.0–8.0
  • • Endotoxins: ≤ 20.0 EU/mL (or per instruction)
  • • Sterility: No growth
  • ⚠️ Note: Utility focuses on specific microsphere parameters for SIRT: particle size and absence of free ions. Deviation in particle size is a critical defect leading to severe complications (pneumonitis, embolism).

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
1BatchNumberstringHO166-MS-2026-001Batch or lot identifier.
2Formulation_TypestringMicrospheresControlled input parameter from input.csv.
3Radionuclidic_Purity_Percentdecimal99.9Radionuclidic purity; critical radiation safety attribute.
4Radiochemical_Purity_Percentdecimal98.5Radiochemical purity; verifies radionuclide binding and target chemical form.
5Specific_Activity_MBq_mgdecimal1500.0Activity of the radiopharmaceutical material or finished product.
6Particle_Size_Mean_umdecimal35.0Controlled input parameter from input.csv.
7Particle_Size_Min_umdecimal20.0Controlled input parameter from input.csv.
8Particle_Size_Max_umdecimal50.0Controlled input parameter from input.csv.
9Particles_Out_of_Range_Percentdecimal2.0Controlled input parameter from input.csv.
10Free_Holmium_Ion_Percentdecimal1.0Free radionuclide/ion; critical due to non-target uptake and toxicity.
11Target_Material_Residue_ppmdecimal5.0Controlled input parameter from input.csv.
12pH_Valuedecimal6.5Solution pH; stability and administration compatibility parameter.
13SterilityTestflag 0/10Sterility test result; 0 usually means no contamination.
14Bacterial_Endotoxins_EU_per_mLdecimal10.0Bacterial endotoxins; critical criterion for parenteral administration.
15Appearance_Scoredecimal0Visual appearance and visible defect assessment.
16Microbial_Count_TAMCdecimal0Microbiological attribute; positive result is a critical deviation.
17Microbial_Count_TYMCdecimal0Microbiological attribute; positive result is a critical deviation.
18EColi_Detectedflag 0/10Microbiological attribute; positive result is a critical deviation.
19Salmonella_Detectedflag 0/10Microbiological attribute; positive result is a critical deviation.
BatchNumber,Formulation_Type,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_mg,Particle_Size_Mean_um,Particle_Size_Min_um,Particle_Size_Max_um,Particles_Out_of_Range_Percent,Free_Holmium_Ion_Percent,Target_Material_Residue_ppm,pH_Value,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected
HO166-MS-2026-001,Microspheres,99.9,98.5,1500.0,35.0,20.0,50.0,2.0,1.0,5.0,6.5,0,10.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 Holmium-166, 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": "holmium166-quality-checker",
  "api": "Holmium-166",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "HO166-MS-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Formulation_Type",
      "value": "Microspheres",
      "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_mg",
      "value": "1500.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Particle_Size_Mean_um",
      "value": "35.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Particle_Size_Min_um",
      "value": "20.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Particle_Size_Max_um",
      "value": "50.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 isotope family: beta-emitting therapy

Lu-177, Y-90, Ho-166, Re-188, Sm-153, Sr-89, P-32, Cu-67 and Tb-161.

Open

RPH organ/system: bone and musculoskeletal

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

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 organ/system: pulmonary and ventilation

Lung perfusion, MAA, V/Q, aerosol, xenon ventilation, shunt and pulmonary dosimetry.

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: imaging QC and quantitative interpretation

Acquisition, uptake, clearance, perfusion, transit, ejection fraction, segmentation and quantitative imaging.

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