.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GDAL-MDIM-INFO" "1" "Nov 07, 2025" "" "GDAL"
.SH NAME
gdal-mdim-info \- Get information on a multidimensional dataset
.sp
Added in version 3.11.

.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal mdim info [OPTIONS] <INPUT>

Return information on a multidimensional dataset.

Positional arguments:
  \-i, \-\-dataset, \-\-input <INPUT>       Input multidimensional raster dataset [required]

Common Options:
  \-h, \-\-help                           Display help message and exit
  \-\-json\-usage                         Display usage as JSON document and exit
  \-\-config <KEY>=<VALUE>               Configuration option [may be repeated]

Options:
  \-\-detailed                           Most verbose output. Report attribute data types and array values.
  \-\-array <ARRAY>                      Name of the array, used to restrict the output to the specified array.
  \-\-limit <LIMIT>                      Number of values in each dimension that is used to limit the display of array values.
  \-\-array\-option <KEY>=<VALUE>         Option passed to GDALGroup::GetMDArrayNames() to filter reported arrays. [may be repeated]
  \-\-stats                              Read and display image statistics.

Advanced Options:
  \-\-oo, \-\-open\-option <KEY>=<VALUE>    Open options [may be repeated]
  \-\-if, \-\-input\-format <INPUT\-FORMAT>  Input formats [may be repeated]
