NAME

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

SYNOPSIS

          gdal_retile [--help] [--help-general]
                         [-v] [-co <NAME>=<VALUE>]... [-of <out_format>] [-ps <pixelWidth> <pixelHeight>]
                         [-overlap <val_in_pixel>]
                         [-ot  {Byte/Int8/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] [-resume]
                         -targetDir <TileDirectory> <input_file> <input_file>...

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.  The geotransform matrix of input tiles  must  not
       contain rotation terms.

       Optionally  pyramid levels are generated. All pyramid levels are generated from the input tiles (not from
       previous levels).

       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

       NOTE:
          gdal_retile is a Python utility, and is only available if GDAL Python bindings are available.

       --help Show this help message and exit

       --help-general
              Gives a brief usage message for the generic GDAL commandline options and exit.

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

       -of <format>
              Select the output format. Starting with GDAL 2.3, if not specified, the format is guessed from the
              extension (previously was GTiff). Use the short format name.

       -co <NAME>=<VALUE>
              Many  formats  have  one or more optional creation options that can be used to control particulars
              about the file created. For instance, the GeoTIFF driver  supports  creation  options  to  control
              compression, and whether the file should be tiled.

              The  creation  options  available  vary by format driver, and some simple formats have no creation
              options at all. A list of options supported for a format can be listed with the --formats  command
              line option but the documentation for the format is the definitive source of information on driver
              creation options.  See Raster drivers format specific documentation for legal creation options for
              each format.

       -ot <type>
              Force  the  output  image bands to have a specific data type supported by the driver, which may be
              one of the following: Byte, Int8, UInt16, Int16, UInt32, Int32, UInt64, Int64,  Float32,  Float64,
              CInt16, CInt32, CFloat32 or CFloat64.

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

       -overlap <val_in_pixel>
              Overlap in pixels between consecutive tiles. If not specified, 0 is the default

              New in version 2.2.

       -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.SetFromUserInput()  call, which   includes   EPSG,  PCS,  and
              GCSes (i.e. EPSG:4296), PROJ.4 declarations (as above), or the name of a .prj 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 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 sub-directory called 0, the pyramids
              in  sub-directories  numbered  1,2,....   Within  each  of  these  directories  another  level  of
              sub-directories 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.

       -resume
              Resume mode. Generate only missing files.

AUTHOR

       Christian Mueller <christian.mueller@nvoe.at>

COPYRIGHT

       1998-2025

                                                  Apr 01, 2025                                    GDAL_RETILE(1)