Equity matrix algorithm

An algorithm to apply on deceased donor's Kidney allocation for transplantation. Ordering of wait listed candidates for a given donor and according to an utility-justice matrix.

Usage

eqm(
  iso = TRUE,
  dABO = "O",
  dA = c("1", "2"),
  dB = c("15", "44"),
  dDR = c("1", "4"),
  donor.age = 60,
  df.abs = cabs,
  data = candidates,
  n = 2,
  q2 = 60,
  q3 = 80,
  uj.matx = uj_matx(),
  SP = FALSE,
  AM = FALSE,
  mm000 = FALSE,
  check.validity = FALSE
)

Arguments

iso

A logical value for ABO isogroupal compatibility.

dABO

A character value with donor's ABO blood group (O, A, B, AB).

dA

A two elements character vector donor's HLA-A typing.

dB

A two elements character vector donor's HLA-B typing.

dDR

A two elements character vector donor's HLA-DR typing.

donor.age

A numeric value with donor's age.

df.abs

A data frame with candidates' antibodies.

data

A data frame containing demographics and medical information for a group of waitlisted transplant candidates.

n

A positive integer to slice the first candidates.

q2

A numerical value for the median of candidates' waiting list (0 - 120).

q3

A numerical value for the third quartile of candidates' waiting list (0 - 120).

uj.matx

A 6 by 6 matrix obtained from uj_matx().

SP

A logical value, when TRUE donors with 65+ years old are allocated prioritize to 65+ candidates,similarly do the Senior Program.

AM

A logical value, when TRUE hipersensitized candidates are prioritize, similarly to the Acceptable mismatch program.

mm000

A logical value, when TRUE candidates with 0 HLA mismatchs with the donor are prioritize.

check.validity

Logical to decide whether to validate input arguments.

Value

An ordered data frame with a column ptsEQM (points from utility-justice matrix), SP, HI and mmHLA.

Examples

if (FALSE) {
eqm(iso = TRUE, dABO = "O" ,
dA = c("1","2"), dB = c("15","44"), dDR = c("1","4") ,
donor.age = 60 , df.abs = cabs , data = candidates ,
n = 2 , q2 = 60 , q3 = 80 , uj.matx = uj_matx(),
SP = FALSE, AM = FALSE, mm000 = FALSE,
check.validity = FALSE)
}