FreeBSD Manual Pages
GDAL_RETILE(1) GDAL GDAL_RETILE(1) 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. TIP: Equivalent in new "gdal" command line interface: See gdal raster tile (partially equivalent). --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. If not specified, the format is guessed from the extension. 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 sim- ple formats have no creation options at all. A list of options sup- ported for a format can be listed with the --format command line op- tion but the documentation for the format is the definitive source of information on driver creation options. See Raster drivers for- mat specific documentation for legal creation options for each for- mat. -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 -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.Set- FromUserInput() 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 op- tional 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 in- formation. The file contains 5 columns: tile- name,minx,maxx,miny,maxy -csvDelim <column delimiter> The column delimiter used in the CSV file, default value is a semi- colon ";" -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-directo- ries 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 direc- tory 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. RETURN STATUS CODE The program returns status code 0 in case of success, and non-zero in case of error (non-blocking errors emitted as warnings are considered as a suc- cessful execution). AUTHOR Christian Mueller <christian.mueller@nvoe.at> COPYRIGHT 1998-2026 Jun 05, 2026 GDAL_RETILE(1)
NAME | SYNOPSIS | DESCRIPTION | RETURN STATUS CODE | AUTHOR | COPYRIGHT
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gdal_retile&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>