Home

Awesome

rio-cogeo

<p align="center"> <img src="https://www.cogeo.org/images/logo/Cog-02.png" style="width: 200px;" alt="COG"></a> </p> <p align="center"> <em>Cloud Optimized GeoTIFF (COG) creation and validation plugin for Rasterio.</em> </p> <p align="center"> <a href="https://github.com/cogeotiff/rio-cogeo/actions?query=workflow%3ACI" target="_blank"> <img src="https://github.com/cogeotiff/rio-cogeo/workflows/CI/badge.svg" alt="Test"> </a> <a href="https://codecov.io/gh/cogeotiff/rio-cogeo" target="_blank"> <img src="https://codecov.io/gh/cogeotiff/rio-cogeo/branch/main/graph/badge.svg" alt="Coverage"> </a> <a href="https://pypi.org/project/rio-cogeo" target="_blank"> <img src="https://img.shields.io/pypi/v/rio-cogeo?color=%2334D058&label=pypi%20package" alt="Package version"> </a> <a href="https://anaconda.org/conda-forge/rio-cogeo" target="_blank"> <img src="https://img.shields.io/conda/v/conda-forge/rio-cogeo.svg" alt="Conda Forge"> </a> <a href="https://pypistats.org/packages/rio-cogeo" target="_blank"> <img src="https://img.shields.io/pypi/dm/rio-cogeo.svg" alt="Downloads"> </a> <a href="https://github.com/cogeotiff/rio-cogeo/blob/main/LICENSE" target="_blank"> <img src="https://img.shields.io/github/license/cogeotiff/rio-cogeo.svg" alt="Downloads"> </a> </p>

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

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


Cloud Optimized GeoTIFF

This plugin aims to facilitate the creation and validation of Cloud Optimized GeoTIFF (COG or COGEO). While it respects the COG specifications, this plugin also enforces several features:

Important: in GDAL 3.1 a new COG driver has been added (doc, discussion), starting with rio-cogeo version 2.2, --use-cog-driver option was added to create COG using the COG driver.

Install

$ pip install -U pip
$ pip install rio-cogeo

Or install from source:

$ pip install -U pip
$ pip install git+https://github.com/cogeotiff/rio-cogeo.git

GDAL Version

It is recommended to use GDAL > 2.3.2. Previous versions might not be able to create proper COGs (ref: https://github.com/OSGeo/gdal/issues/754).

More info in https://github.com/cogeotiff/rio-cogeo/issues/55

More

Blog post on good and bad COG formats: https://medium.com/@_VincentS_/do-you-really-want-people-using-your-data-ec94cd94dc3f

Checkout rio-glui or rio-viz rasterio plugins to explore COG locally in your web browser.

Contribution & Development

See CONTRIBUTING.md

Changes

See CHANGES.md.

License

See LICENSE