1GDALINFO(1)                          GDAL                          GDALINFO(1)
2
3
4

NAME

6       gdalinfo  -  Lists  various  information  about a GDAL supported raster
7       dataset
8

SYNOPSIS

10          gdalinfo [--help-general] [-json] [-mm] [-stats | -approx_stats] [-hist] [-nogcp] [-nomd]
11                   [-norat] [-noct] [-nofl] [-checksum] [-proj4]
12                   [-listmdd] [-mdd domain|`all`]* [-wkt_format WKT1|WKT2|...]
13                   [-sd subdataset] [-oo NAME=VALUE]* [-if format]* datasetname
14

DESCRIPTION

16       gdalinfo program lists  various  information  about  a  GDAL  supported
17       raster dataset.
18
19       The following command line parameters can appear in any order
20
21       -json  Display the output in json format. Since GDAL 3.6, this includes
22              key-value pairs useful for building a STAC item , including sta‐
23              tistics  and histograms if -stats or -hist flags are passed, re‐
24              spectively.
25
26       -mm    Force computation of the actual min/max values for each band  in
27              the dataset.
28
29       -stats Read  and display image statistics. Force computation if no sta‐
30              tistics are stored in an image.
31
32       -approx_stats
33              Read and display image statistics. Force computation if no  sta‐
34              tistics  are  stored  in an image. However, they may be computed
35              based on overviews or a subset of all tiles. Useful if  you  are
36              in a hurry and don't want precise stats.
37
38       -hist  Report histogram information for all bands.
39
40       -nogcp Suppress  ground  control points list printing. It may be useful
41              for datasets with huge amount of GCPs, such as L1B AVHRR or HDF4
42              MODIS which contain thousands of them.
43
44       -nomd  Suppress  metadata  printing. Some datasets may contain a lot of
45              metadata strings.
46
47       -norat Suppress printing of raster attribute table.
48
49       -noct  Suppress printing of color table.
50
51       -checksum
52              Force computation of the checksum for each band in the dataset.
53
54       -listmdd
55              List all metadata domains available for the dataset.
56
57       -mdd <domain>|all
58              adds metadata using:
59
60              domain Report metadata for the specified domain.
61
62              all Report metadata for all domains.
63
64       -nofl  Only display the first file of the file list.
65
66       -wkt_format WKT1|WKT2|WKT2_2015|WKT2_2018
67              WKT format used to display the  SRS.   Currently  the  supported
68              values are:
69
70              WKT1
71
72              WKT2 (latest WKT version, currently WKT2_2018)
73
74              WKT2_2015
75
76              WKT2_2018
77
78              New in version 3.0.0.
79
80
81       -sd <n>
82              If  the input dataset contains several subdatasets read and dis‐
83              play a subdataset with specified n  number  (starting  from  1).
84              This is an alternative of giving the full subdataset name.
85
86       -proj4 Report  a  PROJ.4  string corresponding to the file's coordinate
87              system.
88
89       -oo <NAME=VALUE>
90              Dataset open option (format specific).
91
92       -if <format>
93              Format/driver name to be attempted to open the input file(s). It
94              is  generally not necessary to specify it, but it can be used to
95              skip automatic driver detection, when it fails to select the ap‐
96              propriate  driver.  This option can be repeated several times to
97              specify several candidate drivers.
98
99              New in version 3.2.
100
101
102       The gdalinfo will report all of the following (if known):
103
104       • The format driver used to access the file.
105
106       • Raster size (in pixels and lines).
107
108       • The coordinate system for the file (in OGC WKT).
109
110       • The geotransform associated with the  file  (rotational  coefficients
111         are currently not reported).
112
113       • Corner  coordinates  in georeferenced, and if possible lat/long based
114         on the full geotransform (but not GCPs).
115
116       • Ground control points.
117
118       • File wide (including subdatasets) metadata.
119
120       • Band data types.
121
122       • Band color interpretations.
123
124       • Band block size.
125
126       • Band descriptions.
127
128       • Band min/max values (internally known and possibly computed).
129
130       • Band checksum (if computation asked).
131
132       • Band NODATA value.
133
134       • Band overview resolutions available.
135
136       • Band unit type (i.e.. "meters" or "feet" for elevation bands).
137
138       • Band pseudo-color tables.
139

C API

141       This utility is also callable from C with GDALInfo().
142
143       New in version 2.1.
144
145

EXAMPLE

147          gdalinfo ~/openev/utm.tif
148          Driver: GTiff/GeoTIFF
149          Size is 512, 512
150          Coordinate System is:
151          PROJCS["NAD27 / UTM zone 11N",
152              GEOGCS["NAD27",
153                  DATUM["North_American_Datum_1927",
154                      SPHEROID["Clarke 1866",6378206.4,294.978698213901]],
155                  PRIMEM["Greenwich",0],
156                  UNIT["degree",0.0174532925199433]],
157              PROJECTION["Transverse_Mercator"],
158              PARAMETER["latitude_of_origin",0],
159              PARAMETER["central_meridian",-117],
160              PARAMETER["scale_factor",0.9996],
161              PARAMETER["false_easting",500000],
162              PARAMETER["false_northing",0],
163              UNIT["metre",1]]
164          Origin = (440720.000000,3751320.000000)
165          Pixel Size = (60.000000,-60.000000)
166          Corner Coordinates:
167          Upper Left  (  440720.000, 3751320.000) (117d38'28.21"W, 33d54'8.47"N)
168          Lower Left  (  440720.000, 3720600.000) (117d38'20.79"W, 33d37'31.04"N)
169          Upper Right (  471440.000, 3751320.000) (117d18'32.07"W, 33d54'13.08"N)
170          Lower Right (  471440.000, 3720600.000) (117d18'28.50"W, 33d37'35.61"N)
171          Center      (  456080.000, 3735960.000) (117d28'27.39"W, 33d45'52.46"N)
172          Band 1 Block=512x16 Type=Byte, ColorInterp=Gray
173

AUTHOR

175       Frank Warmerdam <warmerdam@pobox.com>
176

178       1998-2023
179
180
181
182
183                                 Apr 17, 2023                      GDALINFO(1)
Impressum