RenalKidneyUptakeCalculationHelper

Renal Kidney Uptake Calculation Helper

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

Utility description: Renal Kidney Uptake Calculation Helper

Renal Kidney Uptake Calculation Helper — Renal Kidney Uptake Calculation Helper

ℹ️  Utility calculates quantitative renal function parameters:
    • Left and right kidney uptake percentage
    • Total Uptake
    • Asymmetry Index
    • Depth and background correction

⚠️  CRITICAL: Without depth correction, results are distorted!
    Deeper kidney will appear less active.

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

Input format:
BatchNumber,ProductName,Left_Counts,Right_Counts,BG_Counts,Dose_MBq,Calib_Factor,Atten_Coeff,Left_Depth_cm,Right_Depth_cm,Min_Total_Uptake,Max_Asymmetry

Example:
  RENAL-001,Tc-99m DMSA,150000,145000,500,200,150,0.15,7.0,7.2,40,15

— WHY IS THIS NEEDED?
Quantitative assessment is critical for kidney disease diagnostics:
• DMSA is used to assess cortical mass and detect scarring (pyelonephritis)
• MAG3 and DTPA are used to assess filtration and secretion rates
• Gamma camera registers only surface photons; deep structures are "shadowed"
• Asymmetry >15% often indicates renal artery stenosis or chronic disease
• Utility automates complex calculations accounting for background and signal attenuation

⚠️  CRITICAL:
• Background Subtraction is mandatory for accuracy
• Attenuation Correction uses soft tissue attenuation coefficient (~0.15 cm^-1 for 140 keV)
• System calibration factor must be current
• Normal total uptake for DMSA is 40-50% of administered dose

Key features:
• Net Counts calculation
• Exponential depth attenuation correction
• Asymmetry Index calculation
• Support for various radiopharmaceuticals (DMSA, MAG3, DTPA)

Critical parameters:
• Total Uptake: ≥40% (for DMSA)
• Asymmetry: ≤15%

💡 Usage tips:
1. Precisely define ROI (Regions of Interest) around kidneys
2. Measure kidney depth via CT data or formulas based on height/weight
3. Use standardized background subtraction protocols (subrenal region)
4. Compare results with patient's previous studies
5. Account for time post-injection (for DMSA peak uptake is 2-4 hours)

⚠️ Note: Unlike simple visualization, this tool turns pictures into numbers. This allows objective tracking of disease progression or treatment efficacy, not relying solely on subjective physician opinion.

input.csv

BatchNumber,ProductName,Left_Counts,Right_Counts,BG_Counts,Dose_MBq,Calib_Factor,Atten_Coeff,Left_Depth_cm,Right_Depth_cm,Min_Total_Uptake,Max_Asymmetry
RENAL-UPTAKE-2026-001,Tc-99m DMSA,150000,145000,500,200,150,0.15,7.0,7.2,40,15
RENAL-UPTAKE-2026-002,Tc-99m MAG3 (Obstruction),120000,40000,600,300,150,0.15,6.5,6.5,30,15
RENAL-UPTAKE-2026-003,Tc-99m DTPA (Low Function),50000,55000,400,200,150,0.15,8.0,8.0,40,15

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 “Renal Kidney Uptake Calculation Helper”.
  • The checks shall include the following criteria: Total Uptake: ≥40% (for DMSA); Asymmetry: ≤15%.
  • 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 equipment or measurement-system QC and requires review by the responsible specialist.

FS — Functional Specification

  1. Run RenalKidneyUptakeCalculationHelper.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 “Renal Kidney Uptake Calculation Helper”.
  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,Left_Counts,Right_Counts,BG_Counts,Dose_MBq,Calib_Factor,Atten_Coeff,Left_Depth_cm,Right_Depth_cm,Min_Total_Uptake,Max_Asymmetry
RENAL-UPTAKE-2026-001,Tc-99m DMSA,150000,145000,500,200,150,0.15,7.0,7.2,40,15

Minimum output.json structure

{
  "utility": "RenalKidneyUptakeCalculationHelper",
  "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: 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: imaging QC and quantitative interpretation

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

Open

RPH workflow: instruments, devices and radiation safety

PET/gamma-camera state, calibration, detector QC, energy window, TOF, shielding and radiation safety.

Open

RPH workflow: stability, storage, decay and waste

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

Open