§
    qŠtj‘�  ã            
       ó~  — d Z ddlZddlmZmZ ddlmZmZ ddlZ	ddl
mZmZ ddlmZmZ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 ddlmZm Z m!Z! g d¢Z"d„ Z#	 d"d„Z$d„ Z%d#d„Z&d„ Z' G d„ deeeeee¬¦  «        Z( G d„ de(¦  «        Z) G d„ de(¦  «        Z* G d„ de(¦  «        Z+ G d „ d!eee¦  «        Z,dS )$zG
The :mod:`sklearn.pls` module implements Partial Least Squares (PLS).
é    N)ÚABCMetaÚabstractmethod)ÚIntegralÚReal)ÚpinvÚsvd)ÚBaseEstimatorÚClassNamePrefixFeaturesOutMixinÚMultiOutputMixinÚRegressorMixinÚTransformerMixinÚ_fit_context)ÚConvergenceWarning)Úcheck_arrayÚcheck_consistent_length)ÚIntervalÚ
StrOptions)Úsvd_flip)ÚFLOAT_DTYPESÚcheck_is_fittedÚvalidate_data)ÚPLSSVDÚPLSCanonicalÚPLSRegressionc           
      óÊ  — t          | dd¬¦  «        \  }}}|j        j                             ¦   «         }dddœ}t	          j        |¦  «        ||         z  t	          j        |¦  «        j        z  }t	          j        ||k    ¦  «        }|d d …d |…f         }||d |…         z  }t	          j	        t	          j
        t	          j        ||d |…         ¦  «        ¦  «        ¦  «        S )NF)Úfull_matricesÚcheck_finiteg     @�@g    €„.A)ÚfÚd)r   ÚdtypeÚcharÚlowerÚnpÚmaxÚfinfoÚepsÚsumÚ	transposeÚ	conjugateÚdot)ÚaÚuÚsÚvhÚtÚfactorÚcondÚranks           ú^/var/www/html/CA-Chatbot/venv/lib/python3.11/site-packages/sklearn/cross_decomposition/_pls.pyÚ
_pinv2_oldr4       sÌ   € õ �1 E¸Ð>Ñ>Ô>�H€A€qˆ"à	ŒŒ×ÒÑÔ€AØ˜SÐ!Ð!€FÝŒ6�!‰9Œ9�v˜a”yÑ ¥2¤8¨A¡;¤;¤?Ñ2€DÝŒ6�!�d’(ÑÔ€Dà	ˆ!ˆ!ˆ!ˆUˆdˆUˆ(Œ€AØˆˆ5ˆDˆ5Œ�M€AÝŒ<�œ¥R¤V¨A¨r°%°4°%¬yÑ%9Ô%9Ñ:Ô:Ñ;Ô;Ð;ó    ÚAéô  ç�íµ ÷Æ°>Fc                 ón  ‡— t          j        | j        ¦  «        j        Š	 t	          ˆfd„|j        D ¦   «         ¦  «        }n"# t          $ r}t          d¦  «        |‚d}~ww xY wd}|dk    rt          | ¦  «        t          |¦  «        }
}	t          |¦  «        D �]r}|dk    rt          j	        |	|¦  «        }n0t          j	        | j        |¦  «        t          j	        ||¦  «        z  }|t          j
        t          j	        ||¦  «        ¦  «        ‰z   z  }t          j	        | |¦  «        }|dk    rt          j	        |
|¦  «        }n5t          j	        |j        |¦  «        t          j	        |j        |¦  «        z  }|r-|t          j
        t          j	        ||¦  «        ¦  «        ‰z   z  }t          j	        ||¦  «        t          j	        ||¦  «        ‰z   z  }||z
  }t          j	        ||¦  «        |k     s|j        d         dk    r n|}�Œt|dz   }||k    rt          j        dt          ¦  «         |||fS )a?  Return the first left and right singular vectors of X'y.

    Provides an alternative to the svd(X'y) and uses the power method instead.
    With norm_y_weights to True and in mode A, this corresponds to the
    algorithm section 11.3 of the Wegelin's review, except this starts at the
    "update saliences" part.
    c              3   óp   •K  — | ]0}t          j        t          j        |¦  «        ‰k    ¦  «        ¯,|V — Œ1d S ©N)r#   ÚanyÚabs)Ú.0Úcolr&   s     €r3   ú	<genexpr>z;_get_first_singular_vectors_power_method.<locals>.<genexpr>?   s?   øè è € ÐGÐG˜s­R¬VµB´F¸3±K´KÀ#Ò4EÑ-FÔ-FÐG�sÐGÐGÐGÐGÐGÐGr5   úy residual is constantNéd   ÚBé   z$Maximum number of iterations reached)r#   r%   r    r&   ÚnextÚTÚStopIterationr4   Úranger*   ÚsqrtÚshapeÚwarningsÚwarnr   )ÚXÚyÚmodeÚmax_iterÚtolÚnorm_y_weightsÚy_scoreÚeÚx_weights_oldÚX_pinvÚy_pinvÚiÚ	x_weightsÚx_scoreÚ	y_weightsÚx_weights_diffÚn_iterr&   s                    @r3   Ú(_get_first_singular_vectors_power_methodr^   2   s-  ø€ õ Œ(�1”7Ñ
