addData: Adds New Data Columns to a Data Frame

In strvalidator: Process Control and Validation of Forensic STR Kits

Adds New Data Columns to a Data Frame

Description

Adds values from columns in 'new.data' to 'data' by keys.

Usage

addData(
  data,
  new.data,
  by.col,
  then.by.col = NULL,
  exact = TRUE,
  ignore.case = TRUE,
  what = NULL,
  debug = FALSE
)

Arguments

data	Data frame containing your main data.
new.data	Data frame containing information you want to add to 'data'.
by.col	character, primary key column.
then.by.col	character, secondary key column.
exact	logical, TRUE matches keys exact.
ignore.case	logical, TRUE ignore case.
what	character vector defining columns to add. Default is all new columns.
debug	logical indicating printing debug information.

Details

Information in columns in data frame 'new.data' is added to data frame 'data' based on primary key value in column 'by.col', and optionally on secondary key values in column 'then.by.col'.

Value

data.frame the original data frame containing additional columns.

Examples

# Get marker names and alleles for Promega PowerPlex ESX 17.
x <- getKit("ESX17", what = "Allele")
# Get marker names and colors for Promega PowerPlex ESX 17.
y <- getKit("ESX17", what = "Color")
# Add color information to allele information.
z <- addData(data = x, new.data = y, by.col = "Marker")
print(x)
print(y)
print(z)

strvalidator documentation built on July 26, 2023, 5:45 p.m.