matrixpls.crossvalidate: Cross-validation of predictions from matrixpls results

In mronkko/matrixpls: Matrix-Based Partial Least Squares Estimation

Cross-validation of predictions from matrixpls results

Description

matrixpls.crossvalidate Calculates cross-validation predictions using matrixpls.

Usage

matrixpls.crossvalidate(
  data,
  model,
  ...,
  predictFun = stats::predict,
  nGroup = 4,
  blindfold = FALSE,
  imputationFun = NULL
)

Arguments

data	Matrix or data frame containing the raw data.
model	There are two options for this argument: 1. lavaan script or lavaan parameter table, or 2. a list containing three matrices inner, reflective, and formative defining the free regression paths in the model.
...	All other arguments are passed through to matrixpls and predictFun.
predictFun	The function used to calculate the predictions.
nGroup	The number of groups to divide the data into.
blindfold	Whether blindfolding should be used instead of holdout sample cross-validation.
imputationFun	The function used to impute missing data before blindfold prediction. If NULL, simple mean substitution is used.

Details

In cross-validation, some elements of the data matrix are set to missing and then predicted based on the remaining observations. The process is repeated until all elements of the data have been predicted.

Cross-validation is typically applied by dividing the data into two groups, the training sample and the validation sample. The prediction model is calculated based on the training sample and used to calculate predictions for the validation sample.

In blindfolding, the data are not omitted case wise, but elements of the data are omitted diagonally. After this, imputation is applied to missing data and the prediction model is calibrated with the dataset containing also the imputations. The imputed values are then predicted with the model.

Value

A matrix containing predictions calculated with cross-validation.

References

Chin, W. W. (2010). How to write up and report PLS analyses. In V. Esposito Vinzi, W. W. Chin, J. Henseler, & H. Wang (Eds.), Handbook of partial least squares (pp. 655–690). Berlin Heidelberg: Springer.

Chin, W. W. (1998). The partial least squares approach to structural equation modeling. In G. A. Marcoulides (Ed.), Modern methods for business research (pp. 295–336). Mahwah, NJ: Lawrence Erlbaum Associates Publishers.

mronkko/matrixpls documentation built on Aug. 5, 2022, 8:21 a.m.