U
    ½mœd!  ã                   @   sÞ   d Z ddlmZ ddlmZmZ ddlmZ ddlZddl	Z
ddl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 edddd�Zedddd�ZdZe e¡Zde
jfdd„Zdd„ Zdd„ Zdddœdd„ZdS ) a½  
=============================
Species distribution dataset
=============================

This dataset represents the geographic distribution of species.
The dataset is provided by Phillips et. al. (2006).

The two species are:

 - `"Bradypus variegatus"
   <http://www.iucnredlist.org/details/3038/0>`_ ,
   the Brown-throated Sloth.

 - `"Microryzomys minutus"
   <http://www.iucnredlist.org/details/13408/0>`_ ,
   also known as the Forest Small Rice Rat, a rodent that lives in Peru,
   Colombia, Ecuador, Peru, and Venezuela.

References
----------

`"Maximum entropy modeling of species geographic distributions"
<http://rob.schapire.net/papers/ecolmod.pdf>`_ S. J. Phillips,
R. P. Anderson, R. E. Schapire - Ecological Modelling, 190:231-259, 2006.

Notes
-----

For an example of using this dataset, see
:ref:`examples/applications/plot_species_distribution_modeling.py
<sphx_glr_auto_examples_applications_plot_species_distribution_modeling.py>`.
é    )ÚBytesIO)ÚmakedirsÚremove)ÚexistsNé   )Úget_data_home)Ú_fetch_remote)ÚRemoteFileMetadataé   )ÚBunch)Ú_pkl_filepathzsamples.zipz.https://ndownloader.figshare.com/files/5976075Z@abb07ad284ac50d9e6d20f1c4211e0fd3c098f7f85955e89d321ee8efe37ac28)ÚfilenameÚurlZchecksumzcoverages.zipz.https://ndownloader.figshare.com/files/5976078Z@4d862674d72e79d6cee77e63b98651ec7926043ba7d39dcb31329cf3f6073807zspecies_coverage.pkzé   c                    sb   ‡ fdd„t |ƒD ƒ}dd„ ‰t‡fdd„|D ƒƒ}tjˆ |d�}t|d ƒ}|dkr^d||< |S )	zjLoad a coverage file from an open file object.

    This will return a numpy array of the given dtype
    c                    s   g | ]}ˆ   ¡ ‘qS © )Úreadline)Ú.0Ú_)ÚFr   ú`/home/sam/Atlas/atlas_env/lib/python3.8/site-packages/sklearn/datasets/_species_distributions.pyÚ
<listcomp>R   s     z"_load_coverage.<locals>.<listcomp>c                 S   s   |   ¡ d t|   ¡ d ƒfS )Nr   r   )ÚsplitÚfloat)Útr   r   r   Ú<lambda>S   ó    z _load_coverage.<locals>.<lambda>c                    s   g | ]}ˆ |ƒ‘qS r   r   )r   Úline)Ú
make_tupler   r   r   T   s     ©Údtypes   NODATA_valueiñØÿÿ)ÚrangeÚdictÚnpÚloadtxtÚint)r   Úheader_lengthr   ÚheaderÚMZnodatar   )r   r   r   Ú_load_coverageM   s    r(   c                 C   s6   |   ¡  d¡ ¡  d¡}tj| dddd�}||j_|S )zÃLoad csv file.

    Parameters
    ----------
    F : file object
        CSV file open in byte mode.

    Returns
    -------
    rec : np.ndarray
        record array representing the data
    Úasciiú,r   z	a22,f4,f4)ZskiprowsÚ	delimiterr   )r   ÚdecodeÚstripr   r"   r#   r   Únames)r   r.   Zrecr   r   r   Ú	_load_csv]   s    r/   c                 C   s`   | j | j }|| j| j  }| j| j }|| j| j  }t ||| j¡}t ||| j¡}||fS )a%  Construct the map grid from the batch object

    Parameters
    ----------
    batch : Batch object
        The object returned by :func:`fetch_species_distributions`

    Returns
    -------
    (xgrid, ygrid) : 1-D arrays
        The grid corresponding to the values in batch.coverages
    )Úx_left_lower_cornerÚ	grid_sizeÚNxÚy_left_lower_cornerÚNyr"   Zarange)ÚbatchZxminZxmaxZyminZymaxZxgridZygridr   r   r   Úconstruct_gridsq   s    r6   T)Ú	data_homeÚdownload_if_missingc              	   C   s‚  t | ƒ} t| ƒst| ƒ tdddddd�}tj}t| tƒ}t|ƒ�st|sPtdƒ‚t	 
