enet_path#
- sklearn.linear_model.enet_path(X, y, *, l1_ratio=0.5, eps=0.001, n_alphas=100, alphas=None, precompute='auto', Xy=None, copy_X=True, coef_init=None, verbose=False, return_n_iter=False, positive=False, check_input=True, **params)#
计算弹性网络路径使用坐标下降法。
弹性网络优化函数对于单输出和多输出任务有所不同。
对于单输出任务，它是:
1 / (2 * n_samples) * ||y - Xw||^2_2 + alpha * l1_ratio * ||w||_1 + 0.5 * alpha * (1 - l1_ratio) * ||w||^2_2
对于多输出任务，它是:
(1 / (2 * n_samples)) * ||Y - XW||_Fro^2 + alpha * l1_ratio * ||W||_21 + 0.5 * alpha * (1 - l1_ratio) * ||W||_Fro^2
其中:
||W||_21 = \sum_i \sqrt{\sum_j w_{ij}^2}
即每行的范数之和。
更多信息请参阅 用户指南 。
- Parameters:
- X{array-like, sparse matrix}，形状为 (n_samples, n_features)
训练数据。直接传递为 Fortran 连续数据以避免不必要的内存复制。如果
y是单输出，则X可以是稀疏的。- y{array-like, sparse matrix}，形状为 (n_samples,) 或 (n_samples, n_targets)
目标值。
- l1_ratiofloat, 默认=0.5
介于 0 和 1 之间的数字，传递给弹性网络（在 l1 和 l2 惩罚之间缩放）。
l1_ratio=1对应于 Lasso。- epsfloat, 默认=1e-3
路径的长度。
eps=1e-3意味着alpha_min / alpha_max = 1e-3。- n_alphasint, 默认=100
沿正则化路径的 alpha 数量。
- alphasarray-like, 默认=None
计算模型的 alpha 列表。如果为 None，则自动设置 alpha。
- precompute‘auto’, bool 或形状为 (n_features, n_features) 的 array-like, 默认=’auto’
是否使用预计算的 Gram 矩阵以加速计算。如果设置为
'auto'，则由我们决定。Gram 矩阵也可以作为参数传递。- Xy形状为 (n_features,) 或 (n_features, n_targets) 的 array-like, 默认=None
Xy = np.dot(X.T, y) 可以预计算。只有在预计算 Gram 矩阵时才有用。
- copy_Xbool, 默认=True
如果为
True，则 X 将被复制；否则，可能会被覆盖。- coef_init形状为 (n_features,) 的 array-like, 默认=None
系数的初始值。
- verbosebool 或 int, 默认=False
冗长程度。
- return_n_iterbool, 默认=False
是否返回迭代次数。
- positivebool, 默认=False
如果设置为 True，则强制系数为正。（仅在
y.ndim == 1时允许）。- check_inputbool, 默认=True
如果设置为 False，则跳过输入验证检查（包括提供的 Gram 矩阵）。假设它们由调用者处理。
- **paramskwargs
传递给坐标下降求解器的关键字参数。
- Returns:
- alphas形状为 (n_alphas,) 的 ndarray
计算模型的 alpha 路径。
- coefs形状为 (n_features, n_alphas) 或 (n_targets, n_features, n_alphas) 的 ndarray
沿路径的系数。
- dual_gaps形状为 (n_alphas,) 的 ndarray
每个 alpha 优化结束时的对偶间隙。
- n_iterslist of int
坐标下降优化器为达到指定容差所需的迭代次数。 （当
return_n_iter设置为 True 时返回）。
See also
MultiTaskElasticNet使用 L1/L2 混合范数作为正则化训练的多任务弹性网络模型。
MultiTaskElasticNetCV内置交叉验证的多任务 L1/L2 弹性网络。
ElasticNet结合 L1 和 L2 先验作为正则化的线性回归。
ElasticNetCV沿正则化路径迭代拟合的弹性网络模型。
Notes
有关示例，请参见 examples/linear_model/plot_lasso_coordinate_descent_path.py 。
Examples
>>> from sklearn.linear_model import enet_path >>> from sklearn.datasets import make_regression >>> X, y, true_coef = make_regression( ... n_samples=100, n_features=5, n_informative=2, coef=True, random_state=0 ... ) >>> true_coef array([ 0. , 0. , 0. , 97.9..., 45.7...]) >>> alphas, estimated_coef, _ = enet_path(X, y, n_alphas=3) >>> alphas.shape (3,) >>> estimated_coef array([[ 0. , 0.78..., 0.56...], [ 0. , 1.12..., 0.61...], [-0. , -2.12..., -1.12...], [ 0. , 23.04..., 88.93...], [ 0. , 10.63..., 41.56...]])