Ô
Ô
€Cð=ÝÐGÐGÐGÐG a¤cÐGÑGÔGÑGÔGˆˆøÝð =ð =ð =ÝÐ4Ñ5Ô5¸1Ð<øøøøð=øøøð €Màˆs‚{€{õ $ A™œ­
°1©¬�ˆå�8‰_Œ_ð "ñ "ˆØ�3Š;ˆ;Ýœ˜v wÑ/Ô/ˆIˆIåœ˜qœs GÑ,Ô,­r¬v°g¸wÑ/GÔ/GÑGˆIà•R”W�RœV I¨yÑ9Ô9Ñ:Ô:¸SÑ@Ñ@ˆ	Ý”&˜˜IÑ&Ô&ˆà�3Š;ˆ;Ýœ˜v wÑ/Ô/ˆIˆIåœ˜qœs GÑ,Ô,­r¬v°g´iÀÑ/IÔ/IÑIˆIàð 	EØ�œ¥¤¨	°9Ñ!=Ô!=Ñ>Ô>ÀÑDÑDˆIå”&˜˜IÑ&Ô&­"¬&°¸IÑ*FÔ*FÈÑ*LÑMˆà" ]Ñ2ˆÝŒ6�. .Ñ1Ô1°CÒ7Ð7¸1¼7À1¼:Èº?¸?ØˆEØ!ˆ‰à�‰U€FØ�ÒÐÝŒÐ<Õ>PÑQÔQÐQà�i Ð'Ð's   ¡ A Á
A!ÁAÁA!c                 ó�   — t          j        | j        |¦  «        }t          |d¬¦  «        \  }}}|dd…df         |ddd…f         fS )zbReturn the first left and right singular vectors of X'y.

    Here the whole SVD is computed.
    F©r   Nr   )r#   r*   rF   r   )rM   rN   ÚCÚUÚ_ÚVts         r3   Ú_get_first_singular_vectors_svdre   m   sP   € õ
 	ŒˆqŒs�A‰Œ€AÝ�1 EÐ*Ñ*Ô*�H€A€qˆ"ØˆQˆQˆQ�ˆTŒ7�B�q˜!˜!˜!�t”HÐÐr5   Tc                 ó”  — |                       d¬¦  «        }| |z  } |                      d¬¦  «        }||z  }|rK|                      dd¬¦  «        }d||dk    <   | |z  } |                     dd¬¦  «        }d||dk    <   ||z  }n>t          j        | j        d         ¦  «        }t          j        |j        d         ¦  «        }| |||||fS )z{Center X, y and scale if the scale parameter==True

    Returns
    -------
        X, y, x_mean, y_mean, x_std, y_std
    r   ©ÚaxisrD   )rh   Úddofg      ð?ç        )ÚmeanÚstdr#   ÚonesrJ   )rM   rN   ÚscaleÚx_meanÚy_meanÚx_stdÚy_stds          r3   Ú_center_scale_xyrs   w   s×   € ð �VŠV˜ˆV‰^Œ^€FØˆ�K€AØ�VŠV˜ˆV‰^Œ^€FØˆ�K€Aàð 	$Ø—’˜1 1�Ñ%Ô%ˆØ!ˆˆe�sŠlÑØ	ˆU‰
ˆØ—’˜1 1�Ñ%Ô%ˆØ!ˆˆe�sŠlÑØ	ˆU‰
ˆˆå”˜œ œ
Ñ#Ô#ˆÝ”˜œ œ
Ñ#Ô#ˆØˆa�˜ ¨Ð-Ð-r5   c                 óš   — t          j        t          j        | ¦  «        ¦  «        }t          j        | |         ¦  «        }| |z  } ||z  }dS )z7Same as svd_flip but works on 1d arrays, and is inplaceN)r#   Úargmaxr=   Úsign)r,   ÚvÚbiggest_abs_val_idxrv   s       r3   Ú_svd_flip_1dry   ‘   sG   € õ œ)¥B¤F¨1¡I¤IÑ.Ô.ÐÝŒ7�1Ð(Ô)Ñ*Ô*€DØˆ�I€AØˆ�I€A€A€Ar5   c                   óZ  ‡ — e Zd ZU dZ eeddd¬¦  «        gdg eddh¦  «        g ed	d
h¦  «        g eddh¦  «        g eeddd¬¦  «        g eeddd¬¦  «        gdgdœZe	e
d<   e	 dddd	dddddœd„¦   «         Z ed¬¦  «        d„ ¦   «         Zdd„Zdd„Zd d„Zdd„Zˆ fd„Zˆ xZS )!Ú_PLSa  Partial Least Squares (PLS)

    This class implements the generic PLS algorithm.

    Main ref: Wegelin, a survey of Partial Least Squares (PLS) methods,
    with emphasis on the two-block case
    https://stat.uw.edu/sites/default/files/files/reports/2000/tr371.pdf
    rD   NÚleft©ÚclosedÚbooleanÚ
regressionÚ	canonicalr6   rC   r   Únipalsr   ©Ún_componentsrn   Údeflation_moderO   Ú	algorithmrP   rQ   ÚcopyÚ_parameter_constraintsé   Tr7   r8   )rn   r…   rO   r†   rP   rQ   r‡   c                óv   — || _         || _        || _        || _        || _        || _        || _        || _        d S r;   )r„   r…   rO   rn   r†   rP   rQ   r‡   )	Úselfr„   rn   r…   rO   r†   rP   rQ   r‡   s	            r3   Ú__init__z_PLS.__init__·   sB   € ð )ˆÔØ,ˆÔØˆŒ	ØˆŒ
Ø"ˆŒØ ˆŒØˆŒØˆŒ	ˆ	ˆ	r5   ©Úprefer_skip_nested_validationc           	      óJ  — t          ||¦  «         t          | |t          j        d| j        d¬¦  «        }t          |dt          j        d| j        d¬¦  «        }|j        dk    rd| _        |                     dd¦  «        }nd| _        |j	        d	         }|j	        d         }|j	        d         }| j
        }| j        d
