Kv: List, includes the eigenvalues and eigenvectors of the positive definite Gram matrices Kv,v=1,...,vMax and their associated group names. It should have the same format as the output of the function calc_Kv (see details).
gamma: Vector of positive scalars. Values of the penalty parameter γ in decreasing order.
mu: Vector of positive scalars. Values of the penalty parameter μ in decreasing order.
resg: List of initial parameters, includes the RKHSgrplasso objects for each value of the penalty parameter μ.
gama_v: Scalar zero or vector of vMax positive scalars, considered as weights for the Ridge penalty. Set to zero, to consider no weights, i.e. all weights equal to 1.
mu_v: Scalar zero or a vector with vMax scalars, considered as weigths of Sparse Group penalty. Set to zero, to consider no weights, i.e. all weights equal to 1.
maxIter: Integer, shows the maximum number of loops through initial active groups at the first step and maximum number of loops through all groups at the second step. Set as 1000 by default.
verbose: Logical, if TRUE, for each pair of penalty parameters (μ,γ) it prints: the number of current iteration, active groups and convergence criterias. Set as FALSE by default.
calcStwo: Logical, if TRUE, the program does a second step after convergence: the algorithm is done over all groups by taking the estimated parameters at the first step as initial values. Set as FALSE by default.
Details
Input Kv should contain the eigenvalues and eigenvectors of positive definite Gram matrices Kv. It is necessary to set input "correction" in the function calc_Kv equal to "TRUE".
Returns
List of l components, with l equals to the number of pairs of the penalty parameters (μ,γ). Each component of the list is a list of 3 components "mu", "gamma" and "Meta-Model": - mu: Positive scalar, an element of the input vector mu associated with the estimated Meta-Model.
gamma: Positive scalar, an element of the input vector gamma associated with the estimated Meta-Model.
Meta-Model: Estimated meta model associated with penalty parameters mu and gamma. List of 16 components:
intercept: Scalar, estimated value of intercept.
teta: Matrix with vMax rows and n columns. Each row of the matrix is the estimated vector θv for v=1,...,vMax.
fit.v: Matrix with n rows and vMax columns. Each row of the matrix is the estimated value of fv=Kvθv.
fitted: Vector of size n, indicates the estimator of m.
Norm.n: Vector of size vMax, estimated values for the Ridge penalty norm.
Norm.H: Vector of size vMax, estimated values for the Group Sparse penalty norm.
supp: Vector of active groups.
Nsupp: Vector of the names of the active groups.
SCR: Scalar equals to ∥Y−f0−∑vKvθv∥2.
crit: Scalar indicates the value of the penalized criteria.
gamma.v: Vector of size vMax, coefficients of the Ridge penalty norm, nγ×gama_v.
mu.v: Vector of size vMax, coefficients of the Group Sparse penalty norm, nμ×mu_v.
iter: List of three components if calcStwo=TRUE (two components if calcStwo=FALSE): maxIter, number of iterations until convergence is reached at first step and the number of iterations until convergence is reached at second step (maxIter, and the number of iterations until convergence is reached at first step).
convergence: TRUE or FALSE. Indicates whether the algorithm has converged or not.
RelDiffCrit: List of two components if calcStwo=TRUE (one component if calcStwo=FALSE): value of convergence criteria at the last iteration of each step, ∥θlastIter−1θlastIter−θlastIter−1∥2.
RelDiffPar: List of two components if calcStwo=TRUE (one component if calcStwo=FALSE): value of convergence criteria at the last iteration, critlastIter−1critlastIter−critlastIter−1 of each step.
References
Huet, S. and Taupin, M. L. (2017) Metamodel construction for sensitivity analysis. ESAIM: Procs 60, 27-69.
Kamari, H., Huet, S. and Taupin, M.-L. (2019) RKHSMetaMod : An R package to estimate the Hoeffding decomposition of an unknown function by solving RKHS Ridge Group Sparse optimization problem. arXiv:1905.13695