Многозадачная эластичная сеть

classsklearn.linear_model.MultiTaskElasticNet(alpha=1.0, *, l1_ratio=0.5, fit_intercept=True, copy_X=True, max_iter=1000, tol=0.0001, warm_start=False, random_state=None, selection='cyclic')[source]

Модель многозадачного ElasticNet, обученная с использованием смешанной L1/L2 нормы в качестве регуляризатора.

Целевая функция оптимизации для MultiTaskElasticNet:

(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)

т.е. сумма норм каждой строки.

Подробнее см. в Руководстве пользователя.

Параметры:

alphafloat, по умолчанию=1.0

Постоянная, которая умножает член L1/L2. По умолчанию 1.0.

l1_ratiofloat, по умолчанию=0.5

Параметр смешивания ElasticNet, при 0 < l1_ratio <= 1. При l1_ratio = 1 штраф представляет собой штраф L1/L2. При l1_ratio = 0 это штраф L2. При 0 < l1_ratio < 1, штраф представляет собой комбинацию L1/L2 и L2.

fit_interceptbool, по умолчанию=True

Вычислять ли свободный член для этой модели. Если установлено в false, в расчетах свободный член не будет использоваться (т.е. данные предполагаются центрированными).

copy_Xbool, по умолчанию=True

Если True, X будет скопирован; иначе, он может быть перезаписан.

max_iterint, по умолчанию=1000

Максимальное число итераций.

tolfloat, по умолчанию=1e-4

Допуск для оптимизации: если обновления меньше, чем tol, код оптимизации проверяет двойную щель на оптимальность и продолжает до тех пор, пока она не станет меньше, чем tol.

warm_startbool, по умолчанию=False

Если установлено в True, повторно использовать решение предыдущего вызова fit в качестве начального значения, в противном случае просто стереть предыдущее решение. См. Словарь.

random_stateint, RandomState instance, по умолчанию=None

Зерно псевдогенератора случайных чисел, выбирающего случайный признак для обновления. Используется, когда selection == ‘random’. Передайте целое число для воспроизводимых результатов при нескольких вызовах функции. См. Словарь.

selection{‘cyclic’, ‘random’}, по умолчанию=’cyclic’

Если установлено в ‘random’, то в каждой итерации обновляется случайный коэффициент вместо последовательного перебора признаков по умолчанию. Это (установка в ‘random’) часто приводит к значительно более быстрому сходимости, особенно когда tol больше, чем 1e-4.

Атрибуты:

intercept_ndarray of shape (n_targets,)

Свободный член в функции принятия решений.

coef_ndarray of shape (n_targets, n_features)

Вектор параметров (W в формуле функции стоимости). Если в fit передается одномерный y (не многозадачный случай), coef_ является одномерным массивом. Обратите внимание, что coef_ хранит транспонированный W, W.T.

n_iter_int

Количество итераций, выполненных решателем градиентного спуска для достижения заданной точности.

dual_gap_float

Двойная щель в конце оптимизации.

eps_float

Допуск, масштабированный на дисперсию целевого y.

sparse_coef_разреженная матрица формы (n_features,) или (n_targets, n_features)

Разреженное представление полученных coef_.

n_features_in_int

Количество признаков, увиденных во время fit.

Добавлен в версии 0.24.

feature_names_in_ndarray of shape (n_features_in_,)

Имена признаков, увиденные во время fit. Определяются только тогда, когда у X есть имена признаков, которые все являются строками.

Добавлен в версии 1.0.

См. также

MultiTaskElasticNetCV

Многозадачный L1/L2 ElasticNet с встроенной кросс-валидацией.

ElasticNet

Линейная регрессия с комбинированными L1 и L2 приоритетами в качестве регуляризатора.

MultiTaskLasso

Модель многозадачного Lasso, обученная с использованием смешанной L1/L2 нормы в качестве регуляризатора.

Примечания

Алгоритм, используемый для обучения модели, — это метод координатного спуска.

Для предотвращения ненужного дублирования памяти аргументы X и y метода fit должны быть непосредственно переданы в виде Fortran-непрерывных массивов numpy.

Примеры

>>> from sklearn import linear_model
>>> clf = linear_model.MultiTaskElasticNet(alpha=0.1)
>>> clf.fit([[0,0], [1, 1], [2, 2]], [[0, 0], [1, 1], [2, 2]])
MultiTaskElasticNet(alpha=0.1)
>>> print(clf.coef_)
[[0.45663524 0.45612256]
 [0.45663524 0.45612256]]
>>> print(clf.intercept_)
[0.0872422 0.0872422]

fit(X, y)[source]

Обучение модели MultiTaskElasticNet с помощью координатного спуска.

Параметры:

Xndarray of shape (n_samples, n_features)

Данные.

