# gdalmdiminfo

New in version 3.1.

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