cv.alfaslx: Spatial K-fold cross-validation for the alpha-SLX model

In CompositionalSR: Spatial Regression Models with Compositional Data

Spatial K-fold cross-validation for the \alpha-SLX model

Description

Spatial K-fold cross-validation for the \alpha-SLX model

Usage

cv.alfaslx(y, x, a = seq(0.1, 1, by = 0.1), coords, k = 2:15,
nfolds = 10, size = 1000, folds = NULL)

Arguments

y	A matrix with compositional data. zero values are allowed.
x	A matrix with the continuous predictor variables or a data frame including categorical predictor variables.
a	The value of the power transformation, it has to be between -1 and 1. If zero values are present it has to be greater than 0. If \alpha=0 the isometric log-ratio transformation is applied.
coords	A matrix with the coordinates of the locations. The first column is the latitude and the second is the longitude.
k	A vector with the nearest neighbours to consider for the contiguity matrix.
nfolds	The number of folds to split the data.
size	A numeric value of the specified range by which blocks are created and training/testing data are separated. This distance should be in metres. If you have big regions you should consider increasing this number. For more information see the package blockCV.
folds	If you have the list with the folds supply it here. You can also leave it NULL and it will create folds.

Details

The 10-fold spatial cross-validation protocol is applied to choose the optimal values of \alpha and k.

Value

A list including:

runtime	The runtime required by the cross-validation.
perf	A vector with the average Kullback-Leibler divergence, for every value of \alpha.
opt	A vector with the minimum Kullback-Leibler divergence, the optimal value of \alpha and k.

Author(s)

Michail Tsagris.

R implementation and documentation: Michail Tsagris [e-mail].

References

Tsagris M. and Pantazis Y. (2026). The \alpha–regression for compositional data: a unified framework for standard, spatially-lagged, spatial autoregressive and geographically-weighted regression models. https://arxiv.org/pdf/2510.12663

Tsagris M. (2015). Regression analysis with compositional data containing zero values. Chilean Journal of Statistics, 6(2): 47-57. https://arxiv.org/pdf/1508.01913v1.pdf

Tsagris M.T., Preston S. and Wood A.T.A. (2011). A data-based power transformation for compositional data. In Proceedings of the 4th Compositional Data Analysis Workshop, Girona, Spain. https://arxiv.org/pdf/1106.1451.pdf

See Also

alfa.slx, cv.gwar cv.alfareg

Examples

data(fadn)
coords <- fadn[1:60, 1:2]
y <- fadn[1:60, 3:7]
x <- fadn[1:60, 8]
mod <- cv.alfaslx(y, x, a = 0.5, coords, k = 2)

CompositionalSR documentation built on March 28, 2026, 5:07 p.m.