1gdal_translate(1)           General Commands Manual          gdal_translate(1)
2
3
4

NAME

6       gdal_translate - .TH "gdal_translate" 1 "Fri Apr 22 2011" "GDAL"
7

NAME

9       gdal_translate - converts raster data between different formats
10

SYNOPSIS

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

DESCRIPTION

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

EXAMPLE

119       gdal_translate -of GTiff -co "TILED=YES" utm.tif utm_tiled.tif
120

AUTHORS

122       Frank Warmerdam <warmerdam@pobox.com>, Silke Reimer
123       <silke@intevation.de>
124
125
126
127GDAL                            Fri Apr 22 2011              gdal_translate(1)
Impressum