Skip to main content

CloudOptimized GeoTIFF (COGEO) creation plugin for rasterio

Project description

CloudOptimized GeoTIFF (COGEO) creation plugin for rasterio


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

Or install from source:

$ git clone
$ cd rio-cogeo
$ pip install -U pip
$ pip install -e .


$ rio cogeo --help
Usage: rio cogeo [OPTIONS] INPUT OUTPUT

  Create Cloud Optimized Geotiff.

  -b, --bidx BIDX                 Band index to copy
  -p, --cog-profile [ycbcr|zstd|lzw|deflate|packbits|raw]
                                  CloudOptimized GeoTIFF profile (default: ycbcr)
  --nodata INTEGER                Force mask creation from a given nodata value
  --alpha INTEGER                 Force mask creation from a given alpha band number
  --overview-level INTEGER        Overview level (default: 6)
  --threads INTEGER
  --co, --profile NAME=VALUE      Driver specific creation options.See the
                                  documentation for the selected output driver
                                  for more information.
  --help                          Show this message and exit.


# Create a COGEO with YCbCR profile and the first 3 bands of the data
$ rio cogeo mydataset.tif mydataset_ycbcr.tif -b 1,2,3

# Create a COGEO without compression and with 1024x1024 block size
$ rio cogeo mydataset.tif mydataset_raw.tif --co BLOCKXSIZE=1024 --co BLOCKYSIZE=1024 --cog-profile raw

Default COGEO profiles

Profiles can be extended by providing ‘–co’ option in command line (e.g: rio cogeo mydataset.tif mydataset_zstd.tif -b 1,2,3 –profile deflate –co “COMPRESS=ZSTD” )


  • JPEG compression
  • PIXEL interleave
  • YCbCr colorspace
  • limited to uint8 datatype and 3 bands data


  • ZSTD compression
  • PIXEL interleave
  • Available for GDAL>=2.3.0


  • LZW compression
  • PIXEL interleave


  • DEFLATE compression
  • PIXEL interleave


  • PACKBITS compression
  • PIXEL interleave


  • NO compression
  • PIXEL interleave

Default profiles are tiled with 512x512 blocksizes.

Contribution & Devellopement

Issues and pull requests are more than welcome.

dev install

$ git clone
$ cd rio-cogeo
$ pip install -e .[dev]

Python3.6 only

This repo is set to use pre-commit to run flake8, pydocstring and black (“uncompromising Python code formatter”) when commiting new code.

$ pre-commit install


Checkout rio-glui ( rasterio plugin to explore COG locally in your web browser.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
rio-cogeo-1.0.dev6.tar.gz (5.3 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page