Learn R Programming

matrixpls (version 1.0.13)

matrixpls.crossvalidate: 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.

Value

A matrix containing predictions calculated with cross-validation.

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.

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<U+2013>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<U+2013>336). Mahwah, NJ: Lawrence Erlbaum Associates Publishers.