ó
    ¦ñ:i³#  ã                   óŠ   • S r SSKJr  SSKrSSKJrJrJrJ	r	  SSK
Jr  SSKJrJr  SSKJrJr  SS	KJrJr   " S
 S\\\5      rg)zKernel ridge regression.é    )ÚRealNé   )ÚBaseEstimatorÚMultiOutputMixinÚRegressorMixinÚ_fit_context)Ú_solve_cholesky_kernel)ÚPAIRWISE_KERNEL_FUNCTIONSÚpairwise_kernels)ÚIntervalÚ
StrOptions)Ú_check_sample_weightÚcheck_is_fittedc                   ó  • \ rS rSr% Sr\" \SSSS9S/\" \" \	R                  " 5       5      S1-  5      \/\" \SSSS9S/\" \SSSS9/\" \SSS	S9/\S/S
.r\\S'    SSSSSSS.S jjrSS jrS r\" SS9SS j5       rS rSrg)ÚKernelRidgeé   a  Kernel ridge regression.

Kernel ridge regression (KRR) combines ridge regression (linear least
squares with l2-norm regularization) with the kernel trick. It thus
learns a linear function in the space induced by the respective kernel and
the data. For non-linear kernels, this corresponds to a non-linear
function in the original space.

The form of the model learned by KRR is identical to support vector
regression (SVR). However, different loss functions are used: KRR uses
squared error loss while support vector regression uses epsilon-insensitive
loss, both combined with l2 regularization. In contrast to SVR, fitting a
KRR model can be done in closed-form and is typically faster for
medium-sized datasets. On the other hand, the learned model is non-sparse
and thus slower than SVR, which learns a sparse model for epsilon > 0, at
prediction-time.

This estimator has built-in support for multi-variate regression
(i.e., when y is a 2d-array of shape [n_samples, n_targets]).

Read more in the :ref:`User Guide <kernel_ridge>`.

Parameters
----------
alpha : float or array-like of shape (n_targets,), default=1.0
    Regularization strength; must be a positive float. Regularization
    improves the conditioning of the problem and reduces the variance of
    the estimates. Larger values specify stronger regularization.
    Alpha corresponds to ``1 / (2C)`` in other linear models such as
    :class:`~sklearn.linear_model.LogisticRegression` or
    :class:`~sklearn.svm.LinearSVC`. If an array is passed, penalties are
    assumed to be specific to the targets. Hence they must correspond in
    number. See :ref:`ridge_regression` for formula.

kernel : str or callable, default="linear"
    Kernel mapping used internally. This parameter is directly passed to
    :class:`~sklearn.metrics.pairwise.pairwise_kernels`.
    If `kernel` is a string, it must be one of the metrics
    in `pairwise.PAIRWISE_KERNEL_FUNCTIONS` or "precomputed".
    If `kernel` is "precomputed", X is assumed to be a kernel matrix.
    Alternatively, if `kernel` is a callable function, it is called on
    each pair of instances (rows) and the resulting value recorded. The
    callable should take two rows from X as input and return the
    corresponding kernel value as a single number. This means that
    callables from :mod:`sklearn.metrics.pairwise` are not allowed, as
    they operate on matrices, not single samples. Use the string
    identifying the kernel instead.

gamma : float, default=None
    Gamma parameter for the RBF, laplacian, polynomial, exponential chi2
    and sigmoid kernels. Interpretation of the default value is left to
    the kernel; see the documentation for sklearn.metrics.pairwise.
    Ignored by other kernels.

degree : float, default=3
    Degree of the polynomial kernel. Ignored by other kernels.

coef0 : float, default=1
    Zero coefficient for polynomial and sigmoid kernels.
    Ignored by other kernels.

kernel_params : dict, default=None
    Additional parameters (keyword arguments) for kernel function passed
    as callable object.

Attributes
----------
dual_coef_ : ndarray of shape (n_samples,) or (n_samples, n_targets)
    Representation of weight vector(s) in kernel space

X_fit_ : {ndarray, sparse matrix} of shape (n_samples, n_features)
    Training data, which is also required for prediction. If
    kernel == "precomputed" this is instead the precomputed
    training matrix, of shape (n_samples, n_samples).

n_features_in_ : int
    Number of features seen during :term:`fit`.

    .. versionadded:: 0.24

feature_names_in_ : ndarray of shape (`n_features_in_`,)
    Names of features seen during :term:`fit`. Defined only when `X`
    has feature names that are all strings.

    .. versionadded:: 1.0

See Also
--------
sklearn.gaussian_process.GaussianProcessRegressor : Gaussian
    Process regressor providing automatic kernel hyperparameters
    tuning and predictions uncertainty.
sklearn.linear_model.Ridge : Linear ridge regression.
sklearn.linear_model.RidgeCV : Ridge regression with built-in
    cross-validation.
sklearn.svm.SVR : Support Vector Regression accepting a large variety
    of kernels.

References
----------
* Kevin P. Murphy
  "Machine Learning: A Probabilistic Perspective", The MIT Press
  chapter 14.4.3, pp. 492-493

