add_add_var {DImodelsVis} | R Documentation |
Utility function for incorporating any additional variables into the data. Each row in the data will be replicated and new columns will be added for each variable specified in 'add_var' with values corresponding to their cartesian product.
add_add_var(data, add_var = NULL)
data |
A data frame containing the data in which to add the additional variables. |
add_var |
A named list or data-frame specifying the names and corresponding values of each new variable to add to the data. If a list is specified, each row in the data would be replicated for each unique combination of values of the specified variables (i.e., their cartesian product) in 'add_var', while specifying a data-frame would replicate each row in the data for each row in add_var (i.e., merge the two data-frames). |
A data-frame with all additional columns specified in 'add_var' and the following additional column.
A unique identifier describing each element from the cartesian product of all variables specified in 'add_var'.
test_data <- data.frame(diag(1, 3))
print(test_data)
## Adding a single variable
add_add_var(data = test_data,
add_var = list("Var1" = c(10, 20)))
## Specifying multiple variables as a list will add values for
## each unique combination
add_add_var(data = test_data,
add_var = list("Var1" = c(10, 20),
"Var2" = c(30, 40)))
## Specifying add_var as a data.frame would simply merge the two data-frames
add_add_var(data = test_data,
add_var = data.frame("Var1" = c(10, 20),
"Var2" = c(30, 40)))
## If the list specified in `add_var` is not named, then the additional
## variables will be automatically named Var1, Var2, Var3, etc.
add_add_var(data = test_data,
add_var = list(c(1, 2), c(3, 4)))