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

C API

138       This utility is also callable from C with GDALInfo().
139
140       New in version 2.1.
141
142

EXAMPLE

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

AUTHOR

172       Frank Warmerdam <warmerdam@pobox.com>
173
175       1998-2022
176
177
178
179
180                                 May 04, 2022                      GDALINFO(1)
Impressum