Examples
--------
>>> from sklearn.kernel_ridge import KernelRidge
>>> import numpy as np
>>> n_samples, n_features = 10, 5
>>> rng = np.random.RandomState(0)
>>> y = rng.randn(n_samples)
>>> X = rng.randn(n_samples, n_features)
>>> krr = KernelRidge(alpha=1.0)
>>> krr.fit(X, y)
KernelRidge(alpha=1.0)
r   NÚleft)Úclosedz
array-likeÚprecomputedÚneither©ÚalphaÚkernelÚgammaÚdegreeÚcoef0Úkernel_paramsÚ_parameter_constraintsr   Úlinearé   )r   r   r   r   r   c                óL   • Xl         X l        X0l        X@l        XPl        X`l        g ©Nr   )Úselfr   r   r   r   r   r   s          ÚW/srv/projetos/modelo_ml_acdoc/venv/lib/python3.13/site-packages/sklearn/kernel_ridge.pyÚ__init__ÚKernelRidge.__init__’   s#   € ð Œ
ØŒØŒ
ØŒØŒ
Ø*Õó    c                 óÜ   • [        U R                  5      (       a  U R                  =(       d    0 nO$U R                  U R                  U R
                  S.n[        X4U R                  SS.UD6$ )N)r   r   r   T)ÚmetricÚfilter_params)Úcallabler   r   r   r   r   r   )r#   ÚXÚYÚparamss       r$   Ú_get_kernelÚKernelRidge._get_kernel£   sU   € Ü�D—K‘K× Ñ Ø×'Ñ'×-¨2‰Fà#Ÿz™z°T·[±[È4Ï:É:ÑVˆFÜ ÐW¨T¯[©[ÈÑWÐPVÑWÐWr'   c                 ó$   • SU R                   S:H  0$ )NÚpairwiser   )r   )r#   s    r$   Ú
_more_tagsÚKernelRidge._more_tagsª   s   € Ø˜DŸK™K¨=Ñ8Ð9Ð9r'   T)Úprefer_skip_nested_validationc                 óÎ  • U R                  XSSSS9u  pUb   [        U[        5      (       d  [        X15      nU R	                  U5      n[
        R                  " U R                  5      nSn[        UR                  5      S:X  a  UR                  SS5      nSnU R                  S:H  n[        XBXSU5      U l        U(       a  U R                  R                  5       U l        Xl        U $ )a  Fit Kernel Ridge regression model.

Parameters
----------
X : {array-like, sparse matrix} of shape (n_samples, n_features)
    Training data. If kernel == "precomputed" this is instead
    a precomputed kernel matrix, of shape (n_samples, n_samples).

y : array-like of shape (n_samples,) or (n_samples, n_targets)
    Target values.

sample_weight : float or array-like of shape (n_samples,), default=None
    Individual weights for each sample, ignored if None is passed.

Returns
-------
self : object
    Returns the instance itself.
©ÚcsrÚcscT)Úaccept_sparseÚmulti_outputÚ	y_numericFr   éÿÿÿÿr   )Ú_validate_dataÚ
isinstanceÚfloatr   r/   ÚnpÚ
atleast_1dr   ÚlenÚshapeÚreshaper   r	   Ú
dual_coef_ÚravelÚX_fit_)r#   r,   ÚyÚsample_weightÚKr   rG   Úcopys           r$   ÚfitÚKernelRidge.fit­   sÍ   € ð, ×"Ñ"Ø ¸TÈTð #ð 
‰ˆð Ñ$¬Z¸Äu×-MÑ-MÜ0°ÓBˆMà×Ñ˜QÓˆÜ—’˜dŸj™jÓ)ˆàˆÜˆq�w‰w‹<˜1ÓØ—	‘	˜"˜aÓ ˆAØˆEà�{‰{˜mÑ+ˆÜ0°°uÈTÓRˆŒÞØ"Ÿo™o×3Ñ3Ó5ˆDŒOàŒàˆr'   c                 ó°   • [        U 5        U R                  USSS9nU R                  XR                  5      n[        R
                  " X R                  5      $ )aÉ  Predict using the kernel ridge model.

Parameters
----------
X : {array-like, sparse matrix} of shape (n_samples, n_features)
    Samples. If kernel == "precomputed" this is instead a
    precomputed kernel matrix, shape = [n_samples,
    n_samples_fitted], where n_samples_fitted is the number of
    samples used in the fitting for this estimator.

Returns
-------
C : ndarray of shape (n_samples,) or (n_samples, n_targets)
    Returns predicted values.
r7   F)r:   Úreset)r   r>   r/   rH   rA   ÚdotrF   )r#   r,   rK   s      r$   ÚpredictÚKernelRidge.predictÚ   sJ   € ô  	˜ÔØ×Ñ °ÀuÐÐMˆØ×Ñ˜Q§¡Ó,ˆÜ�vŠv�aŸ™Ó)Ð)r'   )rH   r   r   r   rF   r   r   r   )r   r"   )Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__doc__r   r   r   Úsetr
   Úkeysr+   Údictr   Ú__annotations__r%   r/   r3   r   rM   rR   Ú__static_attributes__© r'   r$   r   r      sÛ   ‡ ñrñj ˜4  D°Ñ8¸,ÐGá‘sÐ4×9Ò9Ó;Ó<À¸ÑNÓOØð
ñ ˜4  D°Ñ8¸$Ð?Ù˜D ! T°&Ñ9Ð:Ù˜4  t°IÑ>Ð?Ø ˜ñ
$Ð˜Dó 
ð ð+ð ØØØØö+ô"Xò:ñ °Ñ5ó*ó 6ð*õX*r'   r   )rX   Únumbersr   ÚnumpyrA   Úbaser   r   r   r   Úlinear_model._ridger	   Úmetrics.pairwiser
   r   Úutils._param_validationr   r   Úutils.validationr   r   r   r^   r'   r$   Ú<module>rf      s5   ðÙ õ
 ã ç OÓ OÝ 7ß Iß 9ß Cô\*Ð" N°Mõ \*r'   