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
gdalinfo(1), ogrinfo(1), gdal_translate(1), gdalwarp(1)


