NAME

       gdal_retile - gdal_retile.py gdal_retile.py retiles a set of tiles and/or build tiled
       pyramid levels

SYNOPSIS

       gdal_retile.py [-v] [-co NAME=VALUE]* [-of out_format] [-ps pixelWidth pixelHeight]
                      [-ot  {Byte/Int16/UInt16/UInt32/Int32/Float32/Float64/
                             CInt16/CInt32/CFloat32/CFloat64}]'
                      [ -tileIndex tileIndexName [-tileIndexField tileIndexFieldName]]
                      [ -csv fileName [-csvDelim delimiter]]
                      [-s_srs srs_def]  [-pyramidOnly]
                      [-r {near/bilinear/cubic/cubicspline/lanczos}]
                      -levels numberoflevels
                      [-useDirForEachRow]
                      -targetDir TileDirectory input_files.fi

DESCRIPTION

       This utility will retile a set of input tile(s). All the input tile(s) must be
       georeferenced in the same coordinate system and have a matching number of bands.
       Optionally pyramid levels are generated. It is possible to generate shape file(s) for the
       tiled output.

       If your number of input tiles exhausts the command line buffer, use the general --optfile
       option

       -targetDir directory:
           The directory where the tile result is created. Pyramids are stored in subdirectories
           numbered from 1. Created tile names have a numbering schema and contain the name of
           the source tiles(s)

       -of format:
           Output format, defaults to GeoTIFF (GTiff).

       -co NAME=VALUE:
           Creation option for output file. Multiple options can be specified.

       -ot datatype:
           Force the output image bands to have a specific type. Use type names (ie. Byte,
           Int16,...)

       -ps pixelsize_x pixelsize_y:
           Pixel size to be used for the output file. If not specified, 256 x 256 is the default

       -levels numberOfLevels:
           Number of pyramids levels to build.

       -v:
           Generate verbose output of tile operations as they are done.

       -pyramidOnly:
           No retiling, build only the pyramids

       -r algorithm:
           Resampling algorithm, default is near

       -s_srs srs_def:
           Source spatial reference to use. The coordinate systems that can be passed are
           anything supported by the OGRSpatialReference.SetFro‐mUserInput() call, which includes
           EPSG PCS and GCSes (ie.EPSG:4296), PROJ.4 declarations (as above), or the name of a
           .prf file containing well known text. If no srs_def is given, the srs_def of the
           source tiles is used (if there is any). The srs_def will be propagated to created
           tiles (if possible) and to the optional shape file(s)

       -tileIndex tileIndexName:
           The name of shape file containing the result tile(s) index

       -tileIndexField tileIndexFieldName:
           The name of the attribute containing the tile name

       -csv csvFileName:
           The name of the csv file containing the tile(s) georeferencing information. The file
           contains 5 columns: tilename,minx,maxx,miny,maxy

       -csvDelim column delimiter:
           The column delimter used in the csv file, default value is a semicolon ';'

       -useDirForEachRow:
           Normally the tiles of the base image are stored as described in -targetDir. For large
           images, some file systems have performance problems if the number of files in a
           directory is to big, causing gdal_retile not to finish in reasonable time. Using this
           parameter creates a different output structure. The tiles of the base image are stored
           in a subdirectory called 0, the pyramids in subdirectories numbered 1,2,.... Within
           each of these directories another level of subdirectories is created, numbered from
           0...n, depending of how many tile rows are needed for each level. Finally, a directory
           contains only the the tiles for one row for a specific level. For large images a
           performance improvement of a factor N could be achieved.

       NOTE: gdal_retile.py is a Python script, and will only work if GDAL was built with Python
       support.

AUTHORS

       Christian Mueller christian.mueller@nvoe.at