Combine image tiles into composite TIFs
Project description
Utility to take a directory of {z}/{x}/{y}.(jpg|png) tiles, and stitch into a scenetiff (tif w/ exact merc tile bounds). Future versions will support fast indexed reading directly from tar archives.
Install
make a virtual env + activate, then:
pip install untiler
Dev installation
git clone git@github.com:mapbox/untiler.git cd untiler pip install -e .
Usage
Usage: untiler [OPTIONS] COMMAND [ARGS]... Options: --help Show this message and exit. Commands: inspectdir streamdir streammbtiles
streamdir
Given a directory of tiles + a read template, mosaic into tifs at a lower parent “composite” zoom extent
untiler streamdir [OPTIONS] INPUT_DIR OUTPUT_DIR -c, --compositezoom INTEGER Tile size to mosaic into [default=13] -z, --maxzoom INTEGER Force a maxzom [default=max in each compositezoom area] -l, --logdir TEXT Location for log files [default=None] -t, --readtemplate TEXT File path template [default='jpg/{z}/{x}/{y}.jpg'] -s, --scenetemplate TEXT Template for output scenetif filenames [default='{z}-{x}-{y}-tile.tif'] -w, --workers INTEGER Number of workers in the processing pool [default=4] -x, --no-fill Don't fill in with lower zooms --help Show this message and exit.
streammbtiles
Mosaic an mbtiles into tifs of “composite” zoom extent
untiler streammbtiles [OPTIONS] MBTILES OUTPUT_DIR Options: --co NAME=VALUE Driver specific creation options.See the documentation for the selected output driver for more information. -c, --compositezoom INTEGER Tile size to mosaic into [default=13] -z, --maxzoom INTEGER Force a maxzom [default=max in each compositezoom area] -s, --scenetemplate TEXT Template for output scenetif filenames [default='{z}-{x}-{y}-tile.tif'] -w, --workers INTEGER Number of workers in the processing pool [default=4] -x, --no-fill Don't fill in with lower zooms --help Show this message and exit.
inspectdir
Stream [x, y, z]s of a directory
untiler inspectdir [OPTIONS] INPUT_DIR Options: -z, --zoom INTEGER Zoom to inspect [default = all] --help Show this message and exit.
Outputs a line-delimited stream of tile [x, y, z]s; useful to pipe into mercantile shapes to visualize geometry:
untiler inspectdir <dir> -z 19 | mercantile shapes | fio collect | geojsonio
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
untiler-0.2.1.tar.gz
(8.6 kB
view hashes)
Built Distribution
Close
Hashes for untiler-0.2.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6ea8c60e6594ede7b32016c20b8da8b6ca862c0cd07e9c9fea8088b201b9387e |
|
MD5 | 85a0800d8ca93ea269ecd8bee0da5229 |
|
BLAKE2b-256 | d4251eb0207325f41c5eb0924987a3fde8656e8b2a272aa9b732bada36ec78d1 |