U
    ½mœdþ;  ã                   @   sÜ   d Z ddlZddlZddlmZmZ ddlmZ ddl	m
Z
 ddl	mZ ddlmZmZmZ dd	lmZmZ dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZmZ ddlm Z  G dd„ deeeƒZ!dS )zIsomap for manifold learningé    N)ÚIntegralÚReal)Úissparse)Úshortest_path)Úconnected_componentsé   )ÚBaseEstimatorÚTransformerMixinÚClassNamePrefixFeaturesOutMixin)ÚNearestNeighborsÚkneighbors_graph)Úradius_neighbors_graph)Úcheck_is_fitted)Ú	KernelPCA)ÚKernelCenterer)Ú_fix_connected_components)ÚIntervalÚ
StrOptions)Ú_VALID_METRICSc                   @   s*  e Zd ZU dZeedddd�dgeedddd�dgeedddd�gedd	d
hƒgeedddd�geedddd�dgedddhƒgeddddhƒgedgeedddd�geee	ƒdhB ƒe
gedgdœZeed< dddddddddddddœdd„Zdd„ Zdd„ Zd%dd„Zd&dd „Zd!d"„ Zd#d$„ ZdS )'ÚIsomapaÌ  Isomap Embedding.

    Non-linear dimensionality reduction through Isometric Mapping

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

    Parameters
    ----------
    n_neighbors : int or None, default=5
        Number of neighbors to consider for each point. If `n_neighbors` is an int,
        then `radius` must be `None`.

    radius : float or None, default=None
        Limiting distance of neighbors to return. If `radius` is a float,
        then `n_neighbors` must be set to `None`.

        .. versionadded:: 1.1

    n_components : int, default=2
        Number of coordinates for the manifold.

    eigen_solver : {'auto', 'arpack', 'dense'}, default='auto'
        'auto' : Attempt to choose the most efficient solver
        for the given problem.

        'arpack' : Use Arnoldi decomposition to find the eigenvalues
        and eigenvectors.

        'dense' : Use a direct solver (i.e. LAPACK)
        for the eigenvalue decomposition.

    tol : float, default=0
        Convergence tolerance passed to arpack or lobpcg.
        not used if eigen_solver == 'dense'.

    max_iter : int, default=None
        Maximum number of iterations for the arpack solver.
        not used if eigen_solver == 'dense'.

    path_method : {'auto', 'FW', 'D'}, default='auto'
        Method to use in finding shortest path.

        'auto' : attempt to choose the best algorithm automatically.

        'FW' : Floyd-Warshall algorithm.

        'D' : Dijkstra's algorithm.

    neighbors_algorithm : {'auto', 'brute', 'kd_tree', 'ball_tree'},                           default='auto'
        Algorithm to use for nearest neighbors search,
        passed to neighbors.NearestNeighbors instance.

    n_jobs : int or None, default=None
        The number of parallel jobs to run.
        ``None`` means 1 unless in a :obj:`joblib.parallel_backend` context.
        ``-1`` means using all processors. See :term:`Glossary <n_jobs>`
        for more details.

    metric : str, or callable, default="minkowski"
        The metric to use when calculating distance between instances in a
        feature array. If metric is a string or callable, it must be one of
        the options allowed by :func:`sklearn.metrics.pairwise_distances` for
        its metric parameter.
        If metric is "precomputed", X is assumed to be a distance matrix and
        must be square. X may be a :term:`Glossary <sparse graph>`.

        .. versionadded:: 0.22

    p : int, default=2
        Parameter for the Minkowski metric from
        sklearn.metrics.pairwise.pairwise_distances. When p = 1, this is
        equivalent to using manhattan_distance (l1), and euclidean_distance
        (l2) for p = 2. For arbitrary p, minkowski_distance (l_p) is used.

        .. versionadded:: 0.22

    metric_params : dict, default=None
        Additional keyword arguments for the metric function.

        .. versionadded:: 0.22

    Attributes
    ----------
    embedding_ : array-like, shape (n_samples, n_components)
        Stores the embedding vectors.

    kernel_pca_ : object
        :class:`~sklearn.decomposition.KernelPCA` object used to implement the
        embedding.

    nbrs_ : sklearn.neighbors.NearestNeighbors instance
        Stores nearest neighbors instance, including BallTree or KDtree
        if applicable.

    dist_matrix_ : array-like, shape (n_samples, n_samples)
        Stores the geodesic distance matrix of training data.

    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.decomposition.PCA : Principal component analysis that is a linear
        dimensionality reduction method.
    sklearn.decomposition.KernelPCA : Non-linear dimensionality reduction using
        kernels and PCA.
    MDS : Manifold learning using multidimensional scaling.
    TSNE : T-distributed Stochastic Neighbor Embedding.
    LocallyLinearEmbedding : Manifold learning using Locally Linear Embedding.
    SpectralEmbedding : Spectral embedding for non-linear dimensionality.

    References
    ----------

    .. [1] Tenenbaum, J.B.; De Silva, V.; & Langford, J.C. A global geometric
           framework for nonlinear dimensionality reduction. Science 290 (5500)

    Examples
    --------
    >>> from sklearn.datasets import load_digits
    >>> from sklearn.manifold import Isomap
    >>> X, _ = load_digits(return_X_y=True)
    >>> X.shape
    (1797, 64)
    >>> embedding = Isomap(n_components=2)
    >>> X_transformed = embedding.fit_transform(X[:100])
    >>> X_transformed.shape
    (100, 2)
    é   NÚleft)Úclosedr   ZbothÚautoZarpackZdenseZFWÚDZbruteZkd_treeZ	ball_treeÚprecomputed)Ún_neighborsÚradiusÚn_componentsÚeigen_solverÚtolÚmax_iterÚpath_methodÚneighbors_algorithmÚn_jobsÚpÚmetricÚmetric_paramsÚ_parameter_constraintsé   r   Z	minkowski©r   r   r   r   r    r!   r"   r#   r$   r&   r%   r'   c                C   sL   || _ || _|| _|| _|| _|| _|| _|| _|	| _|
