Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Supercharged mercantile

Project description

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 git@github.com: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

Project details


Download files

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

Files for supermercado, version 0.0.5
Filename, size File type Python version Upload date Hashes
Filename, size supermercado-0.0.5.tar.gz (5.5 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page