Metadata-Version: 1.1
Name: legendgram
Version: 0.0.2
Summary: Legendgrams are map legends that visualize the distribution of observations by color in a given map
Home-page: https://github.com/pysal/legendgram
Author: Dani Arribas-Bel, Levi John Wolf
Author-email: daniel.arribas.bel@gmail.com, levi.john.wolf@gmail.com
License: MIT
Description-Content-Type: UNKNOWN
Description: 
        Legendgrams
        ========================
        
        This is a small bit of unittested, reproducible code to provide ``legendgrams.''
        Legendgrams are map legends that visualize the distribution of observations by color in a given map:
        
        .. image:: https://raw.githubusercontent.com/pysal/legendgram/master/figs/brooklyn.png
                :width: 40%
                :height: 200px
                :scale: 50%
                :alt: Silhouettes in Brooklyn
        
        PySAL_ is an open source cross-platform library of spatial analysis functions
        written in Python. It is intended to support the development of high level
        applications for spatial analysis.
        
        To use legendgrams, simply install the package using pip:
        
        .. code-block:: bash
        
            $ pip install pysal
        
        Then, apply the function to the figure/axis you want to have a legendgram:
        
        .. code-block:: python
            
            >>> import pysal as ps, geopandas as gpd, matplotlib.pyplot as plt
            >>> data = gpd.read_file(ps.examples.get_path('south.shp'))
            >>> data.crs = {'init': 'epgs:4269'}
            >>> data.to_crs(epsg=5070)
            >>> f,ax = plt.subplots()
            >>> data.plot('DV80', k=10, cmap='inferno', ax=ax, scheme='Quantiles')
            >>> bins = ps.Quantiles(data['DV80'].values).bins
            >>> from legendgram import legendgram
            >>> import palettable.matplotlib as palmpl
            >>> legendgram(f,ax,data['DV80'],bins,pal=palmpl.Inferno_10,
                           legend_size=(.5,.2), # legend size in fractions of the axis
                           loc = 'upper left' # matplotlib-style legend locations
                           clip = (2,10) # clip the displayed range of the histogram
                           )
        
        .. image:: https://raw.githubusercontent.com/pysal/legendgram/master/figs/example.png
                :width: 100%
                :alt: Example legendgram map in the US south
        
        
        License
        -------
        
        This is licensed under the 3-Clause BSD license. 
        Refer to the license file for more details. 
Platform: UNKNOWN
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
