1gdal_translate(1) General Commands Manual gdal_translate(1)
2
3
4
6 gdal_translate - .TH "gdal_translate" 1 "Fri Apr 22 2011" "GDAL"
7
9 gdal_translate - converts raster data between different formats
10
12 gdal_translate [--help-general]
13 [-ot {Byte/Int16/UInt16/UInt32/Int32/Float32/Float64/
14 CInt16/CInt32/CFloat32/CFloat64}] [-strict]
15 [-of format] [-b band] [-expand {gray|rgb|rgba}]
16 [-outsize xsize[%] ysize[%]]
17 [-unscale] [-scale [src_min src_max [dst_min dst_max]]]
18 [-srcwin xoff yoff xsize ysize] [-projwin ulx uly lrx lry]
19 [-a_srs srs_def] [-a_ullr ulx uly lrx lry] [-a_nodata value]
20 [-gcp pixel line easting northing [elevation]]*
21 [-mo "META-TAG=VALUE"]* [-q] [-sds]
22 [-co "NAME=VALUE"]*
23 src_dataset dst_dataset
24
26 The gdal_translate utility can be used to convert raster data between
27 different formats, potentially performing some operations like
28 subsettings, resampling, and rescaling pixels in the process.
29
30 -ot: type
31 For the output bands to be of the indicated data type.
32
33 -strict:
34 Do'nt be forgiving of mismatches and lost data when translating to
35 the output format.
36
37 -of format:
38 Select the output format. The default is GeoTIFF (GTiff). Use the
39 short format name.
40
41 -b band:
42 Select an input band band for output. Bands are numbered from 1
43 Multiple -b switches may be used to select a set of input bands to
44 write to the output file, or to reorder bands.
45
46 -expand gray|rgb|rgba:
47 (From GDAL 1.6.0) To expose a dataset with 1 band with a color
48 table as a dataset with 3 (RGB) or 4 (RGBA) bands. Usefull for
49 output drivers such as JPEG, JPEG2000, MrSID, ECW that don't
50 support color indexed datasets. The 'gray' value (from GDAL 1.7.0)
51 enables to expand a dataset with a color table that only contains
52 gray levels to a gray indexed dataset.
53
54 -outsize xsize[%] ysize[%]:
55 Set the size of the output file. Outsize is in pixels and lines
56 unless '' is attached in which case it is as a fraction of the
57 input image size.
58
59 -scale [src_min src_max [dst_min dst_max]]:
60 Rescale the input pixels values from the range src_min to src_max
61 to the range dst_min to dst_max. If omitted the output range is 0
62 to 255. If omitted the input range is automatically computed from
63 the source data.
64
65 -unscale:
66 Apply the scale/offset metadata for the bands to convert scaled
67 values to unscaled values. It is also often necessary to reset the
68 output datatype with the -ot switch.
69
70 -srcwin xoff yoff xsize ysize:
71 Selects a subwindow from the source image for copying based on
72 pixel/line location.
73
74 -projwin ulx uly lrx lry:
75 Selects a subwindow from the source image for copying (like
76 -srcwin) but with the corners given in georeferenced coordinates.
77
78 -a_srs srs_def:
79 Override the projection for the output file. The srs_def may be any
80 of the usual GDAL/OGR forms, complete WKT, PROJ.4, EPSG:n or a file
81 containing the WKT.
82
83 -a_ullr ulx uly lrx lry:
84 Assign/override the georeferenced bounds of the output file. This
85 assigns georeferenced bounds to the output file, ignoring what
86 would have been derived from the source file.
87
88 -a_nodata value:
89 Assign a specified nodata value to output bands.
90
91 -mo 'META-TAG=VALUE':
92 Passes a metadata key and value to set on the output dataset if
93 possible.
94
95 -co 'NAME=VALUE':
96 Passes a creation option to the output format driver. Multiple -co
97 options may be listed. See format specific documentation for legal
98 creation options for each format.
99
100 -gcp pixel line easting northing elevation:
101 Add the indicated ground control point to the output dataset. This
102 option may be provided multiple times to provide a set of GCPs.
103
104 -q:
105 Suppress progress monitor and other non-error output.
106
107 -sds:
108 Copy all subdatasets of this file to individual output files. Use
109 with formats like HDF or OGDI that have subdatasets.
110
111 src_dataset:
112 The source dataset name. It can be either file name, URL of data
113 source or subdataset name for multi-dataset files.
114
115 dst_dataset:
116 The destination file name.
117
119 gdal_translate -of GTiff -co "TILED=YES" utm.tif utm_tiled.tif
120
122 Frank Warmerdam <warmerdam@pobox.com>, Silke Reimer
123 <silke@intevation.de>
124
125
126
127GDAL Fri Apr 22 2011 gdal_translate(1)