Image Overviews, Tiling and Pyramids - Open Source Geospatial Tools: Applications in Earth Observation - page 91

-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

× 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. e
-s_srs srs_def
Source spatial reference to use. The coordinate systems that can be passed are
anything supported by the OGRSpatialReference.SetFromUserInput() 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 Shapefile(s).
-tileIndex tileIndexName
The name of Shapefile 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 delimiter 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 too 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 tiles for one row for a specific level. For
large images a performance improvement of a factor N could be achieved.