k    rt          ||¦  «        nt          |||¦  «        }||k    rt          d|› d|› d�¦  «        ‚| j        dk    | _        | j        }t          ||| j        ¦  «        \  }	}
| _        | _        | _        | _        t          j        ||f¦  «        | _        t          j        ||f¦  «        | _        t          j        ||f¦  «        | _        t          j        ||f¦  «        | _        t          j        ||f¦  «        | _        t          j        ||f¦  «        | _        g | _        t          j        |
j        ¦  «        j        }tA          |¦  «        D �]w}| j!        dk    rÁt          j"        t          j#        |
¦  «        d|z  k     d	¬¦  «        }d|
dd…|f<   	 tI          |	|
| j%        | j&        | j'        |¬¦  «        \  }}}nD# tP          $ r7}tS          |¦  «        dk    r‚ tU          j+        d|› �¦  «         Y d}~ �nÍd}~ww xY w| j         ,                    |¦  «         n| j!        dk    rt[          |	|
¦  «        \  }}t]          ||¦  «         t          j/        |	|¦  «        }|rd}nt          j/        ||¦  «        }t          j/        |
|¦  «        |z  }t          j/        ||	¦  «        t          j/        ||¦  «        z  }|	t          j0        ||¦  «        z  }	| j        dk    rCt          j/        ||
¦  «        t          j/        ||¦  «        z  }|
t          j0        ||¦  «        z  }
| j        d
k    rCt          j/        ||
¦  «        t          j/        ||¦  «        z  }|
t          j0        ||¦  «        z  }
|| j        dd…|f<   || j        dd…|f<   || j        dd…|f<   || j        dd…|f<   || j        dd…|f<   || j        dd…|f<   �Œyt          j/        | j        tc          t          j/        | j        j2        | j        ¦  «        d¬¦  «        ¦  «        | _3        t          j/        | j        tc          t          j/        | j        j2        | j        ¦  «        d¬¦  «        ¦  «        | _4        t          j/        | j3        | j        j2        ¦  «        | _5        | j5        | j        z  j2        | j        z  | _5        | j        | _6        | j3        j	        d         | _7        | S )á  Fit model to data.

        Parameters
        ----------
        X : array-like of shape (n_samples, n_features)
            Training vectors, where `n_samples` is the number of samples and
            `n_features` is the number of predictors.

        y : array-like of shape (n_samples,) or (n_samples, n_targets)
            Target vectors, where `n_samples` is the number of samples and
            `n_targets` is the number of response variables.

        Returns
        -------
        self : object
            Fitted model.
        Tr‰   ©r    Úforce_writeabler‡   Úensure_min_samplesrN   F©Ú
input_namer    r’   r‡   Ú	ensure_2drD   éÿÿÿÿr   r€   ú`n_components` upper bound is ú. Got ú  instead. Reduce `n_components`.r�   r‚   é
   rg   rj   N)rO   rP   rQ   rR   rA   z$y residual is constant at iteration r   )r   )8r   r   r#   Úfloat64r‡   r   ÚndimÚ_predict_1dÚreshaperJ   r„   r…   ÚminÚ