.EE
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
\fBgdal mdim info\fP lists various information about a GDAL supported
multidimensional dataset.
.sp
The following items will be reported (when known) as JSON:
.INDENT 0.0
.IP \(bu 2
The format driver used to access the file.
.IP \(bu 2
Hierarchy of groups
.IP \(bu 2
Group attributes
.IP \(bu 2
.INDENT 2.0
.TP
.B Arrays:
.INDENT 7.0
.IP \(bu 2
Name
.IP \(bu 2
Dimension name, sizes, indexing variable
.IP \(bu 2
Data type
.IP \(bu 2
Attributes
.IP \(bu 2
SRS
.IP \(bu 2
Nodata value
.IP \(bu 2
Units
.IP \(bu 2
Statistics (if requested)
.UNINDENT
.UNINDENT
.UNINDENT
.sp
The following options are available:
.SS Standard options
.INDENT 0.0
.TP
.B \-\-detailed
Most verbose output. Report attribute data types and array values.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-array <array_name>
Name of the array used to restrict the output to the specified array.
.sp
\fBNOTE:\fP
.INDENT 7.0
.INDENT 3.5
Bash completion for \fI\%\-\-array\fP is possible if the dataset name
is specified before.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-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.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-array\-option <NAME>=<VALUE>
Option passed to \fI\%GDALGroup::GetMDArrayNames()\fP to filter reported
arrays. Such option is format specific. Consult driver documentation.
This option may be used several times.
.sp
\fBNOTE:\fP
.INDENT 7.0
.INDENT 3.5
Bash completion for \fI\%\-\-array\-option\fP is possible if the dataset name
is specified before.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-stats
Read and display array statistics. Force computation if no
statistics are stored in an array.
.UNINDENT
.SS Advanced options
.INDENT 0.0
.TP
.B \-\-oo <NAME>=<VALUE>
Dataset open option (format specific).
.sp
May be repeated.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-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.
.sp
May be repeated.
.UNINDENT
.SH EXAMPLES
.SS Example 1: Getting information on the file \fBnetcdf\-4d.nc\fP as JSON output
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal mdim info netcdf\-4d.nc
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqtype\(dq: \(dqgroup\(dq,
  \(dqname\(dq: \(dq/\(dq,
  \(dqattributes\(dq: {
    \(dqConventions\(dq: \(dqCF\-1.5\(dq
  },
  \(dqdimensions\(dq: [
    {
      \(dqname\(dq: \(dqlevelist\(dq,
      \(dqfull_name\(dq: \(dq/levelist\(dq,
      \(dqsize\(dq: 2,
      \(dqtype\(dq: \(dqVERTICAL\(dq,
      \(dqindexing_variable\(dq: \(dq/levelist\(dq
    },
    {
      \(dqname\(dq: \(dqlongitude\(dq,
      \(dqfull_name\(dq: \(dq/longitude\(dq,
      \(dqsize\(dq: 10,
      \(dqtype\(dq: \(dqHORIZONTAL_X\(dq,
      \(dqdirection\(dq: \(dqEAST\(dq,
      \(dqindexing_variable\(dq: \(dq/longitude\(dq
    },
    {
      \(dqname\(dq: \(dqlatitude\(dq,
      \(dqfull_name\(dq: \(dq/latitude\(dq,
      \(dqsize\(dq: 10,
      \(dqtype\(dq: \(dqHORIZONTAL_Y\(dq,
      \(dqdirection\(dq: \(dqNORTH\(dq,
      \(dqindexing_variable\(dq: \(dq/latitude\(dq
    },
    {
      \(dqname\(dq: \(dqtime\(dq,
      \(dqfull_name\(dq: \(dq/time\(dq,
        \(dqsize\(dq: 4,
      \(dqtype\(dq: \(dqTEMPORAL\(dq,
      \(dqindexing_variable\(dq: \(dq/time\(dq
      }
  ],
  \(dqarrays\(dq: {
    \(dqlevelist\(dq: {
      \(dqdatatype\(dq: \(dqInt32\(dq,
      \(dqdimensions\(dq: [
          \(dq/levelist\(dq
        ],
      \(dqattributes\(dq: {
        \(dqlong_name\(dq: \(dqpressure_level\(dq
      },
      \(dqunit\(dq: \(dqmillibars\(dq
    },
    \(dqlongitude\(dq: {
      \(dqdatatype\(dq: \(dqFloat32\(dq,
      \(dqdimensions\(dq: [
        \(dq/longitude\(dq
      ],
      \(dqattributes\(dq: {
        \(dqstandard_name\(dq: \(dqlongitude\(dq,
        \(dqlong_name\(dq: \(dqlongitude\(dq,
        \(dqaxis\(dq: \(dqX\(dq
      },
      \(dqunit\(dq: \(dqdegrees_east\(dq
    },
    \(dqlatitude\(dq: {
      \(dqdatatype\(dq: \(dqFloat32\(dq,
      \(dqdimensions\(dq: [
        \(dq/latitude\(dq
      ],
      \(dqattributes\(dq: {
        \(dqstandard_name\(dq: \(dqlatitude\(dq,
        \(dqlong_name\(dq: \(dqlatitude\(dq,
        \(dqaxis\(dq: \(dqY\(dq
      },
      \(dqunit\(dq: \(dqdegrees_north\(dq
    },
    \(dqtime\(dq: {
      \(dqdatatype\(dq: \(dqFloat64\(dq,
      \(dqdimensions\(dq: [
        \(dq/time\(dq
      ],
      \(dqattributes\(dq: {
        \(dqstandard_name\(dq: \(dqtime\(dq,
        \(dqcalendar\(dq: \(dqstandard\(dq
      },
      \(dqunit\(dq: \(dqhours since 1900\-01\-01 00:00:00\(dq
    },
    \(dqt\(dq: {
      \(dqdatatype\(dq: \(dqInt32\(dq,
      \(dqdimensions\(dq: [
        \(dq/time\(dq,
        \(dq/levelist\(dq,
        \(dq/latitude\(dq,
        \(dq/longitude\(dq
      ],
      \(dqnodata_value\(dq: \-32767
    }
  },
  \(dqstructural_info\(dq: {
    \(dqNC_FORMAT\(dq: \(dqCLASSIC\(dq
  }
}
.EE
.UNINDENT
.UNINDENT
.SH AUTHOR
Even Rouault <even.rouault@spatialys.com>
.SH COPYRIGHT
1998-2025
.\" Generated by docutils manpage writer.
.