Home

Awesome

rio-tiler

<p align="center"> <img src="https://user-images.githubusercontent.com/10407788/88133997-77560f00-cbb1-11ea-874c-a8f1d123a9df.jpg" style="max-width: 800px;" alt="rio-tiler"></a> </p> <p align="center"> <em>User friendly Rasterio plugin to read raster datasets.</em> </p> <p align="center"> <a href="https://github.com/cogeotiff/rio-tiler/actions?query=workflow%3ACI" target="_blank"> <img src="https://github.com/cogeotiff/rio-tiler/workflows/CI/badge.svg" alt="Test"> </a> <a href="https://codecov.io/gh/cogeotiff/rio-tiler" target="_blank"> <img src="https://codecov.io/gh/cogeotiff/rio-tiler/branch/main/graph/badge.svg" alt="Coverage"> </a> <a href="https://pypi.org/project/rio-tiler" target="_blank"> <img src="https://img.shields.io/pypi/v/rio-tiler?color=%2334D058&label=pypi%20package" alt="Package version"> </a> <a href="https://anaconda.org/conda-forge/rio-tiler" target="_blank"> <img src="https://img.shields.io/conda/v/conda-forge/rio-tiler.svg" alt="Conda Forge"> </a> <a href="https://pypistats.org/packages/rio-tiler" target="_blank"> <img src="https://img.shields.io/pypi/dm/rio-tiler.svg" alt="Downloads"> </a> <a href="https://github.com/cogeotiff/rio-tiler/blob/main/LICENSE" target="_blank"> <img src="https://img.shields.io/github/license/cogeotiff/rio-tiler.svg" alt="Downloads"> </a> <a href="https://mybinder.org/v2/gh/cogeotiff/rio-tiler/main?filepath=docs%2Fexamples%2F" target="_blank" alt="Binder"> <img src="https://mybinder.org/badge_logo.svg" alt="Binder"> </a> </p>

Documentation: <a href="https://cogeotiff.github.io/rio-tiler/" target="_blank">https://cogeotiff.github.io/rio-tiler/</a>

Source Code: <a href="https://github.com/cogeotiff/rio-tiler" target="_blank">https://github.com/cogeotiff/rio-tiler</a>


Description

rio-tiler was initially designed to create slippy map tiles from large raster data sources and render these tiles dynamically on a web map. Since rio-tiler v2.0, we added many more helper methods to read data and metadata from any raster source supported by Rasterio/GDAL. This includes local and remote files via HTTP, AWS S3, Google Cloud Storage, etc.

At the low level, rio-tiler is just a wrapper around the rasterio and GDAL libraries.

Features

Install

You can install rio-tiler using pip

$ python -m pip install -U pip
$ python -m pip install -U rio-tiler

or install from source:

$ git clone https://github.com/cogeotiff/rio-tiler.git
$ cd rio-tiler
$ python -m pip install -U pip
$ python -m pip install -e .

Plugins

rio-tiler-pds

rio-tiler v1 included several helpers for reading popular public datasets (e.g. Sentinel 2, Sentinel 1, Landsat 8, CBERS) from cloud providers. This functionality is now in a separate plugin, enabling easier access to more public datasets.

rio-tiler-mvt

Create Mapbox Vector Tiles from raster sources

Implementations

titiler: A lightweight Cloud Optimized GeoTIFF dynamic tile server.

cogeo-mosaic: Create mosaics of Cloud Optimized GeoTIFF based on the mosaicJSON specification.

Contribution & Development

See CONTRIBUTING.md

Authors

The rio-tiler project was begun at Mapbox and was transferred to the cogeotiff Github organization in January 2019.

See AUTHORS.txt for a listing of individual contributors.

Changes

See CHANGES.md.

License

See LICENSE