| _	|| _
|| _d S )Nr*   )Úselfr   r   r   r   r    r!   r"   r#   r$   r&   r%   r'   © r,   úQ/home/sam/Atlas/atlas_env/lib/python3.8/site-packages/sklearn/manifold/_isomap.pyÚ__init__´   s    zIsomap.__init__c              	   C   sÐ  | j d k	r&| jd k	r&td| j› d�ƒ‚t| j | j| j| j| j| j| jd�| _	| j	 
|¡ | j	j| _t| j	dƒrx| j	j| _t| jd| j| j| j| jd�| _| j d k	rÆt| j	| j | j| j| jd| jd�}n"t| j	| j| j| j| jd| jd	�}t|ƒ\}}|d
k�rb| jdk�r$t|ƒ�r$td|› d�ƒ‚tjd|› d�dd� tf | j	j|||d| j	jdœ| j	j—Ž}t|| j dd�| _!| j	jj"t#j$k�rž| j!j%| j	jj"dd�| _!| j!d }|d9 }| j &|¡| _'| j'j(d
 | _)d S )Nz<Both n_neighbors and radius are provided. Use Isomap(radius=z=, n_neighbors=None) if intended to use radius-based neighbors)r   r   Ú	algorithmr&   r%   r'   r$   Úfeature_names_in_r   )r   Zkernelr   r    r!   r$   Zdistance)r&   r%   r'   Úmoder$   )r   r&   r%   r'   r1   r$   r   z=The number of connected components of the neighbors graph is zä > 1. The graph cannot be completed with metric='precomputed', and Isomap cannot befitted. Increase the number of neighbors to avoid this issue, or precompute the full distance matrix instead of passing a sparse neighbors graph.zm > 1. Completing the graph to fit Isomap might be slow. Increase the number of neighbors to avoid this issue.r   )Ú
stacklevel)ÚXÚgraphÚn_connected_componentsZcomponent_labelsr1   r&   F)ÚmethodZdirected)Úcopyç      à¿)*r   r   Ú
ValueErrorr   r#   r&   r%   r'   r$   Únbrs_ÚfitZn_features_in_Úhasattrr0   r   r   r   r    r!   Úkernel_pca_r   r   r   r   ÚRuntimeErrorÚwarningsÚwarnr   Z_fit_XZeffective_metric_Zeffective_metric_params_r   r"   Údist_matrix_ÚdtypeÚnpÚfloat32ZastypeÚfit_transformÚ
embedding_ÚshapeZ_n_features_out)r+   r3   Znbgr5   ÚlabelsÚGr,   r,   r-   Ú_fit_transformÑ   s”    ÿù	

ú	
ù
ù

ÿ
û	úù
 ÿ
