1GDAL_RETILE(1) GDAL GDAL_RETILE(1)
2
3
4
6 gdal_retile - Retiles a set of tiles and/or build tiled pyramid levels.
7
9 gdal_retile.py [-v] [-co NAME=VALUE]* [-of out_format] [-ps pixelWidth pixelHeight]
10 [-overlap val_in_pixel]
11 [-ot {Byte/Int16/UInt16/UInt32/Int32/Float32/Float64/
12 CInt16/CInt32/CFloat32/CFloat64}]'
13 [ -tileIndex tileIndexName [-tileIndexField tileIndexFieldName]]
14 [ -csv fileName [-csvDelim delimiter]]
15 [-s_srs srs_def] [-pyramidOnly]
16 [-r {near/bilinear/cubic/cubicspline/lanczos}]
17 -levels numberoflevels
18 [-useDirForEachRow] [-resume]
19 -targetDir TileDirectory input_files
20
22 This utility will retile a set of input tile(s). All the input tile(s)
23 must be georeferenced in the same coordinate system and have a matching
24 number of bands. Optionally pyramid levels are generated. It is pos‐
25 sible to generate shape file(s) for the tiled output.
26
27 If your number of input tiles exhausts the command line buffer, use the
28 general --optfile option
29
30 -targetDir <directory>
31 The directory where the tile result is created. Pyramids are
32 stored in sub-directories numbered from 1. Created tile
33 names have a numbering schema and contain the name of the source
34 tiles(s)
35
36 -of <format>
37 Select the output format. Starting with GDAL 2.3, if not speci‐
38 fied, the format is guessed from the extension (previously was
39 GTiff). Use the short format name.
40
41 -co <NAME=VALUE>
42 Many formats have one or more optional creation options that can
43 be used to control particulars about the file created. For
44 instance, the GeoTIFF driver supports creation options to con‐
45 trol compression, and whether the file should be tiled.
46
47 The creation options available vary by format driver, and some
48 simple formats have no creation options at all. A list of
49 options supported for a format can be listed with the --formats
50 command line option but the documentation for the format is the
51 definitive source of information on driver creation options.
52 See raster_drivers format specific documentation for legal cre‐
53 ation options for each format.
54
55 -ot <type>
56 Force the output image bands to have a specific type. Use type
57 names (i.e. Byte, Int16,...)
58
59 -ps <pixelsize_x> <pixelsize_y>
60 Pixel size to be used for the output file. If not specified,
61 256 x 256 is the default
62
63 -overlap< <val_in_pixel>
64 Overlap in pixels between consecutive tiles. If not specified, 0
65 is the default
66
67 New in version 2.2.
68
69
70 -levels <numberOfLevels>
71 Number of pyramids levels to build.
72
73 -v Generate verbose output of tile operations as they are done.
74
75 -pyramidOnly
76 No retiling, build only the pyramids
77
78 -r <algorithm>
79 Resampling algorithm, default is near
80
81 -s_srs <srs_def>
82 Source spatial reference to use. The coordinate systems that
83 can be passed are anything supported by the OGRSpatialRefer‐
84 ence.SetFromUserInput() call, which includes EPSG, PCS, and
85 GCSes (i.e. EPSG:4296), PROJ.4 declarations (as above), or the
86 name of a .prj file containing well known text. If no srs_def
87 is given, the srs_def of the source tiles is used (if there
88 is any). The srs_def will be propagated to created tiles (if
89 possible) and to the optional shape file(s)
90
91 -tileIndex <tileIndexName>
92 The name of shape file containing the result tile(s) index
93
94 -tileIndexField <tileIndexFieldName>
95 The name of the attribute containing the tile name
96
97 -csv <csvFileName>
98 The name of the csv file containing the tile(s) georeferencing
99 information. The file contains 5 columns: tile‐
100 name,minx,maxx,miny,maxy
101
102 -csvDelim <column delimiter>
103 The column delimiter used in the CSV file, default value is a
104 semicolon ";"
105
106 -useDirForEachRow
107 Normally the tiles of the base image are stored as described in
108 -targetDir. For large images, some file systems have perfor‐
109 mance problems if the number of files in a directory is to big,
110 causing gdal_retile not to finish in reasonable time. Using
111 this parameter creates a different output structure. The tiles
112 of the base image are stored in a sub-directory called 0, the
113 pyramids in sub-directories numbered 1,2,.... Within each of
114 these directories another level of sub-directories is created,
115 numbered from 0...n, depending of how many tile rows are needed
116 for each level. Finally, a directory contains only the tiles for
117 one row for a specific level. For large images a performance
118 improvement of a factor N could be achieved.
119
120 -resume
121 Resume mode. Generate only missing files.
122
123 NOTE:
124 gdal_retile.py is a Python script, and will only work if GDAL was
125 built with Python support.
126
128 Christian Mueller <christian.mueller@nvoe.at>
129
131 1998-2021
132
133
134
135
136 Jan 05, 2021 GDAL_RETILE(1)