https://github.com/cogeotiff/rio-cogeo
Cloud Optimized GeoTIFF creation and validation plugin for rasterio
https://github.com/cogeotiff/rio-cogeo
cog cogeotiff geotiff rasterio satellite
Last synced: 4 months ago
JSON representation
Cloud Optimized GeoTIFF creation and validation plugin for rasterio
- Host: GitHub
- URL: https://github.com/cogeotiff/rio-cogeo
- Owner: cogeotiff
- License: bsd-3-clause
- Created: 2018-03-09T16:18:29.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2026-03-30T20:41:39.000Z (4 months ago)
- Last Synced: 2026-04-02T08:06:23.064Z (4 months ago)
- Topics: cog, cogeotiff, geotiff, rasterio, satellite
- Language: Python
- Homepage: https://cogeotiff.github.io/rio-cogeo/
- Size: 41.5 MB
- Stars: 382
- Watchers: 36
- Forks: 46
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://github.com/cogeotiff/cog-spec/blob/master/spec.md), 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](https://gdal.org/drivers/raster/cog.html), [discussion](https://lists.osgeo.org/pipermail/gdal-dev/2019-May/050169.html)), starting with `rio-cogeo` version 2.2, `--use-cog-driver` option was added to create COG using the `COG` driver.
## Install
```bash
$ pip install -U pip
$ pip install rio-cogeo
```
Or install from source:
```bash
$ 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](https://github.com/mapbox/rio-glui/) or [rio-viz](https://github.com/developmentseed/rio-viz) rasterio plugins to explore COG locally in your web browser.
## Contribution & Development
See [CONTRIBUTING.md](https://github.com/cogeotiff/rio-cogeo/blob/main/CONTRIBUTING.md)
## Changes
See [CHANGES.md](https://github.com/cogeotiff/rio-cogeo/blob/main/CHANGES.md).
## License
See [LICENSE](https://github.com/cogeotiff/rio-cogeo/blob/main/LICENSE)