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

NAME

6       gdal_editEdit in place various information of an existing GDAL dataset.
7

SYNOPSIS

9       gdal_edit [--help-general] [-ro] [-a_srs srs_def] [-a_ullr ulx uly lrx lry]
10                 [-tr xres yres] [-unsetgt] [-a_nodata value] [-unsetnodata]
11                 [-unsetstats] [-stats] [-approx_stats]
12                 [-scale value] [-offset value]
13                 [-colorinterp_X red|green|blue|alpha|gray|undefined]*
14                 [-gcp pixel line easting northing [elevation]]*
15                 [-unsetmd] [-oo NAME=VALUE]* [-mo "META-TAG=VALUE"]*  datasetname
16

DESCRIPTION

18       The gdal_edit.py script can be used to edit in place various
19       information of an existing GDAL dataset (projection, geotransform,
20       nodata, metadata).
21
22       It works only with raster formats that support update access to
23       existing datasets.
24
25       CAUTION: depending on the format, older values of the updated
26       information might still be found in the file in a 'ghost' state, even
27       if no longer accessible through the GDAL API. This is for example the
28       case of the GTiff format (this is not a exhaustive list)
29
30       --help-general:
31           Gives a brief usage message for the generic GDAL commandline
32           options and exit.
33
34       -ro:
35           (GDAL >= 1.11) Open the dataset in read-only. Might be useful for
36           drivers refusing to use the dataset in update-mode. In which case,
37           updated information will go into PAM .aux.xml files.
38
39       -a_srs srs_def:
40
41       Defines the target coordinate system. This coordinate system will be
42       written to the dataset. If the empty string or None is specified, then
43       the existing coordinate system will be removed (for TIFF/GeoTIFF, might
44       not be well supported besides that).
45
46       -a_ullr ulx uly lrx lry:
47           Assign/override the georeferenced bounds of the dataset.
48
49       -tr xres yres :
50           Set target resolution. The values must be expressed in
51           georeferenced units. Both must be positive values.
52
53       -unsetgt:
54           Remove the georeference information.
55
56       -unsetstats:
57           (GDAL >= 2.0) Remove band statistics information.
58
59       -stats:
60           (GDAL >= 2.0) Calculate and store band statistics.
61
62       -approx_stats:
63           (GDAL >= 2.0) Calculate and store approximate band statistics.
64
65       -a_nodata value:
66           Assign a specified nodata value to output bands.
67
68       -unsetnodata:
69           (GDAL >= 2.1) Remove existing nodata values.
70
71       -scale value:
72           (GDAL >= 2.2) Assign a specified scale value to output bands. If no
73           scale is needed, it it recommended to set the value to 1. Scale and
74           Offset are generally used together. For example, scale and offset
75           might be used to store elevations in a unsigned 16bit integer file
76           with a precision of 0.1, and starting from -100. True values would
77           be calculated as: true_value = (pixel_value * scale) + offset Note:
78           these values can be applied using -unscale during a gdal_translate
79           run.
80
81       -offset value:
82           (GDAL >= 2.2) Assign a specified offset value to output bands. If
83           no offset is needed, it recommended to set the value to 0. For more
84           see scale.
85
86       -colorinterp_X red|green|blue|alpha|gray|undefined:
87           (GDAL >= 2.3) Change the color interpretation of band X (where X is
88           a valid band number, starting at 1)
89
90       -gcp pixel line easting northing [elevation]:
91           Add the indicated ground control point to the dataset. This option
92           may be provided multiple times to provide a set of GCPs.
93
94       -unsetmd:
95           (GDAL >= 2.0) Remove existing metadata (in the default metadata
96           domain). Can be combined with -mo.
97
98       -mo 'META-TAG=VALUE':
99           Passes a metadata key and value to set on the output dataset if
100           possible. This metadata is added to the existing metadata items,
101           unless -unsetmd is also specified.
102
103       -oo 'NAME=VALUE':
104           (GDAL >= 2.0) Open option (format specific).
105
106       -a_ullr, -tr and -unsetgt options are exclusive.
107
108       -unsetstats and either -stats or -approx_stats options are exclusive.
109

EXAMPLE

111       gdal_edit -mo DATUM=WGS84 -mo PROJ=GEODETIC -a_ullr 7 47 8 46 test.ecw
112

AUTHORS

114       Even Rouault <even dot rouault at mines dash paris dot org>
115
116
117
118GDAL                            Mon Feb 11 2019                   gdal_edit(1)
Impressum