lars(1) lars

SYNOPSIS


lars [-h] [-v] -i string -r string [-l double] [-L double] [-o string] [-c] -V

DESCRIPTION

An implementation of LARS: Least Angle Regression (Stagewise/laSso). This is a stage-wise homotopy-based algorithm for L1-regularized linear regression (LASSO) and L1+L2-regularized linear regression (Elastic Net).

Let X be a matrix where each row is a point and each column is a dimension, and let y be a vector of targets.

The Elastic Net problem is to solve

  min_beta 0.5 || X * beta - y ||_2^2 + lambda_1 ||beta||_1 +
    0.5 lambda_2 ||beta||_2^2
If lambda_1 > 0 and lambda_2 = 0, the problem is the LASSO. If lambda_1 > 0 and lambda_2 > 0, the problem is the Elastic Net. If lambda_1 = 0 and lambda_2 > 0, the problem is ridge regression. If lambda_1 = 0 and lambda_2 = 0, the problem is unregularized linear regression.

For efficiency reasons, it is not recommended to use this algorithm with lambda_1 = 0. In that case, use the 'linear_regression' program, which implements both unregularized linear regression and ridge regression.

REQUIRED OPTIONS

--input_file (-i) [string]
File containing covariates (X).
--responses_file (-r) [string]
File containing y (responses/observations).

OPTIONS

--help (-h)
Default help info.
--info [string]
Get help on a specific module or option. Default value ''.
--lambda1 (-l) [double]
Regularization parameter for l1-norm penalty. Default value 0.
--lambda2 (-L) [double]
Regularization parameter for l2-norm penalty. Default value 0.
--output_file (-o) [string]
File to save beta (linear estimator) to. Default value 'output.csv'.
--use_cholesky (-c)
Use Cholesky decomposition during computation rather than explicitly computing the full Gram matrix.
--verbose (-v)
Display informational messages and the full list of parameters and timers at the end of execution.
--version (-V)
Display the version of mlpack.

ADDITIONAL INFORMATION

For further information, including relevant papers, citations, and theory, consult the documentation found at http://www.mlpack.org or included with your distribution of MLPACK.