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

                                           Jun 30, 2022                           GDALMDIMINFO(1)