rio-cogeo
Cloud Optimized GeoTIFF (COG) creation and validation plugin for Rasterio.
Documentation: https://cogeotiff.github.io/rio-cogeo/
Source Code: https://github.com/cogeotiff/rio-cogeo
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:
- Internal overviews (User can remove overview with option
--overview-level 0) - Internal tiles (default profiles have 512x512 internal tiles)
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
Release files for rio-cogeo 7.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| rio_cogeo-7.0.3.tar.gz | 19.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| rio_cogeo-7.0.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 41.2 kB
Release files / rio_cogeo-7.0.3.tar.gz
| Download URL | rio_cogeo-7.0.3.tar.gz |
|---|---|
| Size | 19.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1e0104c49908d3175c5647b8ee2c5ed9f86cca84afe88af0ef623f28d85a1850
|
|
BLAKE2b-256 checksum How to use checksums |
68dee81e743e304a46da2f89540dae0f15a793b9c62fcad2a1229687bb8a3b38
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 24, 2026.
Transparency logRelease files / rio_cogeo-7.0.3-py3-none-any.whl
| Download URL | rio_cogeo-7.0.3-py3-none-any.whl |
|---|---|
| Size | 21.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
63b33767251002e9f3692772aa88282cd465c1412834d9462a2e30d1c7e77472
|
|
BLAKE2b-256 checksum How to use checksums |
9a65b610e10335c2d40170864486e12d88eb5888222c58b4bf17d73c780c1841
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 24, 2026.
Transparency log
