Scroll to navigation

GDALMDIMINFO(1) GDAL GDALMDIMINFO(1)

NAME

gdalmdiminfo - Reports structure and content of a multidimensional dataset

SYNOPSIS

gdalmdiminfo [--help-general] [-oo NAME=VALUE]* [-arrayoption NAME=VALUE]*

[-detailed] [-nopretty] [-array {array_name}] [-limit {number}]
[-stats] <datasetname>


DESCRIPTION

gdalmdiminfo program lists various information about a GDAL supported multidimensional raster dataset as JSON output. It follows the following JSON schema

The following command line parameters can appear in any order

Most verbose output. Report attribute data types and array values.

Outputs on a single line without any indentation.

Name of the array used to restrict the output to the specified array.

Number of values in each dimension that is used to limit the display of array values. By default, unlimited. Only taken into account if used with -detailed.

Dataset open option (format specific). This option may be used several times.

Option passed to GDALGroup::GetMDArrayNames() to filter reported arrays. Such option is format specific. Consult driver documentation. This option may be used several times.

Read and display image statistics. Force computation if no statistics are stored in an image.

New in version 3.2.


C API

This utility is also callable from C with GDALMultiDimInfo().

EXAMPLES

Display general structure1

$ gdalmdiminfo netcdf-4d.nc


{

"type": "group",
"name": "/",
"attributes": {
"Conventions": "CF-1.5"
},
"dimensions": [
{
"name": "levelist",
"full_name": "/levelist",
"size": 2,
"type": "VERTICAL",
"indexing_variable": "/levelist"
},
{
"name": "longitude",
"full_name": "/longitude",
"size": 10,
"type": "HORIZONTAL_X",
"direction": "EAST",
"indexing_variable": "/longitude"
},
{
"name": "latitude",
"full_name": "/latitude",
"size": 10,
"type": "HORIZONTAL_Y",
"direction": "NORTH",
"indexing_variable": "/latitude"
},
{
"name": "time",
"full_name": "/time",
"size": 4,
"type": "TEMPORAL",
"indexing_variable": "/time"
}
],
"arrays": {
"levelist": {
"datatype": "Int32",
"dimensions": [
"/levelist"
],
"attributes": {
"long_name": "pressure_level"
},
"unit": "millibars"
},
"longitude": {
"datatype": "Float32",
"dimensions": [
"/longitude"
],
"attributes": {
"standard_name": "longitude",
"long_name": "longitude",
"axis": "X"
},
"unit": "degrees_east"
},
"latitude": {
"datatype": "Float32",
"dimensions": [
"/latitude"
],
"attributes": {
"standard_name": "latitude",
"long_name": "latitude",
"axis": "Y"
},
"unit": "degrees_north"
},
"time": {
"datatype": "Float64",
"dimensions": [
"/time"
],
"attributes": {
"standard_name": "time",
"calendar": "standard"
},
"unit": "hours since 1900-01-01 00:00:00"
},
"t": {
"datatype": "Int32",
"dimensions": [
"/time",
"/levelist",
"/latitude",
"/longitude"
],
"nodata_value": -32767
}
},
"structural_info": {
"NC_FORMAT": "CLASSIC"
} }


Display detailed information about a given array

$ gdalmdiminfo netcdf-4d.nc -array t -detailed -limit 3


AUTHOR

Even Rouault <even.rouault@spatialys.com>

COPYRIGHT

1998-2022

June 30, 2022