dwww Home | Manual pages | Find package

GDALINFO(1)                          GDAL                          GDALINFO(1)

NAME
       gdalinfo  -  Lists  various  information  about a GDAL supported raster
       dataset

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

DESCRIPTION
       gdalinfo program lists  various  information  about  a  GDAL  supported
       raster dataset.

       The following command line parameters can appear in any order

       -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  sta-
              tistics are stored in an image.

       -approx_stats
              Read  and display image statistics. Force computation if no sta-
              tistics 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
              List all metadata domains available for the dataset.

       -mdd <domain>|all
              adds metadata using:

              domain Report metadata for the specified domain.

              all Report metadata for all domains.

       -nofl  Only display the first file of the file list.

       -wkt_format WKT1|WKT2|WKT2_2015|WKT2_2018
              WKT  format  used  to  display the SRS.  Currently the supported
              values are:

              WKT1

              WKT2 (latest WKT version, currently WKT2_2018)

              WKT2_2015

              WKT2_2018

              New in version 3.0.0.

       -sd <n>
              If the input dataset contains several subdatasets read and  dis-
              play  a  subdataset  with  specified n number (starting from 1).
              This is an alternative of giving the full subdataset name.

       -proj4 Report a PROJ.4 string corresponding to  the  file's  coordinate
              system.

       -oo <NAME=VALUE>
              Dataset open option (format specific).

       -if <format>
              Format/driver name to be attempted to open the input file(s). It
              is generally not necessary to specify it, but it can be used  to
              skip automatic driver detection, when it fails to select the ap-
              propriate driver.  This option can be repeated several times  to
              specify several candidate drivers.

              New in version 3.2.

       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
       This utility is also callable from C with GDALInfo().

       New in version 2.1.

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

AUTHOR
       Frank Warmerdam <warmerdam@pobox.com>

COPYRIGHT
       1998-2021

                                 Dec 27, 2021                      GDALINFO(1)

Generated by dwww version 1.14 on Fri Jan 24 06:28:50 CET 2025.