Skip to main content

Legendgrams are map legends that visualize the distribution of observations by color in a given map

Project 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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

legendgram-0.0.2.tar.gz (683.6 kB view hashes)

Uploaded Source

Built Distribution

legendgram-0.0.2-py2.py3-none-any.whl (7.5 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page