PoissonRegressor

classsklearn.linear_model.PoissonRegressor(*, alpha=1.0, fit_intercept=True, solver='lbfgs', max_iter=100, tol=0.0001, warm_start=False, verbose=0)[исходный код]

Обобщённая линейная модель с распределением Пуассона.

В этом регрессоре используется функция связи «log».

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

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

Параметры:

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

Константа, умножающая слагаемое штрафа L2 и определяющая силу регуляризации. alpha = 0 эквивалентно GLM без штрафа. В этом случае матрица признаков X должна иметь полный ранг по столбцам (без коллинеарности). Значения alpha должны находиться в диапазоне [0.0, inf).

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

Указывает, следует ли добавлять константу (также называемую смещением или свободным членом) к линейному предиктору (X @ coef + intercept).

solver{‘lbfgs’, ‘newton-cholesky’}, по умолчанию=’lbfgs’

Алгоритм, используемый для решения задачи оптимизации:

‘lbfgs’

Вызывает оптимизатор L-BFGS-B из scipy.

‘newton-cholesky’

Использует шаги Ньютона — Рафсона (в арифметике произвольной точности эквивалентные итеративному взвешенному методу наименьших квадратов) с внутренним решателем на основе разложения Холецкого. Этот решатель хорошо подходит для n_samples >> n_features, особенно при использовании категориальных признаков, закодированных методом one-hot, с редкими категориями. Обратите внимание, что объём памяти, используемой этим решателем, квадратично зависит от n_features, поскольку он явно вычисляет матрицу Гессе.

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

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

Максимальное число итераций решателя. Значения должны находиться в диапазоне [1, inf).

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

Критерий остановки. Для решателя lbfgs итерации прекращаются, когда max{|g_j|, j = 1, ..., d} <= tol, где g_j — j-й компонент градиента (производной) целевой функции. Значения должны находиться в диапазоне (0.0, inf).

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

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

verboseint, по умолчанию=0

Для решателя lbfgs задайте положительное значение verbose, чтобы включить подробный вывод. Значения должны находиться в диапазоне [0, inf).

Атрибуты:

coef_array формы (n_features,)

Оценённые коэффициенты линейного предиктора (X @ coef_ + intercept_) в GLM.

intercept_float

Свободный член (также называемый смещением), добавляемый к линейному предиктору.

n_features_in_int

Количество признаков, обнаруженных при обучении.

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

feature_names_in_ndarray формы (n_features_in_,)

Названия признаков, обнаруженных при обучении. Определяется только в том случае, если X содержит названия признаков, все из которых являются строками.

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

n_iter_int

Фактическое количество итераций, выполненных решателем.

См. также

TweedieRegressor

Обобщённая линейная модель с распределением Твиди.

Примеры

>>> from sklearn import linear_model
>>> clf = linear_model.PoissonRegressor()
>>> X = [[1, 2], [2, 3], [3, 4], [4, 3]]
>>> y = [12, 17, 22, 21]
>>> clf.fit(X, y)
PoissonRegressor()
>>> clf.score(X, y)
np.float64(0.990)
>>> clf.coef_
array([0.121, 0.158])
>>> clf.intercept_
np.float64(2.088)
>>> clf.predict([[1, 1], [3, 4]])
array([10.676, 21.875])

fit(X, y, sample_weight=None)[исходный код]

Обучить обобщённую линейную модель.

Параметры:

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

Обучающие данные.

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

Целевые значения.

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

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

Возвращает:

selfobject

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

get_metadata_routing()[исходный код]

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

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

Возвращает:

routingMetadataRequest

Объект MetadataRequest, содержащий сведения о маршрутизации.

get_params(deep=True)[исходный код]

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

Параметры:

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

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

Возвращает:

paramsdict

Имена параметров и соответствующие им значения.

predict(X)[исходный код]

Выполнить прогноз с помощью GLM по матрице признаков X.

Параметры:

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

Выборки.

Возвращает:

y_predarray формы (n_samples,)

Возвращает прогнозируемые значения.

score(X, y, sample_weight=None)[исходный код]

Вычислить D^2 — долю объяснённого девианса.

D^2 — это обобщение коэффициента детерминации R^2. Для R^2 используется квадратичная ошибка, а для D^2 — девианс этой GLM; см. руководство пользователя.

D^2 определяется как \(D^2 = 1-\frac{D(y_{true},y_{pred})}{D_{null}}\), где \(D_{null}\) — нулевой девианс, то есть девианс модели только со свободным членом, которой соответствует \(y_{pred} = \bar{y}\). Среднее значение \(\bar{y}\) вычисляется с учётом sample_weight. Наилучшая возможная оценка равна 1.0; она также может быть отрицательной (поскольку модель может быть сколь угодно хуже).

Параметры:

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

Тестовые выборки.

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

Истинные целевые значения.

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

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

Возвращает:

scorefloat

Значение D^2 для self.predict(X) относительно y.

set_fit_request(*, sample_weight:bool|None|str='$UNCHANGED$') → PoissonRegressor[исходный код]

Настроить, следует ли запрашивать передачу метаданных методу fit.

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

Для каждого параметра доступны следующие варианты:

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

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

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

Параметры:

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

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

Возвращает:

selfobject

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

set_params(**params)[исходный код]

Задать параметры этого оценивателя.

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

Параметры:

**paramsdict

Параметры оценивателя.

Возвращает:

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

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

set_score_request(*, sample_weight:bool|None|str='$UNCHANGED$') → PoissonRegressor[исходный код]

Настроить, следует ли запрашивать передачу метаданных методу score.

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

Для каждого параметра доступны следующие варианты:

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

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

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

Параметры:

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

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

Возвращает:

selfobject

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

Примеры из галереи

Регрессия Пуассона и ненормальная функция потерь

Регрессия Твиди для страховых претензий

Основные нововведения scikit-learn 0.23