ValueErrorÚ_norm_y_weightsrs   rn   Ú_x_meanÚ_y_meanÚ_x_stdÚ_y_stdÚzerosÚ
x_weights_Ú
y_weights_Ú	_x_scoresÚ	_y_scoresÚx_loadings_Úy_loadings_Ún_iter_r%   r    r&   rH   r†   Úallr=   r^   rO   rP   rQ   rG   ÚstrrK   rL   Úappendre   ry   r*   Úouterr   rF   Úx_rotations_Úy_rotations_Úcoef_Ú
intercept_Ú_n_features_out)r‹   rM   rN   ÚnÚpÚqr„   Úrank_upper_boundrR   ÚXkÚykÚy_epsÚkÚyk_maskrY   r[   r®   rT   Úx_scoresÚy_ssÚy_scoresÚ
x_loadingsÚ
y_loadingss                          r3   Úfitz_PLS.fitÍ   sÙ  € õ& 	   1Ñ%Ô%Ð%ÝØØÝ”*Ø Ø”Ø ð
ñ 
ô 
ˆõ ØØÝ”*Ø Ø”Øð
ñ 
ô 
ˆð Œ6�QŠ;ˆ;Ø#ˆDÔØ—	’	˜"˜aÑ Ô ˆAˆAà$ˆDÔàŒG�AŒJˆØŒG�AŒJˆØŒG�AŒJˆàÔ(ˆð
 Ô,°Ò<Ð<�C��1‰IŒIˆIÅ#ÀaÈÈAÁ,Ä,ð 	ð Ð*Ò*Ð*ÝðFÐ1Að Fð FØ#ðFð Fð Fñô ð ð
  $Ô2°kÒAˆÔØÔ-ˆõ HXØˆq�$”*ñH
ô H
ÑDˆˆB�”˜dœl¨D¬K¸¼õ œ( A |Ð#4Ñ5Ô5ˆŒÝœ( A |Ð#4Ñ5Ô5ˆŒÝœ 1 lÐ"3Ñ4Ô4ˆŒÝœ 1 lÐ"3Ñ4Ô4ˆŒÝœ8 Q¨Ð$5Ñ6Ô6ˆÔÝœ8 Q¨Ð$5Ñ6Ô6ˆÔØˆŒõ
 ”˜œÑ"Ô"Ô&ˆÝ�|Ñ$Ô$ð =	0ñ =	0ˆAð Œ~ Ò)Ð)åœ&¥¤¨¡¤¨b°5©jÒ!8¸qÐAÑAÔA�Ø!$��1�1�1�g�:‘ðõ
 AØØØ!œYØ!%¤Ø œHØ'5ðñ ô ñ	Ø!Ø!Ø˜øõ %ð ð ð Ý˜1‘v”vÐ!9Ò9Ð9ØÝ”MÐ"LÈÐ"LÐ"LÑMÔMÐMØ�E�E�E�E‘Eøøøøð	øøøð ”×#Ò# GÑ,Ô,Ð,Ð,à” 5Ò(Ð(Ý'FÀrÈ2Ñ'NÔ'NÑ$�	˜9õ ˜ IÑ.Ô.Ð.õ ”v˜b )Ñ,Ô,ˆHØð 4Ø��å”v˜i¨Ñ3Ô3�Ý”v˜b )Ñ,Ô,¨tÑ3ˆHõ œ ¨"Ñ-Ô-µ´°xÀÑ0JÔ0JÑJˆJØ•"”(˜8 ZÑ0Ô0Ñ0ˆBàÔ" kÒ1Ð1åœV H¨bÑ1Ô1µB´F¸8ÀXÑ4NÔ4NÑN�
Ø•b”h˜x¨Ñ4Ô4Ñ4�ØÔ" lÒ2Ð2åœV H¨bÑ1Ô1µB´F¸8ÀXÑ4NÔ4NÑN�
Ø•b”h˜x¨Ñ4Ô4Ñ4�à$-ˆDŒO˜A˜A˜A˜q˜DÑ!Ø$-ˆDŒO˜A˜A˜A˜q˜DÑ!Ø#+ˆDŒN˜1˜1˜1˜a˜4Ñ Ø#+ˆDŒN˜1˜1˜1˜a˜4Ñ Ø%/ˆDÔ˜Q˜Q˜Q ˜TÑ"Ø%/ˆDÔ˜Q˜Q˜Q ˜TÑ"Ñ"õ œFØŒOÝ•”˜Ô(Ô*¨D¬OÑ<Ô<È5ÐQÑQÔQñ
ô 
ˆÔõ œFØŒOÝ•”˜Ô(Ô*¨D¬OÑ<Ô<È5ÐQÑQÔQñ
ô 
ˆÔõ ”V˜DÔ-¨tÔ/?Ô/AÑBÔBˆŒ
Ø”j 4¤;Ñ.Ô1°D´KÑ?ˆŒ
Øœ,ˆŒØ#Ô0Ô6°qÔ9ˆÔØˆs   É$(JÊ
KÊ+K	Ë	Kc                 óŽ  — t          | ¦  «         t          | ||t          d¬¦  «        }|| j        z  }|| j        z  }t          j        || j        ¦  «        }|�lt          |dd|t          ¬¦  «        }|j	        dk    r| 
                    dd¦  «        }|| j        z  }|| j        z  }t          j        || j        ¦  «        }||fS |S )a.  Apply the dimension reduction.

        Parameters
        ----------
        X : array-like of shape (n_samples, n_features)
            Samples to transform.

        y : array-like of shape (n_samples, n_targets), default=None
            Target vectors.

        copy : bool, default=True
            Whether to copy `X` and `y`, or perform in-place normalization.

        Returns
        -------
        x_scores, y_scores : array-like or tuple of array-like
            Return `x_scores` if `y` is not given, `(x_scores, y_scores)` otherwise.
        F©r‡   r    ÚresetNrN   )r•   r–   r‡   r    rD   r—   )r   r   r   r£   r¥   r#   r*   r³   r   r�   rŸ   r¤   r¦   r´   )r‹   rM   rN   r‡   rÁ   rÃ   s         r3   Ú	transformz_PLS.transformp  sÖ   € õ& 	˜ÑÔÐÝ˜$ ¨µLÈÐNÑNÔNˆà	ˆTŒ\ÑˆØ	ˆTŒ[Ñˆå”6˜!˜TÔ.Ñ/Ô/ˆØˆ=ÝØ˜c¨U¸Å\ðñ ô ˆAð Œv˜Š{ˆ{Ø—I’I˜b !Ñ$Ô$�Ø�”ÑˆAØ�”ÑˆAÝ”v˜a Ô!2Ñ3Ô3ˆHØ˜XÐ%Ð%àˆr5   c                 óX  — t          | ¦  «         t          |dt          ¬¦  «        }t          j        || j        j        ¦  «        }|| j        z  }|| j        z  }|�Nt          |dt          ¬¦  «        }t          j        || j	        j        ¦  «        }|| j
        z  }|| j        z  }||fS |S )ak  Transform data back to its original space.

        Parameters
        ----------
        X : array-like of shape (n_samples, n_components)
            New data, where `n_samples` is the number of samples
            and `n_components` is the number of pls components.

        y : array-like of shape (n_samples,) or (n_samples, n_components)
            New target, where `n_samples` is the number of samples
            and `n_components` is the number of pls components.

        Returns
        -------
        X_original : ndarray of shape (n_samples, n_features)
            Return the reconstructed `X` data.

        y_original : ndarray of shape (n_samples, n_targets)
            Return the reconstructed `X` target. Only returned when `y` is given.

        Notes
        -----
        This transformation will only be exact if `n_components=n_features`.
        rM   )r•   r    NrN   )r   r   r   r#   Úmatmulr¬   rF   r¥   r£   r­   r¦   r¤   )r‹   rM   rN   ÚX_reconstructedÚy_reconstructeds        r3   Úinverse_transformz_PLS.inverse_transform—  s®   € õ2 	˜ÑÔÐÝ˜ cµÐ>Ñ>Ô>ˆåœ) A tÔ'7Ô'9Ñ:Ô:ˆà˜4œ;Ñ&ˆØ˜4œ<Ñ'ˆàˆ=Ý˜A¨#µ\ÐBÑBÔBˆAå œi¨¨4Ô+;Ô+=Ñ>Ô>ˆOà˜tœ{Ñ*ˆOØ˜tœ|Ñ+ˆOØ" OÐ3Ð3àÐr5   c                 óÎ   — t          | ¦  «         t          | ||t          d¬¦  «        }|| j        z  }|| j        j        z  | j        z   }| j        r|                     ¦   «         n|S )aL  Predict targets of given samples.

        Parameters
        ----------
        X : array-like of shape (n_samples, n_features)
            Samples.

        copy : bool, default=True
            Whether to copy `X` or perform in-place normalization.

        Returns
        -------
        y_pred : ndarray of shape (n_samples,) or (n_samples, n_targets)
            Returns predicted values.

        Notes
        -----
        This call requires the estimation of a matrix of shape
        `(n_features, n_targets)`, which may be an issue in high dimensional
        space.
        FrÈ   )	r   r   r   r£   rµ   rF   r¶   rž   Úravel)r‹   rM   r‡   Úy_preds       r3   Úpredictz_PLS.predictÃ  se   € õ, 	˜ÑÔÐÝ˜$ ¨µLÈÐNÑNÔNˆà	ˆTŒ\ÑˆØ�T”Z”\Ñ! D¤OÑ3ˆØ!%Ô!1Ð=ˆv�|Š|‰~Œ~ˆ~°vÐ=r5   c                 óV   — |                       ||¦  «                             ||¦  «        S )a£  Learn and apply the dimension reduction on the train data.

        Parameters
        ----------
        X : array-like of shape (n_samples, n_features)
            Training vectors, where `n_samples` is the number of samples and
            `n_features` is the number of predictors.

        y : array-like of shape (n_samples, n_targets), default=None
            Target vectors, where `n_samples` is the number of samples and
            `n_targets` is the number of response variables.

        Returns
        -------
        self : ndarray of shape (n_samples, n_components)
            Return `x_scores` if `y` is not given, `(x_scores, y_scores)` otherwise.
        ©rÆ   rÊ   ©r‹   rM   rN   s      r3   Úfit_transformz_PLS.fit_transformà  ó&   € ð$ �xŠx˜˜1‰~Œ~×'Ò'¨¨1Ñ-Ô-Ð-r5   c                 óx   •— t          ¦   «                              ¦   «         }d|j        _        d|j        _        |S )NTF)ÚsuperÚ__sklearn_tags__Úregressor_tagsÚ
