Man pages sections > man1 > gdalinfo

gdalinfo - Lists information about a raster dataset.

gdalinfo(1) General Commands Manual gdalinfo(1)

NAME

gdalinfo - Lists information about a raster dataset.

SYNOPSIS

gdalinfo [--help-general] [-json] [-mm] [-stats] [-hist] [-nogcp] [-nomd]
         [-norat] [-noct] [-nofl] [-checksum] [-proj4]
         [-listmdd] [-mdd domain|`all`]*
         [-sd subdataset] [-oo NAME=VALUE]* datasetname

DESCRIPTION

The gdalinfo program lists various information about a GDAL supported raster dataset.
-json
Display the output in json format.
-mm
Force computation of the actual min/max values for each band in the dataset.
-stats
Read and display image statistics. Force computation if no statistics are stored in an image.
-approx_stats
Read and display image statistics. Force computation if no statistics are stored in an image. However, they may be computed based on overviews or a subset of all tiles. Useful if you are in a hurry and don't want precise stats.
-hist
Report histogram information for all bands.
-nogcp
Suppress ground control points list printing. It may be useful for datasets with huge amount of GCPs, such as L1B AVHRR or HDF4 MODIS which contain thousands of them.
-nomd
Suppress metadata printing. Some datasets may contain a lot of metadata strings.
-norat
Suppress printing of raster attribute table.
-noct
Suppress printing of color table.
-checksum
Force computation of the checksum for each band in the dataset.
-listmdd
(GDAL >= 1.11) List all metadata domains available for the dataset.
-mdd domain
Report metadata for the specified domain. Starting with GDAL 1.11, 'all' can be used to report metadata in all domains
-nofl
(GDAL >= 1.9.0) Only display the first file of the file list.
-sd subdataset
(GDAL >= 1.9.0) If the input dataset contains several subdatasets read and display a subdataset with specified number (starting from 1). This is an alternative of giving the full subdataset name.
-proj4
(GDAL >= 1.9.0) Report a PROJ.4 string corresponding to the file's coordinate system.
-oo NAME=VALUE:
(starting with GDAL 2.0) Dataset open option (format specific)
The gdalinfo will report all of the following (if known):
The format driver used to access the file.
Raster size (in pixels and lines).
The coordinate system for the file (in OGC WKT).
The geotransform associated with the file (rotational coefficients are currently not reported).
Corner coordinates in georeferenced, and if possible lat/long based on the full geotransform (but not GCPs).
Ground control points.
File wide (including subdatasets) metadata.
Band data types.
Band color interpretations.
Band block size.
Band descriptions.
Band min/max values (internally known and possibly computed).
Band checksum (if computation asked).
Band NODATA value.
Band overview resolutions available.
Band unit type (i.e.. 'meters' or 'feet' for elevation bands).
Band pseudo-color tables.

C API

Starting with GDAL 2.1, this utility is also callable from C with GDALInfo().

EXAMPLE

gdalinfo ~/openev/utm.tif
Driver: GTiff/GeoTIFF
Size is 512, 512
Coordinate System is:
PROJCS["NAD27 / UTM zone 11N",
    GEOGCS["NAD27",
        DATUM["North_American_Datum_1927",
            SPHEROID["Clarke 1866",6378206.4,294.978698213901]],
        PRIMEM["Greenwich",0],
        UNIT["degree",0.0174532925199433]],
    PROJECTION["Transverse_Mercator"],
    PARAMETER["latitude_of_origin",0],
    PARAMETER["central_meridian",-117],
    PARAMETER["scale_factor",0.9996],
    PARAMETER["false_easting",500000],
    PARAMETER["false_northing",0],
    UNIT["metre",1]]
Origin = (440720.000000,3751320.000000)
Pixel Size = (60.000000,-60.000000)
Corner Coordinates:
Upper Left  (  440720.000, 3751320.000) (117d38'28.21"W, 33d54'8.47"N)
Lower Left  (  440720.000, 3720600.000) (117d38'20.79"W, 33d37'31.04"N)
Upper Right (  471440.000, 3751320.000) (117d18'32.07"W, 33d54'13.08"N)
Lower Right (  471440.000, 3720600.000) (117d18'28.50"W, 33d37'35.61"N)
Center      (  456080.000, 3735960.000) (117d28'27.39"W, 33d45'52.46"N)
Band 1 Block=512x16 Type=Byte, ColorInterp=Gray

AUTHORS

Frank Warmerdam warmerdam@pobox.com, Silke Reimer silke@intevation.de
Sun Oct 29 2017 GDAL