dtj| f ¡ tt| d	�}t |¡�>}|jD ]0}t|| ƒ}d
|kr¢t|ƒ}	d|kr‚t|ƒ}
q‚W 5 Q R X t|ƒ t	 
dtj| f ¡ tt| d	�}t |¡�N}g }|jD ].}t|| ƒ}t	 d |¡¡ | t|ƒ¡ qütj||d�}W 5 Q R X t|ƒ tf ||
|	dœ|—Ž}tj||dd� n
t |¡}|S )aX
  Loader for species distribution dataset from Phillips et. al. (2006).

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

    Parameters
    ----------
    data_home : str, default=None
        Specify another download and cache folder for the datasets. By default
        all scikit-learn data is stored in '~/scikit_learn_data' subfolders.

    download_if_missing : bool, default=True
        If False, raise a IOError if the data is not locally available
        instead of trying to download the data from the source site.

    Returns
    -------
    data : :class:`~sklearn.utils.Bunch`
        Dictionary-like object, with the following attributes.

        coverages : array, shape = [14, 1592, 1212]
            These represent the 14 features measured
            at each point of the map grid.
            The latitude/longitude values for the grid are discussed below.
            Missing data is represented by the value -9999.
        train : record array, shape = (1624,)
            The training points for the data.  Each point has three fields:

            - train['species'] is the species name
            - train['dd long'] is the longitude, in degrees
            - train['dd lat'] is the latitude, in degrees
        test : record array, shape = (620,)
            The test points for the data.  Same format as the training data.
        Nx, Ny : integers
            The number of longitudes (x) and latitudes (y) in the grid
        x_left_lower_corner, y_left_lower_corner : floats
            The (x,y) position of the lower-left corner, in degrees
        grid_size : float
            The spacing between points of the grid, in degrees

    Notes
    -----

    This dataset represents the geographic distribution of species.
    The dataset is provided by Phillips et. al. (2006).

    The two species are:

    - `"Bradypus variegatus"
      <http://www.iucnredlist.org/details/3038/0>`_ ,
      the Brown-throated Sloth.

    - `"Microryzomys minutus"
      <http://www.iucnredlist.org/details/13408/0>`_ ,
      also known as the Forest Small Rice Rat, a rodent that lives in Peru,
      Colombia, Ecuador, Peru, and Venezuela.

    - For an example of using this dataset with scikit-learn, see
      :ref:`examples/applications/plot_species_distribution_modeling.py
      <sphx_glr_auto_examples_applications_plot_species_distribution_modeling.py>`.

    References
    ----------

    * `"Maximum entropy modeling of species geographic distributions"
      <http://rob.schapire.net/papers/ecolmod.pdf>`_
      S. J. Phillips, R. P. Anderson, R. E. Schapire - Ecological Modelling,
      190:231-259, 2006.
    g33333³WÀi¼  gfffffLÀi8  gš™™™™™©?)r0   r2   r3   r4   r1   z1Data not found and `download_if_missing` is Falsez&Downloading species data from %s to %s)ÚdirnameÚtrainÚtestz'Downloading coverage data from %s to %sz - converting {}r   )Ú	coveragesr;   r:   é	   )Úcompress)r   r   r   r!   r"   Úint16r   ÚDATA_ARCHIVE_NAMEÚIOErrorÚloggerÚinfoÚSAMPLESr   r   ÚloadÚfilesr   r/   r   Ú	COVERAGESÚdebugÚformatÚappendr(   Zasarrayr   ÚjoblibÚdump)r7   r8   Zextra_paramsr   Úarchive_pathZsamples_pathÚXÚfZfhandler:   r;   Zcoverages_pathr<   Zbunchr   r   r   Úfetch_species_distributionsŒ   sR    Eû


ÿ

rP   )Ú__doc__Úior   Úosr   r   Úos.pathr   ÚloggingÚnumpyr"   rK   Ú r   Ú_baser   r	   Úutilsr   r   rD   rG   r@   Ú	getLoggerÚ__name__rB   r?   r(   r/   r6   rP   r   r   r   r   Ú<module>   s6   'ýý