poor_scoreÚtarget_tagsÚrequired)r‹   ÚtagsÚ	__class__s     €r3   rÛ   z_PLS.__sklearn_tags__ô  s3   ø€ Ý‰wŒw×'Ò'Ñ)Ô)ˆØ)-ˆÔÔ&Ø$)ˆÔÔ!Øˆr5   ©r‰   )NTr;   ©T)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r   r   r   rˆ   ÚdictÚ__annotations__r   rŒ   r   rÆ   rÊ   rÏ   rÓ   r×   rÛ   Ú__classcell__©rá   s   @r3   r{   r{   ›   s¼  ø€ € € € € € ðð ð "˜ (¨A¨t¸FÐCÑCÔCÐDØ�Ø%˜: |°[Ð&AÑBÔBÐCØ�˜S #˜JÑ'Ô'Ð(Ø �j %¨Ð!2Ñ3Ô3Ð4Ø�X˜h¨¨4¸Ð?Ñ?Ô?Ð@Ø�˜˜q $¨vÐ6Ñ6Ô6Ð7Ø�ð	$ð 	$Ð˜Dð 	ð 	ñ 	ð ð ðð Ø#ØØØØØðð ð ð ñ „^ðð* €\°Ð5Ñ5Ô5ð`ð `ñ 6Ô5ð`ðD%ð %ð %ð %ðN*ð *ð *ð *ðX>ð >ð >ð >ð:.ð .ð .ð .ð(ð ð ð ð ð ð ð ð r5   r{   )Ú	metaclassc                   óŽ   ‡ — e Zd ZU dZi ej        ¥Zeed<   dD ]Ze 	                    e¦  «         Œ	 ddddddœˆ fd	„Z
ˆ fd
„Zˆ xZS )r   aÏ  PLS regression.

    PLSRegression is also known as PLS2 or PLS1, depending on the number of
    targets.

    For a comparison between other cross decomposition algorithms, see
    :ref:`sphx_glr_auto_examples_cross_decomposition_plot_compare_cross_decomposition.py`.

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

    .. versionadded:: 0.8

    Parameters
    ----------
    n_components : int, default=2
        Number of components to keep. Should be in `[1, n_features]`.

    scale : bool, default=True
        Whether to scale `X` and `y`.

    max_iter : int, default=500
        The maximum number of iterations of the power method when
        `algorithm='nipals'`. Ignored otherwise.

    tol : float, default=1e-06
        The tolerance used as convergence criteria in the power method: the
        algorithm stops whenever the squared norm of `u_i - u_{i-1}` is less
        than `tol`, where `u` corresponds to the left singular vector.

    copy : bool, default=True
        Whether to copy `X` and `y` in :term:`fit` before applying centering,
        and potentially scaling. If `False`, these operations will be done
        inplace, modifying both arrays.

    Attributes
    ----------
    x_weights_ : ndarray of shape (n_features, n_components)
        The left singular vectors of the cross-covariance matrices of each
        iteration.

    y_weights_ : ndarray of shape (n_targets, n_components)
        The right singular vectors of the cross-covariance matrices of each
        iteration.

    x_loadings_ : ndarray of shape (n_features, n_components)
        The loadings of `X`.

    y_loadings_ : ndarray of shape (n_targets, n_components)
        The loadings of `y`.

    x_scores_ : ndarray of shape (n_samples, n_components)
        The transformed training samples.

    y_scores_ : ndarray of shape (n_samples, n_components)
        The transformed training targets.

    x_rotations_ : ndarray of shape (n_features, n_components)
        The projection matrix used to transform `X`.

    y_rotations_ : ndarray of shape (n_targets, n_components)
        The projection matrix used to transform `y`.

    coef_ : ndarray of shape (n_target, n_features)
        The coefficients of the linear model such that `y` is approximated as
        `y = X @ coef_.T + intercept_`.

    intercept_ : ndarray of shape (n_targets,)
        The intercepts of the linear model such that `y` is approximated as
        `y = X @ coef_.T + intercept_`.

        .. versionadded:: 1.1

    n_iter_ : list of shape (n_components,)
        Number of iterations of the power method, for each
        component.

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

    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
    --------
    PLSCanonical : Partial Least Squares transformer and regressor.

    Examples
    --------
    >>> from sklearn.cross_decomposition import PLSRegression
    >>> X = [[0., 0., 1.], [1.,0.,0.], [2.,2.,2.], [2.,5.,4.]]
    >>> y = [[0.1, -0.2], [0.9, 1.1], [6.2, 5.9], [11.9, 12.3]]
    >>> pls2 = PLSRegression(n_components=2)
    >>> pls2.fit(X, y)
    PLSRegression()
    >>> y_pred = pls2.predict(X)

    For a comparison between PLS Regression and :class:`~sklearn.decomposition.PCA`, see
    :ref:`sphx_glr_auto_examples_cross_decomposition_plot_pcr_vs_pls.py`.
    rˆ   ©r…   rO   r†   r‰   Tr7   r8   ©rn   rP   rQ   r‡   c          
      óZ   •— t          ¦   «                              ||ddd|||¬¦  «         d S )Nr€   r6   r‚   rƒ   ©rÚ   rŒ   ©r‹   r„   rn   rP   rQ   r‡   rá   s         €r3   rŒ   zPLSRegression.__init__m  sH   ø€ õ 	‰Œ×ÒØ%ØØ'ØØØØØð 	ñ 		
