R2DT (version 0.2)

setRefLevelDT: Setting the reference level of all or a selected set of the factor columns of a data.table object

Description

Setting the reference level of all or a selected set of the factor columns of a data.table object

Usage

setRefLevelDT(inputDT, categoricalVar, referenceLevel)

Arguments

inputDT

data.table object containing the data of interest. This is an obligatory argument, without default value.

categoricalVar

Character vector containing potential column names of the 'inputDT' argument. This is an obligatory argument, without default value.

referenceLevel

Character vector containing the new reference levels. This is an obligatory argument, without default value.

Value

No value is returned. Note that the 'categoricalVar' and 'referenceLevel' should match up, meaning that they should be of the same length and the ith element should refer to the same variable.

Examples

# NOT RUN {
library(data.table)
inputDT <- as.data.table(data.frame(x = LETTERS[11:20], y = LETTERS[1:10]))
asFactorDT(inputDT, c('x', 'y'))

# }
# NOT RUN {
setRefLevelDT(inputDT)
# }
# NOT RUN {
levels(inputDT$x)[1]
levels(inputDT$y)[1]
setRefLevelDT(inputDT, c('x', 'y'), c('L', 'C'))
levels(inputDT$x)[1]
levels(inputDT$y)[1]

# }
# NOT RUN {
setRefLevelDT(inputDT, c('x', 'y'), c('bla', 'bla'))
# }
# NOT RUN {
inputDT <- as.data.table(data.frame(x = seq(1, 20, 2), y = LETTERS[1:10]))
asFactorDT(inputDT, c('y'))
levels(inputDT$y)[1]
setRefLevelDT(inputDT, 'y', 'E')
levels(inputDT$y)[1]
# }