1gdalwarp(1) General Commands Manual gdalwarp(1)
2
6 gdalwarp - gdalwarp simple image reprojection and warping utility
7
9 gdalwarp
10 [-s_srs srs_def] [-t_srs srs_def] [-order n] [-et err_threshold]
11 [-te xmin ymin xmax ymax] [-tr xres yres] [-ts width height]
12 [-wo "NAME=VALUE"] [-ot Byte/Int16/...] [-wt Byte/Int16]
13 [-srcnodata "value [value...]"] [-dstnodata "value [value...]"]
14 [-rn] [-rb] [-rc] [-rcs] [-wm memory_in_mb] [-multi] [-q]
15 [-of format] [-co "NAME=VALUE"]* srcfile dstfile
16
18 The gdalwarp utility is a simple image reprojection and warping
19 utility. The program can reproject to any support projection, and can
20 also apply GCPs stored with the image if the image is 'raw' with
21 control information.
22 -s_srs srs def:
24 source spatial reference set. The coordinate systems that can be
25 passed are anything supported by the
26 OGRSpatialReference.SetFromUserInput() call, which includes EPSG
27 PCS and GCSes (ie. EPSG:4296), PROJ.4 declarations (as above), or
28 the name of a .prf file containing well known text.
29 -t_srs srs_def:
31 target spatial reference set. The coordinate systems that can be
32 passed are anything supported by the
33 OGRSpatialReference.SetFromUserInput() call, which includes EPSG
34 PCS and GCSes (ie. EPSG:4296), PROJ.4 declarations (as above), or
35 the name of a .prf file containing well known text.
36 -order n:
38 order of polynomial used for warping (1 to 3). The default is to
39 select a polynomial order based on the number of GCPs.
40 -tps
42 Enable use of thin plate spline transformer based on available
43 GCPs. Use this instead of the -order switch.
44 -et err_threshold:
46 error threshold for transformation approximation (in pixel units -
47 defaults to 0.125).
48 -te xmin ymin xmax ymax:
50 set georeferenced extents of output file to be created.
51 -tr xres yres:
53 set output file resolution (in target georeferenced units)
54 -ts width height:
56 set output file size in pixels and lines
57 -wo 'NAME=VALUE':
59 Set a warp options. The GDALWarpOptions::papszWarpOptions docs show
60 all options. Multiple -wo options may be listed.
61 -ot type:
63 For the output bands to be of the indicated data type.
64 -wt type:
66 Working pixel data type. The data type of pixels in the source
67 image and destination image buffers.
68 -rn:
70 Use nearest neighbour resampling (default, fastest algorithm, worst
71 interpolation quality).
72 -rb:
74 Use bilinear resampling.
75 -rc:
77 Use cubic resampling.
78 -rcs:
80 Use cubic spline resampling (slowest algorithm).
81 -srcnodata value [value...]:
83 Set nodata masking values for input bands (different values can be
84 supplied for each band). If more than one value is supplied all
85 values should be quoted to keep them together as a single operating
86 system argument. Masked values will not be used in interpolation.
87 -dstnodata value [value...]:
89 Set nodata values for output bands (different values can be
90 supplied for each band). If more than one value is supplied all
91 values should be quoted to keep them together as a single operating
92 system argument. New files will be initialized to this value and if
93 possible the nodata value will be recorded in the output file.
94 -wm memory_in_mb:
96 Set the amount of memory (in megabytes) that the warp API is
97 allowed to use for caching.
98 -multi:
100 Use multithreaded warping implementation. Multiple threads will be
101 used to process chunks of image and perform input/output operation
102 simultaneously.
103 -q:
105 Be quiet.
106 -of format:
108 Select the output format. The default is GeoTIFF (GTiff). Use the
109 short format name.
110 -co 'NAME=VALUE':
112 passes a creation option to the output format driver. Multiple -co
113 options may be listed. See format specific documentation for legal
114 creation options for each format.
115 srcfile:
117 The source file name.
118 dstfile:
120 The destination file name.
121 Mosaicing into an existing output file is supported if the output file
123 already exists.
124
126 For instance, an eight bit spot scene stored in GeoTIFF with control
127 points mapping the corners to lat/long could be warped to a UTM
128 projection with a command like this:
129 gdalwarp -t_srs '+proj=utm +zone=11 +datum=WGS84' raw_spot.tif utm11.tif
131 For instance, the second channel of an ASTER image stored in HDF with
133 control points mapping the corners to lat/long could be warped to a UTM
134 projection with a command like this:
135 gdalwarp HDF4_SDS:ASTER_L1B:"pg-PR1B0000-2002031402_100_001":2 pg-PR1B0000-2002031402_100_001_2.tif
137
139 Frank Warmerdam <warmerdam@pobox.com>, Silke Reimer
140 <silke@intevation.de>
141GDAL 31 Jul 2007 gdalwarp(1)