ô 		
ð 		
ð 		
ð 		
r5   c                 ó|   •— t          ¦   «                              ||¦  «         | j        | _        | j        | _        | S )r�   )rÚ   rÆ   rª   Ú	x_scores_r«   Ú	y_scores_)r‹   rM   rN   rá   s      €r3   rÆ   zPLSRegression.fit{  s4   ø€ õ$ 	‰Œ�Š�A�qÑÔÐàœˆŒØœˆŒØˆr5   râ   )rä   rå   ræ   rç   r{   rˆ   rè   ré   ÚparamÚpoprŒ   rÆ   rê   rë   s   @r3   r   r   û  s¿   ø€ € € € € € ðeð eðN $C dÔ&AÐ#BÐ˜DÐBÐBÑBØ8ð *ð *ˆØ×"Ò" 5Ñ)Ô)Ð)Ð)ð ð
Ø'+°c¸uÈ4ð
ð 
ð 
ð 
ð 
ð 
ð 
ðð ð ð ð ð ð ð ð r5   r   c                   ó†   ‡ — e Zd ZU dZi ej        ¥Zeed<   dD ]Ze 	                    e¦  «         Œ	 ddddddd	œˆ fd
„Z
ˆ xZS )r   a^  Partial Least Squares transformer and regressor.

    For a comparison between other cross decomposition algorithms, see
    :ref:`sphx_glr_auto_examples_cross_decomposition_plot_compare_cross_decomposition.py`.

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

    .. versionadded:: 0.8

    Parameters
    ----------
    n_components : int, default=2
        Number of components to keep. Should be in `[1, min(n_samples,
        n_features, n_targets)]`.

    scale : bool, default=True
        Whether to scale `X` and `y`.

    algorithm : {'nipals', 'svd'}, default='nipals'
        The algorithm used to estimate the first singular vectors of the
        cross-covariance matrix. 'nipals' uses the power method while 'svd'
        will compute the whole SVD.

    max_iter : int, default=500
        The maximum number of iterations of the power method when
        `algorithm='nipals'`. Ignored otherwise.

    tol : float, default=1e-06
        The tolerance used as convergence criteria in the power method: the
        algorithm stops whenever the squared norm of `u_i - u_{i-1}` is less
        than `tol`, where `u` corresponds to the left singular vector.

    copy : bool, default=True
        Whether to copy `X` and `y` in fit before applying centering, and
        potentially scaling. If False, these operations will be done inplace,
        modifying both arrays.

    Attributes
    ----------
    x_weights_ : ndarray of shape (n_features, n_components)
        The left singular vectors of the cross-covariance matrices of each
        iteration.

    y_weights_ : ndarray of shape (n_targets, n_components)
        The right singular vectors of the cross-covariance matrices of each
        iteration.

    x_loadings_ : ndarray of shape (n_features, n_components)
        The loadings of `X`.

    y_loadings_ : ndarray of shape (n_targets, n_components)
        The loadings of `y`.

    x_rotations_ : ndarray of shape (n_features, n_components)
        The projection matrix used to transform `X`.

    y_rotations_ : ndarray of shape (n_targets, n_components)
        The projection matrix used to transform `y`.

    coef_ : ndarray of shape (n_targets, n_features)
        The coefficients of the linear model such that `y` is approximated as
        `y = X @ coef_.T + intercept_`.

    intercept_ : ndarray of shape (n_targets,)
        The intercepts of the linear model such that `y` is approximated as
        `y = X @ coef_.T + intercept_`.

        .. versionadded:: 1.1

    n_iter_ : list of shape (n_components,)
        Number of iterations of the power method, for each
        component. Empty if `algorithm='svd'`.

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

    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
    --------
    CCA : Canonical Correlation Analysis.
    PLSSVD : Partial Least Square SVD.

    Examples
    --------
    >>> from sklearn.cross_decomposition import PLSCanonical
    >>> X = [[0., 0., 1.], [1.,0.,0.], [2.,2.,2.], [2.,5.,4.]]
    >>> y = [[0.1, -0.2], [0.9, 1.1], [6.2, 5.9], [11.9, 12.3]]
    >>> plsca = PLSCanonical(n_components=2)
    >>> plsca.fit(X, y)
    PLSCanonical()
    >>> X_c, y_c = plsca.transform(X, y)
    rˆ   )r…   rO   r‰   Tr‚   r7   r8   )rn   r†   rP   rQ   r‡   c          
      óZ   •— t          ¦   «                              ||dd||||¬¦  «         d S )Nr�   r6   rƒ   rñ   )r‹   r„   rn   r†   rP   rQ   r‡   rá   s          €r3   rŒ   zPLSCanonical.__init__  sH   ø€ õ 	‰Œ×ÒØ%ØØ&ØØØØØð 	ñ 		
