summary.sglasso: Summarizing sglasso Fits

summary.sglassoR Documentation

Summarizing sglasso Fits

Description

summary method for class "sglasso".

Usage

## S3 method for class 'sglasso'
summary(object, N, k = c("bic","aic"), 
        digits = max(3, getOption("digits") - 3), ...)

Arguments

object

fitted sglasso object;

N

sample size;

k

character/numeric argument used to specify the 'weight' of the complexity part in the measure of goodness-of-fit used to select the best model (see below for more details). Default is k = "bic";

digits

significant digits in printout;

...

additional print arguments.

Details

summary.sglasso gives us information about the sequence of models estimated by the sglasso estimator. To select the best model, summary method uses a measure of Goodness-of-Fit (GoF) defined as follows:

-2 l(hat{ψ}) + k df,

where l(hat{ψ}) is the log-likelihood of the estimated weighted l1-penalized RCON(V, E) model, df is the number of nonzero estimated parameters and k is a non-negative value used to weight the complexity part in the measure of goodness-of-fit. By default the summary method computes the BIC criterion to select the best model (k = "bic"). The AIC criterion can be easily computed setting k = "aic". The user can also define other measures of goodness-of-fit specifying k as any non-negative value.

The output of the summary method is divided in two sections. First section shows the call producing the argument object followed by a data.frame. The column named rho shows the sequence of the ρ values used to compute the solution curve, while the column log-lik shows the corresponding values of the log-likelihood function. The remaining columns show the number of estimated non-zero parameters, the values of the GoF and the asscoated ranking of the estimated models. Finally, the second section shows the estimated parameters of the best model identified by the used GoF criterion. Informations about the algorithm and the corresponding convergence are also provided.

Value

A list with components table and theta_gof is silently returned. The table component is the data.frame previously described while the component theta_gof is the vector of the estimated parameters corresponding to the best models identified by the GoF criterion.

Author(s)

Luigi Augugliaro
Maintainer: Luigi Augugliaro luigi.augugliaro@unipa.it

See Also

sglasso and loglik functions.

Examples

N <- 100
p <- 5
X <- matrix(rnorm(N * p), N, p)
S <- crossprod(X) / N
mask <- outer(1:p, 1:p, function(i,j) 0.5^abs(i-j))
mask[1,5] <- mask[1,4] <- mask[2,5] <- NA
mask[5,1] <- mask[4,1] <- mask[5,2] <- NA
out.sglasso_path <- sglasso(S, mask, tol = 1.0e-13)
summary(out.sglasso_path, N)
rho <- out.sglasso_path$rho[20]
out.sglasso <- sglasso(S, mask, nrho = 1, min_rho = rho, tol = 1.0e-13)
summary(out.sglasso, N)

sglasso documentation built on Sept. 22, 2022, 5:06 p.m.