findUndisputed {dvir} | R Documentation |
Undisputed identifications in a DVI problem
Description
This function uses the pairwise LR matrix to find undisputed matches
between victims and missing individuals. An identification is
called undisputed, relative to a threshold T, if the corresponding likelihood
ratio
AND
is at least T times greater
than all other pairwise LRs involving
or
.
Usage
findUndisputed(
dvi,
pairings = NULL,
ignoreSex = FALSE,
threshold = 10000,
strict = FALSE,
relax = !strict,
limit = 0,
nkeep = NULL,
check = TRUE,
numCores = 1,
verbose = TRUE
)
Arguments
dvi |
A |
pairings |
A list of possible pairings for each victim. If NULL, all sex-consistent pairings are used. |
ignoreSex |
A logical. |
threshold |
A non-negative number. If no pairwise LR exceed this, the iteration stops. |
strict |
A logical affecting the definition of being undisputed (see Details). Default: FALSE. |
relax |
Deprecated; use |
limit |
A positive number. Only pairwise LR values above this are considered. |
nkeep |
An integer, or NULL. If given, only the |
check |
A logical indicating if the input data should be checked for consistency. Default: TRUE. |
numCores |
An integer; the number of cores used in parallelisation. Default: 1. |
verbose |
A logical. Default: TRUE. |
Details
If the parameter strict
is set to TRUE, the last criterion is replaced with
the stronger requirement that all other pairwise LRs involving or
must be at most 1.
Value
A list with the following entries:
-
dviReduced
: A reduced version ofdvi
, where undisputed victims/missing persons are removed, and data from undisputed victims inserted into the reference data. -
summary
: A data frame summarising the undisputed matches. -
LRmatrix
: Output frompairwiseLR()
applied to the reduced problem.
See Also
Examples
u1 = findUndisputed(planecrash, verbose = FALSE)
u1$summary
# With `strict = TRUE`, the match M3 = V2 goes away
u2 = findUndisputed(planecrash, strict = TRUE, verbose = FALSE)
u2$summary
# Reason: M3 has LR > 1 also against V7
u2$LRmatrix[, "M3"] |> round(2)