LinuxCommandLibrary

gdalsummary

Summarize GDAL dataset information

SYNOPSIS

For `gdalinfo`:
gdalinfo [-json] [-mm] [-stats] [-hist] [-nogcp] [-nomd] [-noct] [-nofs] [-ns] [-na] [-checksum] [-ib] [-lic] [-oo 'NAME=VALUE'] [-mdd domain|all] [-limitedopen] [-sd subdataset] [-proj_pci_cite] [-listmdd] [-noobj] <datasetname>

PARAMETERS

-json
    Output dataset information in JSON format.

-mm
    Report approximate minimum and maximum pixel values for each band.

-stats
    Compute and report full band statistics (min, max, mean, std dev).

-hist
    Compute and report histograms for each band.

-nogcp
    Do not report Ground Control Points (GCPs).

-nomd
    Do not report metadata.

-noct
    Do not report color table.

-nofs
    Do not report file list.

-ns
    Do not report subdatasets.

-na
    Do not report attribute table.

-checksum
    Compute and report a checksum for each band.

-ib
    Report metadata for each image band.

-lic
    List all GDAL drivers capable of opening the dataset.

-oo 'NAME=VALUE'
    Set an open option (e.g., specific driver parameters) for the dataset driver.

-mdd domain|all
    Report metadata for a specific domain or all available domains.

-sd subdataset
    Report information only for a specified subdataset by its index.

-limitedopen
    Attempt a faster but potentially less detailed dataset open.

-proj_pci_cite
    Force PCI citation output for projection information.

-listmdd
    List all metadata domains available for the dataset.

-noobj
    Do not output OBJ_DATA metadata domain.


    Path to the GDAL dataset (e.g., GeoTIFF file, ESRI Shapefile) to analyze.

DESCRIPTION

The command gdalsummary is not a recognized standard utility within the official GDAL (Geospatial Data Abstraction Library) software suite. It is highly probable that the user intends to utilize gdalinfo, which serves as the primary command-line tool for retrieving comprehensive metadata, statistics, and structural information about various geospatial raster and vector datasets supported by GDAL.

The gdalinfo command provides a detailed summary of a dataset's properties. This includes its driver format, dimensions, coordinate system (projection), geotransform (pixel-to-georeference transformation), a list of georeferenced control points (GCPs), band properties (such as data type, color interpretation, NoData value, statistics like min/max, mean, standard deviation, and histogram), metadata domains, and subdataset information. It is an indispensable tool for understanding the characteristics of geospatial files prior to processing them with other GDAL utilities. Users frequently employ gdalinfo to inspect file integrity, verify projection definitions, or quickly ascertain data ranges and types.

If 'gdalsummary' refers to a custom script or wrapper, its functionality would most likely mimic or leverage gdalinfo to extract and present a concise overview of geospatial data attributes.

CAVEATS

gdalsummary is not a standard GDAL utility and attempting to execute it directly will likely result in a "command not found" error. Users seeking to summarize geospatial dataset information should instead employ the gdalinfo command, which provides comprehensive metadata and statistical summaries for both raster and vector data. It is conceivable that 'gdalsummary' might refer to a custom shell script, an alias, or a specific internal function within a larger geospatial processing workflow unique to a particular system or project.

<I>WHY 'GDALSUMMARY' MIGHT BE SOUGHT</I>

The name 'gdalsummary' intuitively suggests a utility focused on providing quick, high-level overviews or concise statistics of geospatial data. While gdalinfo offers exhaustive details, its output can sometimes be lengthy and verbose. A hypothetical 'gdalsummary' might aim for a more streamlined report, perhaps focusing solely on key statistics such as extents, resolution, band counts, and basic min/max values, without requiring multiple flags or extensive parsing. Such a tool, if it existed as a separate utility, could be invaluable for rapid data assessment or for integration into automated scripting workflows where only essential summary metrics are required.

HISTORY

Not applicable, as gdalsummary is not a standard, officially documented command within the GDAL project. The GDAL project itself boasts a rich history dating back to 1998, with gdalinfo being one of its foundational utilities for dataset introspection, continuously developed and improved over time.

SEE ALSO

Copied to clipboard