NAME

       gdalmdiminfo - Reports structure and content of a multidimensional dataset

SYNOPSIS

          gdalmdiminfo [--help] [--help-general]
                       [-oo <NAME>=<VALUE>]... [-arrayoption <NAME>=<VALUE>]...
                       [-detailed] [-nopretty] [-array <array_name>] [-limit <number>]
                       [-stats] [-if <format>]... <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

       --help Show this help message and exit

       --help-general
              Gives a brief usage message for the generic GDAL commandline options and exit.

       -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.

       -if <format>
              Format/driver name to be attempted to open the input file(s). It is  generally  not
              necessary  to  specify  it,  but it can be used to skip automatic driver detection,
              when it fails to select the  appropriate  driver.   This  option  can  be  repeated
              several  times  to  specify several candidate drivers.  Note that it does not force
              those drivers to open the dataset. In particular, some drivers have requirements on
              file extensions.

              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-2024

                                           Feb 08, 2024                           GDALMDIMINFO(1)