RenalKidneyUptakeCalculationHelper
Renal Kidney Uptake Calculation Helper
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.csvwith 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.jsonand 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
- Run
RenalKidneyUptakeCalculationHelper.exein demo mode or withinput.csv output.jsonarguments. - Read UTF-8 CSV and validate the header and mandatory columns.
- Convert values to the expected types and validate admissibility.
- Perform the calculation or rule checks for “Renal Kidney Uptake Calculation Helper”.
- Create individual check results and the overall status.
- 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.
OpenRPH isotope family: Tc-99m
Tc-99m radiopharmaceuticals, kit preparation, generator control, SPECT workflows and calculation utilities.
OpenRPH organ/system: renal and urinary
Renography, GFR/ERPF, renal uptake, DMSA/MAG3/DTPA and bladder-related workflows.
OpenRPH 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.
OpenRPH 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.
OpenRPH workflow: imaging QC and quantitative interpretation
Acquisition, uptake, clearance, perfusion, transit, ejection fraction, segmentation and quantitative imaging.
OpenRPH workflow: instruments, devices and radiation safety
PET/gamma-camera state, calibration, detector QC, energy window, TOF, shielding and radiation safety.
OpenRPH workflow: stability, storage, decay and waste
Kinetic stability, shelf life, decay correction, expiry, storage, trend and radioactive waste.
Open