Credits

Jorge Arévalo wrote this enhancement.

Introduction

This enhancement to the gdal2tiles.py script includes the following additional features:

Parallel processing, to use all available machine cores when generating tiles. This speeds up tile creation considerably.
Support for both the TMS and XYZ tile cache formats. Use the -o flag to choose; XYZ is the default format.
Support for both PNG and JPEG tile outputs. Use the -f flag to choose; PNG is the default format.

Install

#
#python3 -m ensurepip

# install from local directory
pip install .
# Successfully installed gdal2tilesp.py-3.14.15926

Docker

The project roblabs/gdal-geopdf makes use of this Python script in a Dockerfile.

Command Line

Run gdal2tilesp.py --help to check all the command-line parameters of the script.

Usage: gdal2tilesp.py [options] input_file(s) [output]

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -p PROFILE, --profile=PROFILE
                        Tile cutting profile (mercator,geodetic,raster) -
                        default 'mercator' (Google Maps compatible)
  -r RESAMPLING, --resampling=RESAMPLING
                        Resampling method (average,near,bilinear,cubic,cubicsp
                        line,lanczos,antialias) - default 'average'
  -s SRS, --s_srs=SRS   The spatial reference system used for the source input
                        data
  -z ZOOM, --zoom=ZOOM  Zoom levels to render (format:'2-5' or '10').
  -e, --resume          Resume mode. Generate only missing files.
  -a NODATA, --srcnodata=NODATA
                        NODATA transparency value to assign to the input data
  --processes=PROCESSES
                        Number of concurrent processes (defaults to the number
                        of cores in the system)
  -v, --verbose         Print status messages to stdout

  KML (Google Earth) options:
    Options for generated Google Earth SuperOverlay metadata

    -k, --force-kml     Generate KML for Google Earth - default for 'geodetic'
                        profile and 'raster' in EPSG:4326. For a dataset with
                        different projection use with caution!
    -n, --no-kml        Avoid automatic generation of KML files for EPSG:4326
    -u URL, --url=URL   URL address where the generated tiles are going to be
                        published

  Web viewer options:
    Options for generated HTML viewers a la Google Maps

    -w WEBVIEWER, --webviewer=WEBVIEWER
                        Web viewer to generate
                        (all,google,openlayers,leaflet,index,metadata,none) -
                        default 'all'
    -t TITLE, --title=TITLE
                        Title of the map
    -c COPYRIGHT, --copyright=COPYRIGHT
                        Copyright for the map
    -g GOOGLEKEY, --googlekey=GOOGLEKEY
                        Google Maps API key from
                        http://code.google.com/apis/maps/signup.html
    -y YAHOOKEY, --yahookey=YAHOOKEY
                        Yahoo Application ID from
                        http://developer.yahoo.com/wsregapp/

  Config options:
    Options for config parameters

    -x, --auxfiles      Generate aux.xml files.
    -f OUTPUT_FORMAT, --format=OUTPUT_FORMAT
                        Image format for output tiles. Just WEBP, PNG and JPEG
                        allowed. PNG is selected by default
    -o OUTPUT_CACHE, --output=OUTPUT_CACHE
                        Format for output cache. Values allowed are tms and
                        xyz, being xyz the default value

Notes

Generates tilesjson in the file index.html, which then is consumed by KlokanTech tileview.
- tileview further generates Leaflet, OpenLayers 2 & 3, Google Maps, WebGL, OL3-Cesium, Mapbox JS, and ArcGIS for JavaScript.
Generates Leaflet layer for use with the XYZ default format. Where the tms parameter is set to false

Generates metatdata.json which is interpreted by mb-util for use with mbtiles.

var lyr = L.tileLayer('./{z}/{x}/{y}.png', {tms: false, opacity: 1.0, attribution: ""});

Caveats

The epsg::900913 projection code is not supported, use epsg:3857 to generate a tile set in web mercator projection.

roblabs / gdal2tilesp