zIsomap._fit_transformc                 C   sN   d| j d  }tƒ  |¡}| jj}t t |d ¡t |d ¡ ¡|jd  S )a(  Compute the reconstruction error for the embedding.

        Returns
        -------
        reconstruction_error : float
            Reconstruction error.

        Notes
        -----
        The cost function of an isomap embedding is

        ``E = frobenius_norm[K(D) - K(D_fit)] / n_samples``

        Where D is the matrix of distances for the input data X,
        D_fit is the matrix of distances for the output embedding X_fit,
        and K is the isomap kernel:

        ``K(D) = -0.5 * (I - 1/n_samples) * D^2 * (I - 1/n_samples)``
        r8   r   r   )	rA   r   rE   r=   Zeigenvalues_rC   ÚsqrtÚsumrG   )r+   rI   ZG_centerZevalsr,   r,   r-   Úreconstruction_error4  s    zIsomap.reconstruction_errorc                 C   s   |   ¡  |  |¡ | S )a  Compute the embedding vectors for data X.

        Parameters
        ----------
        X : {array-like, sparse matrix, BallTree, KDTree, NearestNeighbors}
            Sample data, shape = (n_samples, n_features), in the form of a
            numpy array, sparse matrix, precomputed tree, or NearestNeighbors
            object.

        y : Ignored
            Not used, present for API consistency by convention.

        Returns
        -------
        self : object
            Returns a fitted instance of self.
        )Ú_validate_paramsrJ   ©r+   r3   Úyr,   r,   r-   r;   M  s    
z
Isomap.fitc                 C   s   |   ¡  |  |¡ | jS )aö  Fit the model from data in X and transform X.

        Parameters
        ----------
        X : {array-like, sparse matrix, BallTree, KDTree}
            Training vector, where `n_samples` is the number of samples
            and `n_features` is the number of features.

        y : Ignored
            Not used, present for API consistency by convention.

        Returns
        -------
        X_new : array-like, shape (n_samples, n_components)
            X transformed in the new space.
        )rN   rJ   rF   rO   r,   r,   r-   rE   c  s    
zIsomap.fit_transformc           	      C   sÚ   t | ƒ | jdk	r(| jj|dd�\}}n| jj|dd�\}}| jj}|jd }t|dƒrl|jt	j
krlt	j
}nt	j}t	 ||f|¡}t|ƒD ]2}t	 | j||  || dd…df  d¡||< qŠ|dC }|d9 }| j |¡S )a›  Transform X.

        This is implemented by linking the points X into the graph of geodesic
        distances of the training data. First the `n_neighbors` nearest
        neighbors of X are found in the training data, and from these the
        shortest geodesic distances from each point in X to each point in
        the training data are computed in order to construct the kernel.
        The embedding of X is the projection of this kernel onto the
        embedding vectors of the training set.

        Parameters
        ----------
        X : {array-like, sparse matrix}, shape (n_queries, n_features)
            If neighbors_algorithm='precomputed', X is assumed to be a
            distance matrix or a sparse graph of shape
            (n_queries, n_samples_fit).

        Returns
        -------
        X_new : array-like, shape (n_queries, n_components)
            X transformed in the new space.
        NT)Zreturn_distancer   rB   r   r8   )r   r   r:   Z
kneighborsZradius_neighborsZn_samples_fit_rG   r<   rB   rC   rD   Úfloat64ZzerosÚrangeÚminrA   r=   Ú	transform)	r+   r3   Z	distancesÚindicesZn_samples_fitZ	n_queriesrB   ZG_XÚir,   r,   r-   rT   x  s    

0zIsomap.transformc                 C   s   dt jt jgiS )NZpreserves_dtype)rC   rQ   rD   )r+   r,   r,   r-   Ú
_more_tags«  s    zIsomap._more_tags)N)N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r   r   r   Úsetr   ÚcallableÚdictr(   Ú__annotations__r.   rJ   rM   r;   rE   rT   rW   r,   r,   r,   r-   r      sD   
 ôòc

3r   )"r[   r?   ÚnumpyrC   Únumbersr   r   Zscipy.sparser   Zscipy.sparse.csgraphr   r   Úbaser   r	   r
   Z	neighborsr   r   r   Zutils.validationr   Údecompositionr   Zpreprocessingr   Zutils.graphr   Zutils._param_validationr   r   Zmetrics.pairwiser   r   r,   r,   r,   r-   Ú<module>   s    