dwww Home | Manual pages | Find package

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 follow-
       ing JSON schema

       The following command line parameters can appear in any order

       -detailed
              Most verbose output. Report attribute data types and array  val-
              ues.

       -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  documen-
              tation.  This option may be used several times.

       -stats Read  and display image statistics. Force computation if no sta-
              tistics 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-2021

                                 Dec 27, 2021                  GDALMDIMINFO(1)

Generated by dwww version 1.14 on Fri Jan 24 09:25:56 CET 2025.