Skip to main content

Cloud Optimized GeoTIFF (COGEO) creation plugin for rasterio

Project description

rio-cogeo

COG

Cloud Optimized GeoTIFF (COG) creation and validation plugin for Rasterio.

Test Coverage Package version Conda Forge Downloads Downloads


Documentation: https://cogeotiff.github.io/rio-cogeo/

Source Code: https://github.com/cogeotiff/rio-cogeo


Cloud Optimized GeoTIFF

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

  • Internal overviews (User can remove overview with option --overview-level 0)
  • Internal tiles (default profiles have 512x512 internal tiles)

Important: Starting from GDAL 3.1 a new COG generator driver will be added (doc, discussion) and will make rio-cogeo kinda obsolete.

Install

$ pip install -U pip
$ pip install rio-cogeo --pre  # Version 2.0 currently in development

Or install from source:

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

GDAL Version

It is recommanded to use GDAL > 2.3.2. Previous version 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

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

rio-cogeo-2.0a9.tar.gz (16.2 kB view details)

Uploaded Source

File details

Details for the file rio-cogeo-2.0a9.tar.gz.

File metadata

  • Download URL: rio-cogeo-2.0a9.tar.gz
  • Upload date:
  • Size: 16.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.50.0 CPython/3.8.5

File hashes

Hashes for rio-cogeo-2.0a9.tar.gz
Algorithm Hash digest
SHA256 c6b02d06f7a713aea54ce3908fe989d918805369a764caae34c0536935ec23c1
MD5 aa0cabd77e6bc5742c37fe6f4efe16b6
BLAKE2b-256 e24b68292264c143a4378911baa6304a3d798ecddd78350ee0556396ff0b7fd8

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page