Metadata-Version: 2.1
Name: label-maker
Version: 0.5.1
Summary: Data preparation for satellite machine learning
Home-page: https://github.com/developmentseed/label-maker/
Author: Drew Bollinger
Author-email: drew@developmentseed.org
License: MIT
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
Requires-Dist: Cerberus (==1.1)
Requires-Dist: click (==6.7)
Requires-Dist: geojson (==2.3.0)
Requires-Dist: homura (==0.1.5)
Requires-Dist: humanize (==0.5.1)
Requires-Dist: mapbox-vector-tile (==1.2.0)
Requires-Dist: mbutil (==0.3.0)
Requires-Dist: mercantile (==1.0.0)
Requires-Dist: numpy (==1.13.3)
Requires-Dist: olefile (==0.44)
Requires-Dist: Pillow (==4.3.0)
Requires-Dist: protobuf (==3.5.0.post1)
Requires-Dist: pyclipper (==1.0.6)
Requires-Dist: pycurl (==7.43.0.1)
Requires-Dist: pyproj (==1.9.5.1)
Requires-Dist: rasterio (==1.0a12)
Requires-Dist: requests (>=2.20.0)
Requires-Dist: Shapely (>=1.6.3)
Requires-Dist: six (==1.10.0)
Requires-Dist: tilepie (==0.2.1)

# Label Maker
## Data Preparation for Satellite Machine Learning

The tool downloads [OpenStreetMap QA Tile]((https://osmlab.github.io/osm-qa-tiles/)) information and satellite imagery tiles and saves them as an [`.npz` file](https://docs.scipy.org/doc/numpy/reference/generated/numpy.savez.html) for use in machine learning training.

![example classification image overlaid over satellite imagery](examples/images/classification.png)
_satellite imagery from [Mapbox](https://www.mapbox.com/) and [Digital Globe](https://www.digitalglobe.com/)_

## Requirements
- [Python 3.6](https://www.python.org/)
- [tippecanoe](https://github.com/mapbox/tippecanoe)

## Installation

```bash
pip install label-maker
```

Note that running this library this requires `tippecanoe` as a "peer-dependency" and that command should be available from your command-line before running this.

## Documentation

Full documentation is available here: http://devseed.com/label-maker/

## Acknowledgements

This library builds on the concepts of [skynet-data](https://github.com/developmentseed/skynet-data). It wouldn't be possible without the excellent data from OpenStreetMap and Mapbox under the following licenses:
- OSM QA tile data [copyright OpenStreetMap contributors](http://www.openstreetmap.org/copyright) and licensed under [ODbL](http://opendatacommons.org/licenses/odbl/)
- Mapbox Satellite data can be [traced for noncommercial purposes](https://www.mapbox.com/tos/#[YmtMIywt]).

It also relies heavily on Marc Farra's [tilepie](https://github.com/kamicut/tilepie) to asynchronously process vector tiles


