egfr is a vectorised R toolkit for estimating glomerular filtration rate (eGFR) and creatinine clearance from serum creatinine, cystatin C, or both. It implements 20 validated adult, paediatric, and neonatal equations, plus helpers for body surface area, KDIGO CKD staging, and unit conversion.
The package is inspired by the kidney.epi package and was ported from the equation set used by eGFR.app.
These equations are screening tools and are not a substitute for measured GFR or clinical judgement.
Installation
Install the released version from R-universe:
install.packages("egfr", repos = "https://mhovd.r-universe.dev")Or install the development version from GitHub:
# install.packages("remotes")
remotes::install_github("mhovd/egfr")Quick start
library(egfr)
# CKD-EPI 2021 creatinine (race-free) — recommended for adults
egfr_ckdepi_cr_2021(creatinine = 1.0, age = 50, sex = "female")
#> 68.6
# Fully vectorised: pass vectors for any argument
egfr_ckdepi_cr_2021(
creatinine = c(0.8, 1.2, 1.5),
age = c(40, 65, 72),
sex = c("female", "male", "female")
)
# Units: supply creatinine in umol/L instead of mg/dL
egfr_ckdepi_cr_2021(88.4, 50, "female", creatinine_units = "umol/l")
# Classify the result into a KDIGO stage
ckd_stage(egfr_ckdepi_cr_2021(1.0, 50, "female"))
#> "G2"Available equations
Adult
| Function | Equation | Biomarker |
|---|---|---|
egfr_ckdepi_cr_2021() |
CKD-EPI 2021 (race-free) | creatinine |
egfr_ckdepi_cys_2021() |
CKD-EPI 2021 (race-free) | cystatin C |
egfr_ckdepi_cr_cys_2021() |
CKD-EPI 2021 (race-free) | both |
egfr_ckdepi_cr_2009() |
CKD-EPI 2009 (with race) | creatinine |
egfr_ckdepi_cys_2012() |
CKD-EPI 2012 | cystatin C |
egfr_mdrd() |
MDRD 4-variable (IDMS) | creatinine |
egfr_cockcroft_gault() |
Cockcroft-Gault (CrCl) | creatinine |
egfr_ekfc_cr() |
EKFC 2021 | creatinine |
egfr_ekfc_cys() |
EKFC 2023 | cystatin C |
egfr_ekfc_cr_cys() |
EKFC 2023 | both |
egfr_fas_cr() |
Full Age Spectrum 2016 | creatinine |
egfr_lund_malmo() |
Lund-Malmoe Revised 2011 | creatinine |
egfr_bis_cr() |
Berlin Initiative Study 2012 | creatinine |
Paediatric & neonatal
| Function | Equation | Biomarker |
|---|---|---|
egfr_schwartz() |
Schwartz bedside 2009 | creatinine |
egfr_ckid_u25_cr() |
CKiD U25 2021 | creatinine |
egfr_ckid_u25_cys() |
CKiD U25 2021 | cystatin C |
egfr_ckid_u25_cr_cys() |
CKiD U25 2021 | both |
egfr_ckid_u25_cr_extended() |
CKiD U25 extended (to 30) | creatinine |
egfr_capa() |
CAPA 2014 | cystatin C |
egfr_neonatal() |
Neonatal 2022 | creatinine |
Helpers
| Function | Purpose |
|---|---|
bsa() |
Body surface area (Du Bois, Haycock, Mosteller) |
gfr_bsa_adjust() |
Convert between absolute and BSA-normalised GFR |
ckd_stage() |
KDIGO GFR category (G1-G5) |
convert_creatinine() |
mg/dL <-> umol/L |
Conventions
- All
egfr_*()functions return unrounded values in mL/min/1.73m^2, exceptegfr_cockcroft_gault(), which returns creatinine clearance in mL/min. - Creatinine defaults to mg/dL; pass
creatinine_units = "umol/l"to use SI units. Height defaults to cm. - Sex labels default to
"male"/"female"and can be customised vialabel_sex_male/label_sex_female.