yndarray of shape (n_samples, n_targets)

Цель. Будет приведено к типу X, если необходимо.

Возвращает:

selfobject

Обученная модель.

Примечания

Координатный спуск — это алгоритм, который рассматривает каждый столбец данных по одному, поэтому он автоматически преобразует вход X в Fortran-непрерывный массив numpy, если необходимо.

Для избежания повторной выделения памяти рекомендуется выделить исходные данные в памяти непосредственно в этом формате.

get_metadata_routing()[source]

Получить маршрутизацию метаданных этого объекта.

Пожалуйста, ознакомьтесь с Руководством пользователя о том, как работает механизм маршрутизации.

Возвращает:

routingMetadataRequest

MetadataRequest encapsulating routing information.

get_params(deep=True)[source]

Получить параметры этого оценщика.

Параметры:

deepbool, по умолчанию=True

Если True, вернет параметры этого оценщика и содержащихся в нем подобъектов, являющихся оценщиками.

Возвращает:

paramsdict

Имена параметров, сопоставленные со значениями.

staticpath(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)[source]

Вычисление пути эластичной сети с помощью метода координатного спуска.

Функция оптимизации эластичной сети различается для одновыходных и многовыходных задач.

Для одновыходных задач она имеет вид:

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}

т.е. сумма норм каждой строки.

Дополнительную информацию см. в Руководстве пользователя.

Параметры:

X{array-like, разреженная матрица} формы (n_samples, n_features)

Данные обучения. Передаются напрямую как данные в формате Fortran, чтобы избежать ненужного дублирования памяти. Если y является одновыходной, то X может быть разреженной.

y{array-like, разреженная матрица} формы (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

Количество альфа-значений вдоль пути регуляризации.

alphasarray-like, по умолчанию=None

Список альфа-значений, где вычисляются модели. Если None, альфа-значения устанавливаются автоматически.

precompute‘auto’, bool или array-like формы (n_features, n_features), по умолчанию=’auto’

Использовать ли предварительно вычисленную грамитовую матрицу для ускорения вычислений. Если значение равно 'auto' , мы решим сами. Грамитовую матрицу также можно передать в качестве аргумента.

Xyarray-like формы (n_features,) или (n_features, n_targets), по умолчанию=None

Xy = np.dot(X.T, y), которое можно предварительно вычислить. Оно полезно только при предварительном вычислении грамитовой матрицы.

copy_Xbool, по умолчанию=True

Если True, X будет скопирован; иначе, он может быть перезаписан.

coef_initarray-like формы (n_features, ), по умолчанию=None

Начальные значения коэффициентов.

verbosebool или int, по умолчанию=False

Уровень подробности.

return_n_iterbool, по умолчанию=False

Возвращать ли количество итераций.

positivebool, по умолчанию=False

Если True, принудительно устанавливает коэффициенты положительными. (Допускается только при y.ndim == 1).

check_inputbool, по умолчанию=True

Если False, проверки входных данных пропускаются (включая грамитовую матрицу, если она предоставлена). Предполагается, что они обрабатываются вызывающим объектом.

**paramskwargs

Дополнительные аргументы, передаваемые решателю координатного спуска.

Возвращаемое значение:

alphasndarray формы (n_alphas,)

Альфа-значения вдоль пути, где вычисляются модели.

coefsndarray формы (n_features, n_alphas) или (n_targets, n_features, n_alphas)

Коэффициенты вдоль пути.

dual_gapsndarray формы (n_alphas,)

Двойные зазоры в конце оптимизации для каждого альфа-значения.

n_itersсписок int

Количество итераций, потраченное оптимизатором координатного спуска для достижения заданной толерантности для каждого альфа-значения. (Возвращается, когда return_n_iter имеет значение True).

См. также

MultiTaskElasticNet

Модель многозадачной эластичной сети, обученная с использованием смешанной L1/L2-нормы в качестве регуляризатора.

MultiTaskElasticNetCV

Многозадачная L1/L2 эластичная сеть с интегрированной кросс-валидацией.

ElasticNet

Линейная регрессия с комбинированными L1 и L2 приорами в качестве регуляризатора.

ElasticNetCV

Модель эластичной сети с итеративной подгонкой вдоль пути регуляризации.

Примечания

Для примера см. примеры/linear_model/plot_lasso_lasso_lars_elasticnet_path.py.

Примеры

>>> 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...]])

predict(X)[source]

Предсказание с использованием линейной модели.

Параметры:

Xarray-like или разреженная матрица, форма (n_samples, n_features)

Образцы.

Возвращаемое значение:

Cмассив, форма (n_samples,)

Возвращает предсказанные значения.

score(X, y, sample_weight=None)[source]

Возвращает коэффициент детерминации предсказания.

