rio-rgbify

Encode arbitrary bit depth rasters in pseudo base-256 as RGB

Installation

git clone https://github.com/acalcutt/rio-rgbify.git

cd rio-rgbify

pip install -e '.[test]'

CLI usage

• Input can be any raster readable by rasterio
• Output can be any raster format writable by rasterio OR
• To create tiles directly from data (recommended), output to an .mbtiles

Usage: rio rgbify [OPTIONS] SRC_PATH DST_PATH

Options:
  -b, --base-val FLOAT                The base value of which to base the output
                                      encoding on [DEFAULT=0]
  -i, --interval FLOAT                Describes the precision of the output, by
                                      incrementing interval [DEFAULT=1]
  -r, --round-digits INTEGER          Less significants encoded bits to be set to
                                      0. Round the values, but have better images
                                      compression [DEFAULT=0]
  -e, --encoding [mapbox|terrarium]   RGB encoding to use on the tiles
  --bidx INTEGER                      Band to encode [DEFAULT=1]
  --max-z INTEGER                     Maximum zoom to tile (.mbtiles output only)
  --bounding-tile TEXT                Bounding tile '[{x}, {y}, {z}]' to limit
                                      output tiles (.mbtiles output only)
  --min-z INTEGER                     Minimum zoom to tile (.mbtiles output only)
  --format [png|webp]                 Output tile format (.mbtiles output only)
  -j, --workers INTEGER               Workers to run [DEFAULT=4]
  -v, --verbose
  --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.

Mapbox TerrainRGB example

rio rgbify -e mapbox -b -10000 -i 0.1 --min-z 0 --max-z 8 -j 24 --format png SRC_PATH.vrt DST_PATH.mbtiles

Mapzen Terrarium example

rio rgbify  -e terrarium --min-z 0 --max-z 8 -j 24 --format png SRC_PATH.vrt DST_PATH.mbtiles