Rank specimen matrices by reliability under submersion and decomposition

When peripheral blood is compromised (water submersion hemodilution or decompositional change), the analyst must choose an alternative matrix. This encodes the documented resistance-to-degradation ordering (vitreous humour and brain are anatomically protected; the liver concentrates metabolites; blood-based matrices dilute) as a transparent heuristic score, penalised by days submerged and decomposition stage. It is a documented ordering, not an empirical prior, and never fabricates case data.

Usage

morie_tox_matrix_reliability(
  matrix = NULL,
  submersion_days = 0,
  decomp_stage = 0L
)

Arguments

matrix

Optional character vector of matrices to score (default: all recognised). Each must be one of morie_tox_matrix_schema()'s matrix values.

submersion_days

Days submerged (>= 0); penalises diluting matrices.

decomp_stage

Ordinal decomposition stage (0 = fresh); penalises all.

Value

A data.frame of matrix, reliability (0–1), and rank (1 = most reliable), ordered best first.

Examples

morie_tox_matrix_reliability(submersion_days = 14, decomp_stage = 3)
#>                            matrix reliability rank
#> vitreous_humour   vitreous_humour       0.665    1
#> brain                       brain       0.595    2
#> liver                       liver       0.560    3
#> bile                         bile       0.490    4
#> muscle                     muscle       0.455    5
#> kidney                     kidney       0.455    6
#> gastric                   gastric       0.385    7
#> urine                       urine       0.224    8
#> peripheral_blood peripheral_blood       0.205    9
#> central_blood       central_blood       0.131   10