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
- -detailed
- Most verbose output. Report attribute data types and array values.
- -nopretty
- Outputs on a single line without any indentation.
- -array {array_name}
- Name of the array used to restrict the output to the specified array.
- -limit {number}
- 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.
- -oo <NAME=VALUE>
- Dataset open option (format specific). This option may be used several times.
- -arrayoption <NAME=VALUE>
- Option passed to GDALGroup::GetMDArrayNames() to filter reported arrays. Such option is format specific. Consult driver documentation. This option may be used several times.
- -stats
- 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 |