RenalPlasmaClearanceEstimator
Renal Plasma Clearance Estimator
Utility description: Renal Plasma Clearance Estimator
Renal Plasma Clearance Estimator — Estimation of Renal Plasma Clearance (GFR and ERPF)
ℹ️ Utility calculates Glomerular Filtration Rate (GFR) or Effective Renal Plasma Flow (ERPF):
• Based on single-sample blood analysis method
• Considering injected activity and plasma concentration
• With normalization to Body Surface Area (BSA)
⚠️ CRITICAL: Accuracy depends on sampling time!
DTPA: sample at 120 min. MAG3: sample at 40-50 min.
Error in determining net injected activity leads to proportional error in result.
Usage:
RenalPlasmaClearanceEstimator.exe → demo mode (console output)
RenalPlasmaClearanceEstimator.exe input.csv output.json → evaluate your data
Input format:
PatientID,StudyDate,InjectedActivityMBq,PreInjectionSampleCounts,PostInjectionSampleCounts,BloodSampleCountsPerML,TimePostInjectionMin,PatientWeightKg,PatientHeightCm,PatientAge,Gender,Radiopharmaceutical
Example:
PAT-GFR-001,2026-07-21,100.0,500000,5000,2500,120,70,175,45,M,DTPA
— WHY IS THIS NEEDED?
Quantitative assessment of kidney function is the gold standard in nephrology.
• Tc-99m DTPA is filtered by glomeruli, so its clearance equals GFR.
• Tc-99m MAG3 is secreted by tubules, so its clearance equals ERPF.
• Single-sample method (taking one blood sample at a specific time) is less accurate than multi-sample, but much more convenient for patient and clinic.
• Results are normalized to standard body surface area (1.73 m²) for comparison between patients.
⚠️ CRITICAL:
• Net injected activity = (Pre-counts - Post-counts) / Pre-counts * Syringe Activity. Any drug loss must be accounted for.
• Sampling time is critical: for DTPA distribution phase ends by 120 min, for MAG3 — by 40-50 min.
• Plasma volume is estimated indirectly through patient weight and height.
• Hematocrit affects plasma volume; if patient's exact hematocrit is known, calculation can be refined.
Key features:
• Automatic calculation of net injected dose by syringe counts.
• Selection of calculation model depending on drug (DTPA or MAG3).
• Normalization of results to Body Surface Area (Du Bois formula).
• Check of sampling time optimality.
• Interpretation of results relative to age norms.
Critical parameters:
• GFR normal: 90–120 mL/min/1.73m²
• ERPF normal: 400–600 mL/min/1.73m²
• DTPA sampling time: 110–130 min
• MAG3 sampling time: 40–50 min
💡 Usage tips:
1. Carefully measure syringe activity before and after injection in the same geometry (counter).
2. Blood sample must be taken exactly at the specified time. Deviation of more than 5 minutes requires coefficient adjustment.
3. For obese or edematous patients, plasma volume estimation by weight may be inaccurate.
4. If clearance is below normal, it is recommended to repeat the study using multi-sample method to construct full clearance curve.
5. Consider medications affecting renal blood flow (e.g., NSAIDs) before the study.
⚠️ Note: This utility links the pharmaceutical part (drug activity) with clinical physiology. It allows objectification of kidney function, which is impossible to do only by visual inspection of the scintigram. Results are used for staging Chronic Kidney Disease (CKD) and making decisions about dialysis or transplantation.input.csv
PatientID,StudyDate,InjectedActivityMBq,PreInjectionSampleCounts,PostInjectionSampleCounts,BloodSampleCountsPerML,TimePostInjectionMin,PatientWeightKg,PatientHeightCm,PatientAge,Gender,Radiopharmaceutical PAT-GFR-001,2026-07-21,100.0,500000,5000,2500,120,70,175,45,M,DTPA PAT-ERPF-002,2026-07-21,150.0,600000,6000,1800,45,80,180,50,F,MAG3 PAT-GFR-003,2026-07-21,80.0,400000,4000,4000,120,50,150,70,M,DTPA
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 Plasma Clearance Estimator”.
- The checks shall include the following criteria: GFR normal: 90–120 mL/min/1.73m²; ERPF normal: 400–600 mL/min/1.73m²; DTPA sampling time: 110–130 min; MAG3 sampling time: 40–50 min.
- 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 calculation supports qualified review; it is not an autonomous diagnosis or prescription.
FS — Functional Specification
- Run
RenalPlasmaClearanceEstimator.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 Plasma Clearance Estimator”.
- Create individual check results and the overall status.
- Write machine-readable JSON; invalid input shall not appear as a successful result.
input.csv example
PatientID,StudyDate,InjectedActivityMBq,PreInjectionSampleCounts,PostInjectionSampleCounts,BloodSampleCountsPerML,TimePostInjectionMin,PatientWeightKg,PatientHeightCm,PatientAge,Gender,Radiopharmaceutical PAT-GFR-001,2026-07-21,100.0,500000,5000,2500,120,70,175,45,M,DTPA
Minimum output.json structure
{
"utility": "RenalPlasmaClearanceEstimator",
"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.
Open