Tc99mMAG3LabelingEfficiencyAnalyzer

Tc-99m MAG3 Labeling Efficiency Analyzer

api RPH Tc-99m renal imaging nuclear medicine CSV→JSON URS & FS rule-based
Open selection

Utility description: Tc-99m MAG3 Labeling Efficiency Analyzer

Tc-99m MAG3 Labeling Efficiency Analyzer — Tc-99m MAG3 Labeling Efficiency Analyzer

ℹ️  Utility controls quality of renal scintigraphy agent:
    • Radiochemical purity (>90%)
    • Free pertechnetate (<5%)
    • Hydrolyzed/colloidal Tc (<5%)
    • pH level

⚠️  CRITICAL: Impurities change biodistribution!
    Free Tc goes to thyroid, colloids go to liver.

Usage:
  Tc99mMAG3LabelingEfficiencyAnalyzer.exe                            → demo mode (console output)
  Tc99mMAG3LabelingEfficiencyAnalyzer.exe input.csv output.json      → evaluate your data

Input format:
BatchNumber,ProductName,Complex_Percent,Free_Tc_Percent,Hydrolyzed_Percent,pH,Incubation_Min,Activity_MBq,Min_RCP,Max_Free,Max_Hydro

Example:
  MAG3-2026-001,Tc-99m MAG3,96.5,2.0,1.5,7.4,10,740,90,5,5

— WHY IS THIS NEEDED?
Tc-99m MAG3 quality control is critical for kidney function diagnostics:
• MAG3 is excreted by renal tubules, providing high signal-to-background ratio
• Free $^{99m}TcO_4^-$ accumulates in thyroid, salivary glands and stomach, creating background
• Hydrolyzed reduced technetium (colloids) is taken up by liver and spleen RES
• This can mimic pathology or hide real accumulation defects in kidneys
• USP and Ph.Eur. require RCP of at least 90-95%

⚠️  CRITICAL:
• Radiochemical purity ≥90% (preferably ≥95%)
• Free pertechnetate ≤5%
• Colloidal impurities ≤5%
• pH must be neutral or slightly alkaline for complex stability

Key features:
• Separate control of two main impurity types (free and hydrolyzed)
• pH check as stability factor
• Compliance with USP <823> and Ph.Eur. standards
• Support for ITLC and HPLC data

Critical parameters:
• RCP: ≥90%
• Free Tc: ≤5%
• Hydrolyzed Tc: ≤5%

💡 Usage tips:
1. Use two different chromatographic systems to separate all three forms (e.g., acetone and saline)
2. Control incubation time (usually 10-15 minutes at room temperature)
3. Avoid air bubbles entering the kit (oxidation of $Sn^{2+}$)
4. Check $^{99}Mo/^{99m}Tc$ generator activity for molybdenum breakthrough
5. Use preparation within 6-8 hours after elution

⚠️ Note: MAG3 is more resistant to transchelation than DTPA, but more sensitive to reduction conditions than DMSA. The utility helps find balance between labeling efficiency and preparation stability.

input.csv

BatchNumber,ProductName,Complex_Percent,Free_Tc_Percent,Hydrolyzed_Percent,pH,Incubation_Min,Activity_MBq,Min_RCP,Max_Free,Max_Hydro
MAG3-2026-001,Tc-99m MAG3 Standard,96.5,2.0,1.5,7.4,10,740,90,5,5
MAG3-2026-002,Tc-99m MAG3 (High Free),85.0,12.0,3.0,7.4,10,740,90,5,5
MAG3-2026-003,Tc-99m MAG3 (Colloids),92.0,1.0,7.0,6.0,10,740,90,5,5

URS & FS — user requirements and functional specification

URS — User Requirements Specification

  • The utility shall accept input.csv with the headers defined by the data contract.
  • Before calculation, the utility shall detect missing fields, type errors and invalid values.
  • The utility shall deterministically perform “Tc-99m MAG3 Labeling Efficiency Analyzer”.
  • The checks shall include the following criteria: RCP: ≥90%; Free Tc: ≤5%; Hydrolyzed Tc: ≤5%.
  • Each processed record shall receive a clear PASS, WARNING or FAIL status with the reason.
  • The result shall be written to output.json and retain the source values used for the checks.
  • The result supports batch-data review; release remains with authorised QA/QC personnel.

FS — Functional Specification

  1. Run Tc99mMAG3LabelingEfficiencyAnalyzer.exe in demo mode or with input.csv output.json arguments.
  2. Read UTF-8 CSV and validate the header and mandatory columns.
  3. Convert values to the expected types and validate admissibility.
  4. Perform the calculation or rule checks for “Tc-99m MAG3 Labeling Efficiency Analyzer”.
  5. Create individual check results and the overall status.
  6. Write machine-readable JSON; invalid input shall not appear as a successful result.

input.csv example

BatchNumber,ProductName,Complex_Percent,Free_Tc_Percent,Hydrolyzed_Percent,pH,Incubation_Min,Activity_MBq,Min_RCP,Max_Free,Max_Hydro
MAG3-2026-001,Tc-99m MAG3 Standard,96.5,2.0,1.5,7.4,10,740,90,5,5

Minimum output.json structure

{
  "utility": "Tc99mMAG3LabelingEfficiencyAnalyzer",
  "source": "input.csv",
  "status": "PASS|WARNING|FAIL",
  "checks": [
    {
      "parameter": "example",
      "status": "PASS",
      "message": "criterion satisfied"
    }
  ],
  "errors": []
}

Before operational use

  • Limits and coefficients shall be approved before operational use.
  • After an executable or rule change, repeat the affected tests.
  • Retain the source CSV and JSON result together in the controlled process.

Included in packages

Radiopharmaceutical Diagnostics and Therapy QC Suite

36 utilities for clinically oriented radiopharmaceutical and workflow quality control: PET/SPECT tracers, the Tc-99m renal workflow, PRRT, PSMA therapy, targeted alpha therapy, radioembolization, bone-pain palliation, immuno-PET and generator-based radionuclide control.

Open

RPH isotope family: Tc-99m

Tc-99m radiopharmaceuticals, kit preparation, generator control, SPECT workflows and calculation utilities.

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: renal and urinary

Renography, GFR/ERPF, renal uptake, DMSA/MAG3/DTPA and bladder-related workflows.

Open

RPH Tc-99m Renal Radiopharmaceutical and Imaging QC Suite

16 utilities covering the Tc-99m renal workflow: generator eluate and Mo-99 breakthrough, Sn(II), labeling stoichiometry and pH, radiochemical purity and stability of MAG3, DTPA, DMSA(III) and glucoheptonate, gamma-camera uniformity, renal uptake and plasma clearance, bladder voiding efficiency, patient dosimetry and decay-in-storage waste management.

Open

RPH use case: Tc-99m renal and nephrourology

Renal radiopharmaceuticals and calculation workflows: MAG3, DTPA, DMSA, glucoheptonate, generator Tc-99m, dynamic renography, GFR/ERPF and dosimetry.

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 workflow: stability, storage, decay and waste

Kinetic stability, shelf life, decay correction, expiry, storage, trend and radioactive waste.

Open

RPH workflow: synthesis, labelling and kit reconstitution

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

Open