build_regression_data: Constructs a dataframe for use in regression functions
In gwb/RGOB: Generalized Oaxaca-Blinder inference

Description Usage Arguments Details Value Examples

'build_regression_data' construct a dataframe 'dat' from 'Y' and 'X' for use in a regression such as 'lm(form, data=dat)'.

1	build_regression_data(form, Y, X)

`form`	A formula.
`Y`	A vector.
`X`	A vector or a dataframe.

The names of the columns of the dataframe constructed must correspond to the variables named in 'form', except in the case where the formula 'form' has a dot on the right-hand-side (e.g. Y1 ~ .). If 'X' is already a dataframe, not check is done. If it is a vector, then it is converted into a dataframe.

A dataframe.

## Not run: 
A <- c(1, 2)
B <- c(3, 4)
C <- c(5, 6)

X <- data.frame(X1 = B, X2 = C)

build_regression_data(Y ~ X1, A, B)
# returns:
# Y X1
# 1 3
# 2 4 

build_regression_data(Y ~ ., A, B)
# returns:
# Y X
# 1 3
# 2 4

build_regression_data(Y ~ X1 + X2, A, X)
# returns:
# Y X1 X2 
# 1 3  5  
# 2 4  6

build_regression_data(Y ~ X1, A, X)
# returns:
# Y X1 X2 
# 1 3  5  
# 2 4  6

## End(Not run)