.TH "gdal_retile" 1 "4 Dec 2008" "GDAL" \" -*- nroff -*-
.ad l
.nh
.SH NAME
gdal_retile \- gdal_retile.py 
gdal_retile - gdal_retily.py retiles a set of tiles and/or build tiled pyramid levels
.SH "SYNOPSIS"
.PP
.PP
.PP
.nf


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}]
               -levels numberoflevels
               -targetDir TileDirectory input_files

.fi
.PP
.SH "DESCRIPTION"
.PP
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.
.PP
If your number of input tiles exhausts the command line buffer, use the general --optfile option
.PP
.IP "\fB\fB-targetDir\fP \fIdirectory\fP:\fP" 1c
The Directory where the tile result is created. Pyramids are stored in subdirs numbered from 1. Created tile names have a numbering schema and contain the name of the source tiles(s)  
.IP "\fB\fB-of\fP \fIformat\fP:\fP" 1c
Output format, defaults to GeoTIFF (GTiff).  
.IP "\fB\fB-co\fP \fINAME=VALUE\fP:\fP" 1c
Creation option for output file. Multiple options can be specified.  
.IP "\fB\fB-ot\fP \fIdatatype\fP:\fP" 1c
Force the output image bands to have a specific type. Use type names (ie. Byte, Int16,...)  
.IP "\fB\fB-ps\fP \fIpixelsize_x pixelsize_y\fP:\fP" 1c
Pixel size to be used for the output file. If not specified, 256 x 256 is the default  
.IP "\fB\fB-levels\fP \fInumberOfLevels\fP:\fP" 1c
Number of pyramids levels to build.  
.IP "\fB\fB-v\fP:\fP" 1c
Generate verbose output of tile operations as they are done.  
.IP "\fB\fB-pyramidOnly\fP:\fP" 1c
No retiling, build only the pyramids  
.IP "\fB\fB-r\fP \fIalgorithm\fP:\fP" 1c
Resampling algorithm, default is near  
.IP "\fB\fB-s_srs\fP \fIsrs_def\fP:\fP" 1c
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 propageted to created tiles (if possible) and to the optional shape file(s)  
.IP "\fB\fB-tileIndex\fP \fItileIndexName\fP:\fP" 1c
The name of shape file containing the result tile(s) index  
.IP "\fB\fB-tileIndexField\fP \fItileIndexFieldName\fP:\fP" 1c
The name of the attribute containing the tile name  
.IP "\fB\fB-csv\fP \fIcsvFileName\fP:\fP" 1c
The name of the csv file containing the tile(s) georeferencing information. The file contains 5 columns: tilename,minx,maxx,miny,maxy  
.IP "\fB\fB-csvDelim\fP \fIcolumn delimiter\fP:\fP" 1c
The column delimter used in the csv file, default value is a semicolon ';'  
.PP
.PP
NOTE: gdal_merge.py is a Python script, and will only work if GDAL was built with Python support.
.SH "AUTHORS"
.PP
Christian Mueller <christian.mueller@nvoe.at>