setPairing {dvir}

Set identifications manually

Description

Manually set one or several identifications in a DVI dataset. Typically, these are obtained by external means, e.g., fingerprints, dental records etc.

Usage

setPairing(
  dvi,
  match = NULL,
  victim = NULL,
  missing = NULL,
  Conclusion = "Provided",
  Comment = "",
  verbose = TRUE
)

Arguments

dvi

A DVI dataset.

match

A named vector of the format c(vic1 = miss2, vic2 = miss2, ...).

victim

A vector of victim sample names. If NULL, defaulting to names(match).

missing

A vector of missing person names, of the same length as victim. If NULL, defaulting to as.character(match).

Conclusion

A character passed on to the Conclusion column of the output summary.

Comment

A character passed on to the Comment column of the output summary.

verbose

A logical, by default TRUE.

Details

The command setPairing(dvi, c("V" = "M")) does the following:

• Transfer the data of victim "V" to the individual "M" in the appropriate reference family

• Remove "M" from the list of missing persons

• Remove "V" from the list of victim samples

• Update the list of pairings

Value

A list with the following entries:

• dviReduced: The new dviData object, as described in Details

• summary: A data frame summarising the identifications

Examples

x = setPairing(example2, match = c("V3" = "M2"))
x$dviReduced
x$summary

# Alternative syntax, using `victim` and `missing`
y = setPairing(planecrash, victim = c("V4", "V5"), missing = c("M4", "M5"),
           Conclusion = "External evidence", Comment = "Dental")
y$dviReduced
y$summary