A Go-based single-band GeoTIFF to PNG mbtiles creator.
Requires GDAL >= 3.4 to be installed on the system.
WARNING this project has been superseded by rastertiler-rs, a better, faster implementation in Rust. This project will no longer be actively developed. See below for more information.
go get https://github.com/brendan-ward/rastertiler
Create an MBTiles tileset from a single-band GeoTIFF
Usage:
rastertiler create [IN.tiff] [OUT.mbtiles] [flags]
Flags:
-a, --attribution string tileset description
-c, --colormap string colormap '<value>:<hex>,<value>:<hex>'. Only valid for 8-bit data
-d, --description string tileset description
-h, --help help for create
-z, --maxzoom uint8 maximum zoom level
-Z, --minzoom uint8 minimum zoom level
-n, --name string tileset name
-s, --tilesize int tile size in pixels (default 256)
-w, --workers int number of workers to create tiles (default 4)
To create MBtiles from a single-band uint8
GeoTIFF:
rastertiler create example.tif example.mbtiles --minzoom 0 --maxzoom 2
By default, this will render grayscale PNG tiles.
To use a colormap to render the uint8
data to paletted PNG
rastertiler create example.tif example.mbtiles --minzoom 0 --maxzoom 2 --colormap "1:#686868,2:#fbb4b9,3:#c51b8a,4:#49006a"
This project has been superseded by a port into Rust: https://github.com/brendan-ward/rastertiler-rs
Because this project uses GDAL for reading and warping data from a GeoTIFF to create many tiles, the calls using CGO were in a hot loop and incurred more overhead than is ideal. The Rust implementation does not incur this overhead and is roughly 20% faster. The Rust PNG library also provided more flexibility for writing RGB and paletted images.
GDAL bindings inspired by:
See also raster-tilecutter which does much the same thing, in Python, using rasterio
.
Parts of this project are adapted from arrowtiler.
This project was developed with the support of the U.S. Fish and Wildlife Service Southeast Conservation Adaptation Strategy for use in the Southeast Conservation Blueprint Viewer and South Atlantic Conservation Blueprint Simple Viewer.