Tool that allows to easily deploy an environment able to work with geotiff files containing Digital Elevation Model (DEM) data. It is focused on the generation of raster MBTiles pyramids, containing a Mapbox Terrain-RGB tileset with the elevation data encoded in Terrain-RGB tiles. Those tiles can be used to represent the topographic surface of the Earth.

First of all, there are some environment variables that need to be established in the .env file, which are the following:

MIN_ZOOM           # min zoom to generate
MAX_ZOOM           # max zoom to generate
INPUT_FILE         # name of the input raster file
OUTPUT_FILE        # name of the output mbtiles file
WORKERS            # workers to run [DEFAULT=4]

Also, you can ask for a help message if you need

make help

To work with this tool you need Docker.

• Install Docker. Minimum version is 1.12.3+.

The docker image is based on osgeo/gdal. For the raster data management, rasterio and a few plugins from the RasterIO Plugin Registry, such as rio-mbtiles and a custom and powered version of rio-rgbify, are installed.

Then, you can build the container from the dockerfile

make build-docker

Or simply run it using the image from the Docker Hub as follows.

By default, it is generated in the data directory.

make generate-pyramid-rgb

You can run a bash shell inside the docker container if you want to run some more detailed commands

make bash

If you are wondering the resolution per zoom, check the following table.

Arc resolution per zoom and data sources, per pixel:

Credits: Mapzen documentation.

Fran Martín

This project is licensed under the MIT License - see the LICENSE file for details.