Коэффициент детерминации \(R^2\) определяется как \((1 - \frac{u}{v})\), где \(u\) — остаточная сумма квадратов ((y_true - y_pred)** 2).sum() и \(v\) — общая сумма квадратов ((y_true - y_true.mean()) ** 2).sum(). Лучшее возможное значение — 1.0, и оно может быть отрицательным (поскольку модель может быть произвольно хуже). Постоянная модель, которая всегда предсказывает ожидаемое значение y, игнорируя входные признаки, получит значение \(R^2\) равное 0.0.

Параметры:

Xarray-like формы (n_samples, n_features)

Тестовые выборки. Для некоторых оценщиков это может быть предварительно вычисленный ядро матрица или список общих объектов вместо с формой (n_samples, n_samples_fitted), где n_samples_fitted — количество выборок, используемых при подгонке для оценщика.

yarray-like формы (n_samples,) или (n_samples, n_outputs)

Истинные значения для X.

sample_weightarray-like формы (n_samples,), по умолчанию None

Веса выборок.

Возвращает:

scorefloat

\(R^2\) self.predict(X) относительно y.

Примечания

Значение \(R^2\), используемое при вызове score для регрессора, использует multioutput='uniform_average' начиная с версии 0.23, чтобы сохранить согласованность с значением по умолчанию r2_score. Это влияет на метод score всех регрессоров с несколькими выходами (кроме MultiOutputRegressor).

set_fit_request(*, sample_weight:bool|None|str='$UNCHANGED$') → MultiTaskElasticNet[source]

Запрос метаданных, передаваемых методу fit.

Обратите внимание, что этот метод актуален только если enable_metadata_routing=True (см. sklearn.set_config). Пожалуйста, ознакомьтесь с Руководством пользователя о том, как работает механизм маршрутизации.

Варианты для каждого параметра:

• True: метаданные запрашиваются и передаются fit при их наличии. Запрос игнорируется, если метаданные отсутствуют.
• False: метаданные не запрашиваются, и метаоценщик не будет передавать их fit.
• None: метаданные не запрашиваются, и метаоценщик выдаст ошибку, если пользователь их предоставит.
• str: метаданные должны передаваться метаоценщику с данным псевдонимом вместо исходного имени.

По умолчанию (sklearn.utils.metadata_routing.UNCHANGED) сохраняется существующий запрос. Это позволяет изменить запрос для некоторых параметров и не для других.

Добавлена в версии 1.3.

Примечание

Этот метод актуален только если данный оценщик используется в качестве под-оценщика мета-оценщика, например, внутри Pipeline. В противном случае он не имеет эффекта.

Параметры:

sample_weightstr, True, False, или None, по умолчанию sklearn.utils.metadata_routing.UNCHANGED

Маршрутизация метаданных для параметра sample_weight в fit.

Возвращает:

selfобъект

Обновленный объект.

set_params(**params)[source]

Устанавливает параметры этого оценщика.

Метод работает как с простыми оценщиками, так и со вложенными объектами (такими как Pipeline). Последние имеют параметры вида <component>__<parameter>, что позволяет обновлять каждый компонент вложенного объекта.

Параметры:

**paramsdict

Параметры оценщика.

Возвращает:

selfэкземпляр оценщика

Экземпляр оценщика.

set_score_request(*, sample_weight:bool|None|str='$UNCHANGED$') → MultiTaskElasticNet[source]

Запрос метаданных, передаваемых методу score.

Обратите внимание, что этот метод актуален только если enable_metadata_routing=True (см. sklearn.set_config). Пожалуйста, ознакомьтесь с Руководством пользователя, чтобы узнать, как работает механизм маршрутизации.

Варианты для каждого параметра:

• True: метаданные запрашиваются и передаются в score при наличии. Запрос игнорируется, если метаданные не предоставлены.
• False: метаданные не запрашиваются, и мета-оценщик не будет передавать их в score.
• None: метаданные не запрашиваются, и мета-оценщик выдаст ошибку, если пользователь их предоставит.
• str: метаданные должны передаваться мета-оценщику с этим псевдонимом вместо исходного имени.

По умолчанию (sklearn.utils.metadata_routing.UNCHANGED): сохраняется существующий запрос. Это позволяет изменить запрос для некоторых параметров, а не для других.

Добавлена в версии 1.3.

Примечание

Этот метод актуален только если данный оценочный модуль используется в качестве подмодуля мета-оценщика, например, внутри Pipeline. В противном случае он не имеет эффекта.

Parameters:

sample_weightstr, True, False, or None, default=sklearn.utils.metadata_routing.UNCHANGED

Маршрутизация метаданных для параметра sample_weight в score.

Returns:

selfobject

Объект с обновлёнными настройками.

propertysparse_coef_

Разреженное представление обученного coef_.