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

NAME

6       gdal_utilities - GDAL Utilities A collection of GDAL related programs.
7
8       The following utility programs are distributed with GDAL.
9
10       · gdalinfo - Report information about a file.
11       · gdal_translate - Copy a raster file, with control of output format.
12       · gdaladdo - Add overviews to a file.
13       · gdalwarp - Warp an image into a new coordinate system.
14       · gdaltindex - Build a MapServer raster tileindex.
15       · gdalbuildvrt - Build a VRT from a list of datasets.
16       · gdal_contour - Contours from DEM.
17       · gdaldem - Tools to analyze and visualize DEMs.
18       · rgb2pct - Convert a 24bit RGB image to 8bit paletted.
19       · pct2rgb - Convert an 8bit paletted image to 24bit RGB.
20       · gdal_merge - Build a quick mosaic from a set of images.
21       · gdal2tiles - Create a TMS tile structure, KML and simple web viewer.
22       · gdal_rasterize - Rasterize vectors into raster file.
23       · gdaltransform - Transform coordinates.
24       · nearblack - Convert nearly black/white borders to exact value.
25       · gdal_retile - Retiles a set of tiles and/or build tiled pyramid
26         levels.
27       · gdal_grid - Create raster from the scattered data.
28       · gdal_proximity - Compute a raster proximity map.
29       · gdal_polygonize - Generate polygons from raster.
30       · gdal_sieve - Raster Sieve filter.
31       · gdal_fillnodata - Interpolate in nodata regions.
32       · gdallocationinfo - Query raster at a location.
33       · gdalsrsinfo - Report a given SRS in different formats. (GDAL >=
34         1.9.0)
35       · gdalmove - Transform the coordinate system of a file (GDAL >= 1.10)
36       · gdal_edit - Edit in place various information of an existing GDAL
37         dataset (projection, geotransform, nodata, metadata)
38       · gdal_calc - Command line raster calculator with numpy syntax
39       · gdal_pansharpen - Perform a pansharpen operation.
40       · gdal-config - Get options required to build software using GDAL.
41       · gdalmanage - Identify, copy, rename and delete raster.
42       · gdalcompare - Compare two images and report on differences.

Creating New Files

44       Access an existing file to read it is generally quite simple. Just
45       indicate the name of the file or dataset on the command line. However,
46       creating a file is more complicated. It may be necessary to indicate
47       the the format to create, various creation options affecting how it
48       will be created and perhaps a coordinate system to be assigned. Many of
49       these options are handled similarly by different GDAL utilities, and
50       are introduced here.
51       -of format
52           Select the format to create the new file as. The formats are
53           assigned short names such as GTiff (for GeoTIFF) or HFA (for Erdas
54           Imagine). The list of all format codes can be listed with the
55           --formats switch. Only formats list as '(rw)' (read-write) can be
56           written.
57       Starting with GDAL 2.3, if not specified, the format is guessed from
58       the extension (previously was generally GTiff for raster, or ESRI
59       Shapefile for vector).
60       -co NAME=VALUE
61           Many formats have one or more optional creation options that can be
62           used to control particulars about the file created. For instance,
63           the GeoTIFF driver supports creation options to control
64           compression, and whether the file should be tiled.
65       The creation options available vary by format driver, and some simple
66       formats have no creation options at all. A list of options supported
67       for a format can be listed with the '--format <format>' command line
68       option but the web page for the format is the definitive source of
69       information on driver creation options. See format specific
70       documentation for legal creation options for each format
71       -a_srs SRS
72           Several utilities, (gdal_translate and gdalwarp) include the
73           ability to specify coordinate systems with command line options
74           like -a_srs (assign SRS to output), -s_srs (source SRS) and -t_srs
75           (target SRS).
76       These utilities allow the coordinate system (SRS = spatial reference
77       system) to be assigned in a variety of formats.
78       · NAD27/NAD83/WGS84/WGS72: These common geographic (lat/long)
79         coordinate systems can be used directly by these names.
80       · EPSG:n: Coordinate systems (projected or geographic) can be selected
81         based on their EPSG codes, for instance EPSG:27700 is the British
82         National Grid. A list of EPSG coordinate systems can be found in the
83         GDAL data files gcs.csv and pcs.csv.
84       · PROJ.4 Definitions: A PROJ.4 definition string can be used as a
85         coordinate system. For instance '+proj=utm +zone=11 +datum=WGS84'.
86         Take care to keep the proj.4 string together as a single argument to
87         the command (usually by double quoting).
88       · OpenGIS Well Known Text: The Open GIS Consortium has defined a
89         textual format for describing coordinate systems as part of the
90         Simple Features specifications. This format is the internal working
91         format for coordinate systems used in GDAL. The name of a file
92         containing a WKT coordinate system definition may be used a
93         coordinate system argument, or the entire coordinate system itself
94         may be used as a command line option (though escaping all the quotes
95         in WKT is quite challenging).
96       · ESRI Well Known Text: ESRI uses a slight variation on OGC WKT format
97         in their ArcGIS product (ArcGIS .prj files), and these may be used in
98         a similar manner to WKT files, but the filename should be prefixed
99         with ESRI::. For example 'ESRI::NAD 1927 StatePlane Wyoming West FIPS
100         4904.prj'.
101       · Spatial References from URLs: For example
102         http://spatialreference.org/ref/user/north-pacific-albers-conic-
103         equal-area/.
104       · filename: The name of a file containing WKT, PROJ.4 strings, or
105         XML/GML coordinate system definitions can be provided.

General Command Line Switches

107       All GDAL command line utility programs support the following 'general'
108       options.
109       --version
110           Report the version of GDAL and exit.
111       --formats
112           List all raster formats supported by this GDAL build (read-only and
113           read-write) and exit. The format support is indicated as follows:
114           'ro' is read-only driver; 'rw' is read or write (i.e. supports
115           CreateCopy); 'rw+' is read, write and update (i.e. supports
116           Create). A 'v' is appended for formats supporting virtual IO
117           (/vsimem, /vsigzip, /vsizip, etc). A 's' is appended for formats
118           supporting subdatasets. Note: The valid formats for the output of
119           gdalwarp are formats that support the Create() method (marked as
120           rw+), not just the CreateCopy() method.
121       --format format
122           List detailed information about a single format driver. The format
123           should be the short name reported in the --formats list, such as
124           GTiff.
125       --optfile file
126           Read the named file and substitute the contents into the command
127           line options list. Lines beginning with # will be ignored. Multi-
128           word arguments may be kept together with double quotes.
129       --config key value
130           Sets the named configuration keyword to the given value, as opposed
131           to setting them as environment variables. Some common configuration
132           keywords are GDAL_CACHEMAX (memory used internally for caching in
133           megabytes) and GDAL_DATA (path of the GDAL 'data' directory).
134           Individual drivers may be influenced by other configuration
135           options.
136       --debug value
137           Control what debugging messages are emitted. A value of ON will
138           enable all debug messages. A value of OFF will disable all debug
139           messages. Another value will select only debug messages containing
140           that string in the debug prefix code.
141       --help-general
142           Gives a brief usage message for the generic GDAL command line
143           options and exit.
144GDAL                            Tue Mar 3 2020               gdal_utilities(1)
Impressum