https://github.com/mapbox/supermercado

Supercharger for mercantile
https://github.com/mapbox/supermercado

imagery pxm satellite

Last synced: 3 months ago
JSON representation

Supercharger for mercantile

• Host: GitHub
• URL: https://github.com/mapbox/supermercado
• Owner: mapbox
• License: mit
• Created: 2015-11-19T00:58:41.000Z (almost 9 years ago)
• Default Branch: main
• Last Pushed: 2023-11-02T10:22:58.000Z (about 1 year ago)
• Last Synced: 2024-07-18T22:15:41.614Z (4 months ago)
• Topics: imagery, pxm, satellite
• Language: Python
• Homepage:
• Size: 184 KB
• Stars: 125
• Watchers: 110
• Forks: 21
• Open Issues: 17
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
supermercado

============

[![Build Status](https://travis-ci.org/mapbox/supermercado.svg?branch=master)](https://travis-ci.org/mapbox/supermercado) [![codecov.io](https://codecov.io/github/mapbox/supermercado/coverage.svg?token=qkqtUNdabO&branch=master)](https://codecov.io/github/mapbox/supermercado?branch=master)

`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 [email protected]: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 [, , ] tiles, return...

  union  Returns the unioned shape of a stream of...

```

### `supermercado burn`

```

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

```

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

![image](https://cloud.githubusercontent.com/assets/5084513/14003508/94bc0994-f110-11e5-8e99-e9aadf07bf8d.png)

```

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

```

![image](https://cloud.githubusercontent.com/assets/5084513/14003559/d5427ba6-f110-11e5-80d5-a2aba6433e77.png)

### `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

```

![image](https://cloud.githubusercontent.com/assets/5084513/14003587/01e8e370-f111-11e5-8df4-ac3ae07bbf92.png)

### `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

```

![image](https://cloud.githubusercontent.com/assets/5084513/14003622/365af88c-f111-11e5-8712-28f42253e270.png)

### `getting crazy`

```

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

```

![image](https://cloud.githubusercontent.com/assets/5084513/14003951/ccfecf3c-f113-11e5-943b-94bd6eca1536.png)