Tc99mColloidChecker
Tc99m Colloid
Tc-99m Colloid Checker — Colloid phase control in technetium-99m radiopharmaceuticals
ℹ️ Utility performs DEEP colloid phase analysis with:
• Current colloid percentage check (≤5% for most agents)
• Stability prediction until end of shelf life (6-12 hours)
• Trend analysis with previous measurements
• pH and temperature impact assessment on colloid formation
• Image quality impact evaluation for different study types
⚠️ CRITICAL: Colloids >5% accumulate in liver/spleen instead of target organ,
reducing image quality and increasing radiation burden to patient!
Usage:
Tc99mColloidChecker.exe → demo mode (console output)
Tc99mColloidChecker.exe input.csv output.json → analyze your data
Input format:
BatchNumber,ProductType,ColloidPhasePercent_Current,pH,MeasurementDateTime,RadiolabelingDateTime,StorageTemperatureC,PreviousColloidPhasePercent,PreviousMeasurementDateTime
Examples (optional parameters can be empty):
TC99M-COL-2026-001,MDP,1.5,6.8,2026-03-18T10:00:00,2026-03-18T08:00:00,4.0,1.2,2026-03-18T09:00:00
TC99M-COL-2026-002,Pyrophosphate,4.2,8.5,2026-03-18T10:00:00,2026-03-18T07:00:00,25.0,3.5,2026-03-18T08:30:00
TC99M-COL-2026-003,DTPA,7.5,9.2,2026-03-18T10:00:00,2026-03-18T06:00:00,30.0,,
— WHY IS THIS NEEDED?
Colloid phase control is CRITICALLY IMPORTANT quality parameter for Tc-99m agents:
• Colloidal particles (10-500 nm) do not reach target tissues, but accumulate in RES (liver, spleen)
• Reduce image contrast and mask pathological lesions
• Increase radiation burden to patient without diagnostic benefit
• Form due to: incorrect pH, high temperature, prolonged storage, poor quality kits
⚠️ CRITICAL:
• Pharmacopoeial limit: ≤5% colloid phase (most agents, Ph. Eur. 2.14.1)
• Warning threshold: >3% — requires enhanced monitoring
• Risk mechanism: colloids → macrophage uptake in RES → liver/spleen accumulation →
reduced target organ uptake → non-diagnostic study
• Accelerating factors: pH >7.5 or <4.5, temperature >25°C, storage >6 hours, oxidation
Key features:
• Colloid prediction until end of shelf life (6-12 hours) accounting for storage conditions
• Trend analysis with previous measurements (colloid formation rate %/hour)
• pH and temperature impact correction
• Image quality impact assessment for different study types:
— Bone scintigraphy (MDP): colloids mask metastases in ribs/spine
— Cardiac imaging (pyrophosphate): colloids reduce infarct contrast
— Renal scintigraphy (DTPA/MAG3): colloids increase abdominal background
• Risk categorization: LOW / MEDIUM / HIGH / CRITICAL
• Specific recommendations for batch utilization
Prediction model:
• Base formation rate: 0.15%/hour at ideal conditions (pH 4.5-7.5, 2-8°C)
• pH correction: ×1.8 at pH 7.5-8.5, ×2.5 at pH >8.5
• Temperature correction: ×1.5 at >8°C, ×2.0 at >25°C, ×3.0 at >30°C
• Prediction = Current value + (Rate × Hours until expiry)
Image quality impact:
• Colloids >7.5%: NON-DIAGNOSTIC study — repeat administration required
• Colloids 5-7.5%: POOR quality — limited diagnostic value
• Colloids 3-5%: ACCEPTABLE — may require delayed imaging
• Colloids <3%: EXCELLENT quality — full diagnostic utility
💡 Practical tips:
1. Always check pH after labeling (ideal 4.5-7.5 for most agents)
2. Store labeled agents at 2-8°C — reduces colloid formation rate by 70%
3. For agents with colloids >3% increase monitoring frequency to hourly
4. At pH >8.0 verify correct buffer volume during labeling
5. Document all measurements for audits — this is a critical quality parameter
⚠️ Limitations:
• Prediction based on simplified model — actual conditions may vary
• Does not account for starting kit quality
• Does not replace official pharmacopoeial analytical method (paper chromatography)
• For agents with colloids >5% — immediate removal regardless of prediction
Data sources:
• Ph. Eur. Monograph 0148 — Technetium-99m radiopharmaceuticals
• USP General Chapter <823> — Radiopharmaceuticals for Positron Emission Tomography
• Journal of Nuclear Medicine Technology — Colloid formation in 99mTc-labeled agents (2019)
• EANM Guidelines for Radiopharmaceutical Preparationinput.csv
BatchNumber,ProductType,ColloidPhasePercent_Current,pH,MeasurementDateTime,RadiolabelingDateTime,StorageTemperatureC,PreviousColloidPhasePercent,PreviousMeasurementDateTime TC99M-COL-2026-001,MDP,1.5,6.8,2026-03-18T10:00:00,2026-03-18T08:00:00,4.0,1.2,2026-03-18T09:00:00 TC99M-COL-2026-002,Pyrophosphate,4.2,8.5,2026-03-18T10:00:00,2026-03-18T07:00:00,25.0,3.5,2026-03-18T08:30:00 TC99M-COL-2026-003,DTPA,7.5,9.2,2026-03-18T10:00:00,2026-03-18T06:00:00,30.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 Tc99m Colloid Checker utility is used for Tc99m Colloid. 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: contrast media, decay correction, endotoxins, PET, radionuclide purity, radiopharma, SPECT, sterility
2. Execution modes
Tc99mColloidChecker.exe → demo mode (console output) Tc99mColloidChecker.exe input.csv output.json → analyze 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
- Current colloid percentage check (≤5% for most agents)
- ⚠️ CRITICAL: Colloids >5% accumulate in liver/spleen instead of target organ,
- ⚠️ CRITICAL:
- Pharmacopoeial limit: ≤5% colloid phase (most agents, Ph. Eur. 2.14.1)
- Warning threshold: >3% — requires enhanced monitoring
- Risk mechanism: colloids → macrophage uptake in RES → liver/spleen accumulation →
- Accelerating factors: pH >7.5 or <4.5, temperature >25°C, storage >6 hours, oxidation
- Colloid prediction until end of shelf life (6-12 hours) accounting for storage conditions
- Trend analysis with previous measurements (colloid formation rate %/hour)
- pH and temperature impact correction
- Image quality impact assessment for different study types:
- — Renal scintigraphy (DTPA/MAG3): colloids increase abdominal background
- Risk categorization: LOW / MEDIUM / HIGH / CRITICAL
- Specific recommendations for batch utilization
- Base formation rate: 0.15%/hour at ideal conditions (pH 4.5-7.5, 2-8°C)
- pH correction: ×1.8 at pH 7.5-8.5, ×2.5 at pH >8.5
- Temperature correction: ×1.5 at >8°C, ×2.0 at >25°C, ×3.0 at >30°C
- Prediction = Current value + (Rate × Hours until expiry)
- Colloids >7.5%: NON-DIAGNOSTIC study — repeat administration required
- Colloids 5-7.5%: POOR quality — limited diagnostic value
- Colloids 3-5%: ACCEPTABLE — may require delayed imaging
- Colloids <3%: EXCELLENT quality — full diagnostic utility
- 1. Always check pH after labeling (ideal 4.5-7.5 for most agents)
- 2. Store labeled agents at 2-8°C — reduces colloid formation rate by 70%
5. URS — user requirements
| ID | Requirement | Criticality | Acceptance criterion |
|---|---|---|---|
| URS-001 | The system shall accept an input.csv file for Tc99m Colloid 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 | TC99M-COL-2026-001 | mandatory field; used for batch/lot traceability |
| 2 | ProductType | text | as specified | Product Type | MDP | mandatory value; format and acceptability are checked by the utility |
| 3 | ColloidPhasePercent_Current | decimal | % | Colloid Phase % Current | 1.5 | mandatory numeric value; rule comparison is performed by the utility |
| 4 | pH | decimal | pH | p H | 6.8 | mandatory numeric value; rule comparison is performed by the utility |
| 5 | MeasurementDateTime | date/time | as specified | Measurement Date Time | 2026-03-18T10:00:00 | mandatory value; format and acceptability are checked by the utility |
| 6 | RadiolabelingDateTime | date/time | as specified | Radiolabeling Date Time | 2026-03-18T08:00:00 | mandatory value; format and acceptability are checked by the utility |
| 7 | StorageTemperatureC | decimal | °C | Storage Temperature C | 4.0 | mandatory numeric value; rule comparison is performed by the utility |
| 8 | PreviousColloidPhasePercent | decimal | % | Previous Colloid Phase % | 1.2 | mandatory numeric value; rule comparison is performed by the utility |
| 9 | PreviousMeasurementDateTime | date/time | as specified | Previous Measurement Date Time | 2026-03-18T09:00:00 | mandatory value; format and acceptability are checked by the utility |
CSV example
BatchNumber,ProductType,ColloidPhasePercent_Current,pH,MeasurementDateTime,RadiolabelingDateTime,StorageTemperatureC,PreviousColloidPhasePercent,PreviousMeasurementDateTime TC99M-COL-2026-001,MDP,1.5,6.8,2026-03-18T10:00:00,2026-03-18T08:00:00,4.0,1.2,2026-03-18T09:00:00
7. FS — functional specification
| ID | Function | Implementation description |
|---|---|---|
| FS-001 | CLI entry point | The executable Tc99mColloidChecker.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 Tc99m Colloid, 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": "Tc99mColloidChecker",
"api": "Tc99m Colloid",
"batchNumber": "TC99M-COL-2026-001",
"overallStatus": "PASS|WARNING|FAIL",
"checkedAtUtc": "2026-05-18T00:00:00Z",
"checks": [
{
"parameter": "BatchNumber",
"value": "TC99M-COL-2026-001",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "ProductType",
"value": "MDP",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "ColloidPhasePercent_Current",
"value": "1.5",
"unit": "%",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "pH",
"value": "6.8",
"unit": "pH",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "MeasurementDateTime",
"value": "2026-03-18T10:00:00",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "RadiolabelingDateTime",
"value": "2026-03-18T08:00:00",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "StorageTemperatureC",
"value": "4.0",
"unit": "°C",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "PreviousColloidPhasePercent",
"value": "1.2",
"unit": "%",
"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. |
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
PetRad 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: Tc-99m
Tc-99m radiopharmaceuticals, kit preparation, generator control, SPECT workflows and calculation utilities.
OpenRPH organ/system: bone and musculoskeletal
Bone scintigraphy, MDP/PYP, marrow, bone-pain palliation, skeletal metastases and radiosynovectomy.
OpenRPH organ/system: cardiovascular
Myocardial perfusion, cardiac PET/SPECT, ventricular function, blood-pool and perfusion tracers.
OpenRPH organ/system: hepatobiliary and GI
HIDA, mebrofenin, gallbladder, gastric emptying, GI transit, bleeding and liver/spleen imaging.
OpenRPH organ/system: renal and urinary
Renography, GFR/ERPF, renal uptake, DMSA/MAG3/DTPA and bladder-related workflows.
OpenRPH use case: generators, isotope purity and starting radionuclides
Control of generator eluate, breakthrough, radionuclidic purity, isotope mix, carrier/free radionuclides and starting radionuclides before labeling.
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: 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.
Open