ô 		
ð 		
ð 		
ð 		
r5   râ   ©rä   rå   ræ   rç   r{   rˆ   rè   ré   rö   r÷   rŒ   rê   rë   s   @r3   r   r   ”  s®   ø€ € € € € € ð`ð `ðD $C dÔ&AÐ#BÐ˜DÐBÐBÑBØ+ð *ð *ˆØ×"Ò" 5Ñ)Ô)Ð)Ð)ð ð
ð ØØØØð
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
r5   r   c                   ó„   ‡ — e Zd ZU dZi ej        ¥Zeed<   dD ]Ze 	                    e¦  «         Œ	 d
dddddœˆ fd	„Z
ˆ xZS )ÚCCAa  Canonical Correlation Analysis, also known as "Mode B" PLS.

    For a comparison between other cross decomposition algorithms, see
    :ref:`sphx_glr_auto_examples_cross_decomposition_plot_compare_cross_decomposition.py`.

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

    Parameters
    ----------
    n_components : int, default=2
        Number of components to keep. Should be in `[1, min(n_samples,
        n_features, n_targets)]`.

    scale : bool, default=True
        Whether to scale `X` and `y`.

    max_iter : int, default=500
        The maximum number of iterations of the power method.

    tol : float, default=1e-06
        The tolerance used as convergence criteria in the power method: the
        algorithm stops whenever the squared norm of `u_i - u_{i-1}` is less
        than `tol`, where `u` corresponds to the left singular vector.

    copy : bool, default=True
        Whether to copy `X` and `y` in fit before applying centering, and
        potentially scaling. If False, these operations will be done inplace,
        modifying both arrays.

    Attributes
    ----------
    x_weights_ : ndarray of shape (n_features, n_components)
        The left singular vectors of the cross-covariance matrices of each
        iteration.

    y_weights_ : ndarray of shape (n_targets, n_components)
        The right singular vectors of the cross-covariance matrices of each
        iteration.

    x_loadings_ : ndarray of shape (n_features, n_components)
        The loadings of `X`.

    y_loadings_ : ndarray of shape (n_targets, n_components)
        The loadings of `y`.

    x_rotations_ : ndarray of shape (n_features, n_components)
        The projection matrix used to transform `X`.

    y_rotations_ : ndarray of shape (n_targets, n_components)
        The projection matrix used to transform `y`.

    coef_ : ndarray of shape (n_targets, n_features)
        The coefficients of the linear model such that `y` is approximated as
        `y = X @ coef_.T + intercept_`.

    intercept_ : ndarray of shape (n_targets,)
        The intercepts of the linear model such that `y` is approximated as
        `y = X @ coef_.T + intercept_`.

        .. versionadded:: 1.1

    n_iter_ : list of shape (n_components,)
        Number of iterations of the power method, for each
        component.

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

    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
    --------
    PLSCanonical : Partial Least Squares transformer and regressor.
    PLSSVD : Partial Least Square SVD.

    Examples
    --------
    >>> from sklearn.cross_decomposition import CCA
    >>> X = [[0., 0., 1.], [1.,0.,0.], [2.,2.,2.], [3.,5.,4.]]
    >>> y = [[0.1, -0.2], [0.9, 1.1], [6.2, 5.9], [11.9, 12.3]]
    >>> cca = CCA(n_components=1)
    >>> cca.fit(X, y)
    CCA(n_components=1)
    >>> X_c, y_c = cca.transform(X, y)
    rˆ   rî   r‰   Tr7   r8   rï   c          
      óZ   •— t          ¦   «                              ||ddd|||¬¦  «         d S )Nr�   rC   r‚   rƒ   rñ   rò   s         €r3   rŒ   zCCA.__init__x  sH   ø€ õ 	‰Œ×ÒØ%ØØ&ØØØØØð 	ñ 		
ô 		
ð 		
ð 		
ð 		
r5   râ   rú   rë   s   @r3   rü   rü     s¦   ø€ € € € € € ðXð Xðt $C dÔ&AÐ#BÐ˜DÐBÐBÑBØ8ð *ð *ˆØ×"Ò" 5Ñ)Ô)Ð)Ð)ð ð
Ø'+°c¸uÈ4ð
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
r5   rü   c                   ó”   — e Zd ZU dZ eeddd¬¦  «        gdgdgdœZeed<   dd
d
dœd„Z	 e
d
¬¦  «        d„ ¦   «         Zdd„Zdd„ZdS )r   aº  Partial Least Square SVD.

    This transformer simply performs an SVD on the cross-covariance matrix
    `X'y`. It is able to project both the training data `X` and the targets
    `y`. The training data `X` is projected on the left singular vectors, while
    the targets are projected on the right singular vectors.

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

    .. versionadded:: 0.8

    Parameters
    ----------
    n_components : int, default=2
        The number of components to keep. Should be in `[1,
        min(n_samples, n_features, n_targets)]`.

    scale : bool, default=True
        Whether to scale `X` and `y`.

    copy : bool, default=True
        Whether to copy `X` and `y` in fit before applying centering, and
        potentially scaling. If `False`, these operations will be done inplace,
        modifying both arrays.

    Attributes
    ----------
    x_weights_ : ndarray of shape (n_features, n_components)
        The left singular vectors of the SVD of the cross-covariance matrix.
        Used to project `X` in :meth:`transform`.

    y_weights_ : ndarray of (n_targets, n_components)
        The right singular vectors of the SVD of the cross-covariance matrix.
        Used to project `X` in :meth:`transform`.

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

    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
    --------
    PLSCanonical : Partial Least Squares transformer and regressor.
    CCA : Canonical Correlation Analysis.

    Examples
    --------
    >>> import numpy as np
    >>> from sklearn.cross_decomposition import PLSSVD
    >>> X = np.array([[0., 0., 1.],
    ...               [1., 0., 0.],
    ...               [2., 2., 2.],
    ...               [2., 5., 4.]])
    >>> y = np.array([[0.1, -0.2],
    ...               [0.9, 1.1],
    ...               [6.2, 5.9],
    ...               [11.9, 12.3]])
    >>> pls = PLSSVD(n_components=2).fit(X, y)
    >>> X_c, y_c = pls.transform(X, y)
    >>> X_c.shape, y_c.shape
    ((4, 2), (4, 2))
    rD   Nr|   r}   r   ©r„   rn   r‡   rˆ   r‰   T)rn   r‡   c                ó0   — || _         || _        || _        d S r;   rÿ   )r‹   r„   rn   r‡   s       r3   rŒ   zPLSSVD.__init__Ñ  s   € Ø(ˆÔØˆŒ
ØˆŒ	ˆ	ˆ	r5   r�   c                 ó  — t          ||¦  «         t          | |t          j        d| j        d¬¦  «        }t          |dt          j        d| j        d¬¦  «        }|j        dk    r|                     dd¦  «        }| j        }t          |j
        d	         |j
        d         |j
        d         ¦  «        }||k    rt          d
