Ë
    ÷Q(hû#  ã                   óŽ   — d Z ddlmZ ddlZddlmZmZmZm	Z	 ddl
mZ ddlmZmZ ddlmZmZ dd	lmZmZmZ  G d
„ deee«      Zy)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_fittedÚvalidate_datac            
       ó(  ‡ — e Zd ZU dZ eeddd¬«      dg e e ej                  «       «      dhz  «      e
g eeddd¬«      dg eeddd¬«      g eeddd¬«      gedgd	œZeed
<   	 dddddddœd„Zdd„Zˆ fd„Z ed¬«      dd„«       Zd„ Zˆ xZS )ÚKernelRidgea‚  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                óX   — || _         || _        || _        || _        || _        || _        y ©Nr   )Úselfr   r   r   r   r   r   s          úR/var/www/skyplay_api_hub/venv/lib/python3.12/site-packages/sklearn/kernel_ridge.pyÚ__init__zKernelRidge.__init__’   s/   € ð ˆŒ
ØˆŒØˆŒ
ØˆŒØˆŒ
Ø*ˆÕó    c                 óÊ   — t        | j                  «      r| j                  xs i }n$| j                  | j                  | j
                  dœ}t        ||f| j                  ddœ|¤ŽS )N)r   r   r   T)ÚmetricÚfilter_params)Úcallabler   r   r   r   r   r   )r#   ÚXÚYÚparamss       r$   Ú_get_kernelzKernelRidge._get_kernel£   sT   € Ü�D—K‘KÔ Ø×'Ñ'Ò-¨2‰Fà#Ÿz™z°T·[±[È4Ï:É:ÑVˆFÜ  1ÐW¨T¯[©[ÈÑWÐPVÑWÐWr&   c                 ó‚   •— t         ‰| �  «       }d|j                  _        | j                  dk(  |j                  _        |S )NTr   )ÚsuperÚ__sklearn_tags__Ú
input_tagsÚsparser   Úpairwise)r#   ÚtagsÚ	__class__s     €r$   r1   zKernelRidge.__sklearn_tags__ª   s6   ø€ Ü‰wÑ'Ó)ˆØ!%ˆ�‰ÔØ#'§;¡;°-Ñ#?ˆ�‰Ô Øˆr&   T)Úprefer_skip_nested_validationc                 ó¼  — t        | ||ddd¬«      \  }}|�t        |t        «      st        ||«      }| j	                  |«      }t        j                  | j                  «      }d}t        |j                  «      dk(  r|j                  dd«      }d}| j                  dk(  }t        |||||«      | _        |r| j                  j                  «       | _        || _        | S )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   )r   Ú
isinstanceÚfloatr   r.   ÚnpÚ
atleast_1dr   ÚlenÚshapeÚreshaper   r	   Ú
dual_coef_ÚravelÚX_fit_)r#   r+   ÚyÚsample_weightÚKr   rH   Úcopys           r$   ÚfitzKernelRidge.fit°   sÎ   € ô, Ø�!�Q nÀ4ÐSWô
‰ˆˆ1ð Ð$¬Z¸ÄuÔ-MÜ0°ÀÓBˆMà×Ñ˜QÓˆÜ—‘˜dŸj™jÓ)ˆàˆÜˆq�w‰w‹<˜1ÒØ—	‘	˜"˜aÓ ˆAØˆEà�{‰{˜mÑ+ˆÜ0°°A°u¸mÈTÓRˆŒÙØ"Ÿo™o×3Ñ3Ó5ˆDŒOàˆŒàˆr&   c                 ó®   — t        | «       t        | |dd¬«      }| j                  || j                  «      }t	        j
                  || j                  «      S )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.
        r9   F)r<   Úreset)r   r   r.   rI   rB   ÚdotrG   )r#   r+   rL   s      r$   ÚpredictzKernelRidge.predictÝ   sG   € ô  	˜ÔÜ˜$ °ÀuÔMˆØ×Ñ˜Q §¡Ó,ˆÜ�v‰v�a˜Ÿ™Ó)Ð)r&   )r   r"   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r   r   Úsetr
   Úkeysr*   Údictr   Ú__annotations__r%   r.   r1   r   rN   rR   Ú__classcell__)r6   s   @r$   r   r      sß   ø… ñrñj ˜4  D°Ô8¸,ÐGá‘sÐ9Ð4×9Ñ9Ó;Ó<À¸ÑNÓOØð
ñ ˜4  D°Ô8¸$Ð?Ù˜D ! T°&Ô9Ð:Ù˜4  t°IÔ>Ð?Ø ˜ñ
$Ð˜Dó 
ð ð+ð ØØØØô+ó"Xôñ °Ô5ò*ó 6ð*öX*r&   r   )rV   Únumbersr   ÚnumpyrB   Úbaser   r   r   r   Úlinear_model._ridger	   Úmetrics.pairwiser
   r   Úutils._param_validationr   r   Úutils.validationr   r   r   r   © r&   r$   ú<module>rd      s8   ðÙ õ
 ã ç OÓ OÝ 7ß Iß 9ß RÑ Rô_*Ð" N°Mõ _*r&   