supermercado 0.0.3

Supercharged mercantile

supermercado
============

|Build Status| |codecov.io|

``supermercado`` extends the functionality of
```mercantile`` <https://github.com/mapbox/mercantile>`__ with
additional commands

Installation
------------

**From pypi**

::

pip install supermercado

**To develop locally**

::

git clone [e-mail]:mapbox/supermercado.git
cd supermercado
pip install -e .

Usage
-----

::

Usage: supermercado [OPTIONS] COMMAND [ARGS]...

Options:
--help Show this message and exit.

Commands:
burn Burn a stream of GeoJSON into a output...
edges For a stream of [<x>, <y>, <z>] tiles, return...
union Returns the unioned shape of a steeam of...

``supermercado burn``
~~~~~~~~~~~~~~~~~~~~~

::

<{geojson} stream> | supermercado burn <zoom> | <[x, y, z] stream>

Takes an input stream of GeoJSON and returns a stream of intersecting
``[x, y, z]``\ s for a given zoom.

.. figure:: https://cloud.githubusercontent.com/assets/5084513/14003508/94bc0994-f110-11e5-8e99-e9aadf07bf8d.png
:alt: image

image

::

cat data/ellada.geojson | supermercado burn 10 | mercantile shapes | fio collect

.. figure:: https://cloud.githubusercontent.com/assets/5084513/14003559/d5427ba6-f110-11e5-80d5-a2aba6433e77.png
:alt: image

image

``supermercado edges``
~~~~~~~~~~~~~~~~~~~~~~

::

<[x, y, z] stream> | supermercado edges | <[x, y, z] stream>

Outputs a stream of ``[x, y, z]``\ s representing the edge tiles of an
input stream of ``[x, y, z]``\ s. Edge tile = any tile that is either
directly adjacent to a tile that does not exist, or diagonal to an empty
tile.

::

cat data/ellada.geojson | supermercado burn 10 | supermercado edges | mercantile shapes | fio collect | geojsonio

.. figure:: https://cloud.githubusercontent.com/assets/5084513/14003587/01e8e370-f111-11e5-8df4-ac3ae07bbf92.png
:alt: image

image

``supermercado union``
~~~~~~~~~~~~~~~~~~~~~~

::

<[x, y, z] stream> | supermercado union | <{geojson} stream>

Outputs a stream of unioned GeoJSON from an input stream of
``[x, y, z]``\ s. Like ``mercantile shapes`` but as an overall footprint
instead of individual shapes for each tile.

::

cat data/ellada.geojson | supermercado burn 10 | supermercado union | fio collect | geojsonio

.. figure:: https://cloud.githubusercontent.com/assets/5084513/14003622/365af88c-f111-11e5-8712-28f42253e270.png
:alt: image

image

``getting crazy``
~~~~~~~~~~~~~~~~~

::

cat data/ellada.geojson | supermercado burn 12 | supermercado edges | supermercado union | fio collect | geojsonio

.. figure:: https://cloud.githubusercontent.com/assets/5084513/14003951/ccfecf3c-f113-11e5-943b-94bd6eca1536.png
:alt: image

image

.. |Build Status| .. image:: https://travis-ci.org/mapbox/supermercado.svg?branch=master
:target: https://travis-ci.org/mapbox/supermercado
.. |codecov.io| image:: https://codecov.io/github/mapbox/supermercado/coverage.svg?token=qkqtUNdabO&branch=master
:target: https://codecov.io/github/mapbox/supermercado?branch=master