CloudOptimized GeoTIFF (COGEO) creation plugin for rasterio
Project description
CloudOptimized GeoTIFF (COGEO) creation plugin for rasterio
Install
$ pip install -U pip
$ pip install rio-cogeoOr install from source:
$ git clone https://github.com/mapbox/rio-cogeo.git
$ cd rio-cogeo
$ pip install -U pip
$ pip install -e .Usage
$ rio cogeo --help
Usage: rio cogeo [OPTIONS] INPUT OUTPUT
Create Cloud Optimized Geotiff.
Options:
-b, --bidx BIDX Band index to copy (default: 1,2,3)
-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.Examples
# 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 wiht 1024x1024 block size
$ rio cogeo mydataset.tif mydataset_raw.tif -co BLOCKXSIZE=1024 -co BLOCKXSIZE=1024 --cog-profile rawDefault 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” )
YCbCr
JPEG compression
PIXEL interleave
YCbCr colorspace
limited to uint8 datatype and 3 bands data
ZSTD
ZSTD compression
PIXEL interleave
Available for GDAL>=2.3.0
LZW
LZW compression
PIXEL interleave
DEFLATE
DEFLATE compression
PIXEL interleave
PACKBITS
PACKBITS compression
PIXEL interleave
RAW
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 https://github.com/mapbox/rio-cogeo.git
$ 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 installExtras
Checkout rio-glui (https://github.com/mapbox/rio-glui/) rasterio plugin to explore COG locally in your web browser.
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
File details
Details for the file rio-cogeo-1.0.dev2.tar.gz.
File metadata
- Download URL: rio-cogeo-1.0.dev2.tar.gz
- Upload date:
- Size: 5.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 4e5d1be9e60cd2078b32ba4ecb2f5e5113e1dbed847a1fff022b5cdbf78d6a1d |
|
| MD5 | 5b858b8991972f03cfa3dec7a1501b65 |
|
| BLAKE2b-256 | 7b272daa186a29c9f28e7d6266b8574c57689d99e15a17fe657c4551518a853c |
