Make Model Matrix from Data Frame
makeind.RdConverts a data frame with numeric and factor contents into a matrix, suitable for use with bartBT. Unlike in linear regression, factors containing more than two levels result in dummy variables being created for each level.
Usage
makeModelMatrixFromDataFrame(x, drop = TRUE)
makeind(x, all = TRUE)
makeTestModelMatrix(data, newdata)Arguments
- x
Data frame of explanatory variables. A column may be a
Matrix::sparseVector,dgCMatrix, orsparseFactor(assigned into the frame; such columns do not survivedata.frame(...)orI()); see ‘Value’.- drop
Logical or list controlling whether or not columns that are constants or factor levels with no instances are omitted from the result. When a list, must be of length equal to
x. Elements correspond toxaccording to:vector - single logical
matrix - vector of logicals, one per column
factor - table of factor levels to be referenced; levels with counts of 0 are to be dropped
A test frame must give each factor the training frame's levels, in their order: the helper codes a factor by position, where the fit's own
predictcodes by label.- all
Not currently implemented; retained for signature compatibility with
BayesTree::makeind.- data
An existing
dbartsDataobject, built with or without its frame.- newdata
Test data frame.
makeTestModelMatrixrefuses it, naming the column, if it carriesNAin a column the fit's training data did not: a split rule learns a route forNAonly where its column had missing training values.
Details
Character vectors are included as factors. If you have numeric data coded as characters, convert it using as.numeric first.
Note that if you have train and test data frames, it may be best to rbind the two together, apply makeModelMatrixFromDataFrame to the result, and then pull them back apart. Alternatively, save the drop attribute used in creating the training data and use it when creating a matrix from the test data, as in the example given below.
Use of these functions is not required when using bartBT, bart, or dbartsSampler; they exist to allow the user finer control and to assist with writing packages that separate the creation of training from test data.
Value
A matrix with columns corresponding to the elements of the data frame. If drop = TRUE or is a list, the attribute drop on the result is set to the list used when creating the matrix.
If any column of x is sparse-backed (a Matrix::sparseVector, dgCMatrix, or sparseFactor), the result is instead an object of class dbartsMixedMatrix - not a matrix (is.matrix() is FALSE) - which keeps sparse columns unexpanded rather than densifying them. Call as.matrix on it to obtain an ordinary dense matrix.
Author
Vincent Dorie: vdorie@gmail.com.
Examples
iv <- 1:10
rv <- runif(10)
f <- factor(rep(seq.int(3), c(4L, 4L, 2L)),
labels = c("alice", "bob", "charlie"))
df <- data.frame(iv, rv, f)
mm <- makeModelMatrixFromDataFrame(df)
## create test and train matrices with disjoint factor levels
train.df <- df[1:8,]
test.df <- df[9:10,]
train.mm <- makeModelMatrixFromDataFrame(train.df)
test.mm <- makeModelMatrixFromDataFrame(test.df, attr(train.mm, "drop"))