RenalPlasmaClearanceEstimator

Renal Plasma Clearance Estimator

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

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.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 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.json and retain the source values used for the checks.
  • The calculation supports qualified review; it is not an autonomous diagnosis or prescription.

FS — Functional Specification

  1. Run RenalPlasmaClearanceEstimator.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 Plasma Clearance Estimator”.
  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

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.

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