|› d|› d�¦  «        ‚t          ||| j        ¦  «        \  }}| _        | _        | _        | _        t          j        |j        |¦  «        }t)          |d¬¦  «        \  }}}|dd…d|…f         }|d|…         }t+          ||¦  «        \  }}|j        }	|| _        |	| _        | j        j
        d         | _        | S )aJ  Fit model to data.

        Parameters
        ----------
        X : array-like of shape (n_samples, n_features)
            Training samples.

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

        Returns
        -------
        self : object
            Fitted estimator.
        Tr‰   r‘   rN   Fr”   rD   r—   r   r˜   r™   rš   r`   N)r   r   r#   rœ   r‡   r   r�   rŸ   r„   r    rJ   r¡   rs   rn   r£   r¤   r¥   r¦   r*   rF   r   r   r¨   r©   r·   )
r‹   rM   rN   r„   r»   ra   rb   r-   rd   ÚVs
             r3   rÆ   z
PLSSVD.fitÖ  sÀ  € õ" 	   1Ñ%Ô%Ð%ÝØØÝ”*Ø Ø”Ø ð
ñ 
ô 
ˆõ ØØÝ”*Ø Ø”Øð
ñ 
ô 
ˆð Œ6�QŠ;ˆ;Ø—	’	˜"˜aÑ Ô ˆAð
 Ô(ˆÝ˜qœw qœz¨1¬7°1¬:°q´w¸q´zÑBÔBÐØÐ*Ò*Ð*ÝðFÐ1Að Fð FØ#ðFð Fð Fñô ð õ
 FVØˆq�$”*ñF
ô F
ÑBˆˆ1ˆdŒl˜DœL¨$¬+°t´{õ
 ŒF�1”3˜‰NŒNˆÝ�q¨Ð.Ñ.Ô.‰ˆˆ1ˆbØˆaˆaˆa��,�ÐÔˆØ���ÔˆÝ˜˜B‘”‰ˆˆ2ØŒDˆàˆŒØˆŒØ#œÔ4°QÔ7ˆÔØˆr5   c                 ó–  — t          | ¦  «         t          | |t          j        d¬¦  «        }|| j        z
  | j        z  }t          j        || j        ¦  «        }|�nt          |ddt          j        ¬¦  «        }|j	        dk    r| 
                    dd¦  «        }|| j        z
  | j        z  }t          j        || j        ¦  «        }||fS |S )a	  
        Apply the dimensionality reduction.

        Parameters
        ----------
        X : array-like of shape (n_samples, n_features)
            Samples to be transformed.

        y : array-like of shape (n_samples,) or (n_samples, n_targets),                 default=None
            Targets.

        Returns
        -------
        x_scores : array-like or tuple of array-like
            The transformed data `X_transformed` if `y is not None`,
            `(X_transformed, y_transformed)` otherwise.
        F)r    rÉ   NrN   )r•   r–   r    rD   r—   )r   r   r#   rœ   r£   r¥   r*   r¨   r   r�   rŸ   r¤   r¦   r©   )r‹   rM   rN   ÚXrrÁ   ÚyrrÃ   s          r3   rÊ   zPLSSVD.transform  sÁ   € õ& 	˜ÑÔÐÝ˜$ ­¬¸5ÐAÑAÔAˆØ�$”,Ñ $¤+Ñ-ˆÝ”6˜"˜dœoÑ.Ô.ˆØˆ=Ý˜A¨#¸ÅbÄjÐQÑQÔQˆAØŒv˜Š{ˆ{Ø—I’I˜b !Ñ$Ô$�Ø�d”lÑ" d¤kÑ1ˆBÝ”v˜b $¤/Ñ2Ô2ˆHØ˜XÐ%Ð%Øˆr5   c                 óV   — |                       ||¦  «                             ||¦  «        S )aü  Learn and apply the dimensionality reduction.

        Parameters
        ----------
        X : array-like of shape (n_samples, n_features)
            Training samples.

        y : array-like of shape (n_samples,) or (n_samples, n_targets),                 default=None
            Targets.

        Returns
        -------
        out : array-like or tuple of array-like
            The transformed data `X_transformed` if `y is not None`,
            `(X_transformed, y_transformed)` otherwise.
        rÕ   rÖ   s      r3   r×   zPLSSVD.fit_transform7  rØ   r5   râ   r;   )rä   rå   ræ   rç   r   r   rˆ   rè   ré   rŒ   r   rÆ   rÊ   r×   © r5   r3   r   r   ‡  sÛ   € € € € € € ðAð AðH "˜ (¨A¨t¸FÐCÑCÔCÐDØ�Ø�ð$ð $Ð˜Dð ð ñ ð°¸4ð ð ð ð ð ð
 €\°Ð5Ñ5Ô5ð>ð >ñ 6Ô5ð>ð@ð ð ð ð@.ð .ð .ð .ð .ð .r5   r   )r6   r7   r8   Frã   )-rç   rK   Úabcr   r   Únumbersr   r   Únumpyr#   Úscipy.linalgr   r   Úsklearn.baser	   r
   r   r   r   r   Úsklearn.exceptionsr   Úsklearn.utilsr   r   Úsklearn.utils._param_validationr   r   Úsklearn.utils.extmathr   Úsklearn.utils.validationr   r   r   Ú__all__r4   r^   re   rs   ry   r{   r   r   rü   r   r  r5   r3   ú<module>r     s¿  ððð ð €€€Ø 'Ð 'Ð 'Ð 'Ð 'Ð 'Ð 'Ð 'Ø "Ð "Ð "Ð "Ð "Ð "Ð "Ð "à Ð Ð Ð Ø "Ð "Ð "Ð "Ð "Ð "Ð "Ð "ðð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð 2Ð 1Ð 1Ð 1Ð 1Ð 1Ø >Ð >Ð >Ð >Ð >Ð >Ð >Ð >Ø @Ð @Ð @Ð @Ð @Ð @Ð @Ð @Ø *Ð *Ð *Ð *Ð *Ð *Ø QÐ QÐ QÐ QÐ QÐ QÐ QÐ QÐ QÐ Qà
5Ð
5Ð
5€ð<ð <ð <ð& =Bð8(ð 8(ð 8(ð 8(ðvð ð ð.ð .ð .ð .ð4ð ð ð]ð ]ð ]ð ]ð ]Ø#ØØØØØð]ñ ]ô ]ð ]ð@Vð Vð Vð Vð V�Dñ Vô Vð VðrB
ð B
ð B
ð B
ð B
�4ñ B
ô B
ð B
ðJk
ð k
ð k
ð k
ð k
ˆ$ñ k
ô k
ð k
ð\B.ð B.ð B.ð B.ð B.Ð,Ð.>Àñ B.ô B.ð B.ð B.ð B.r5   