1GDALMDIMINFO(1)                      GDAL                      GDALMDIMINFO(1)
2
3
4

NAME

6       gdalmdiminfo  -  Reports  structure  and  content of a multidimensional
7       dataset
8

SYNOPSIS

10          gdalmdiminfo [--help-general] [-oo NAME=VALUE]* [-arrayoption NAME=VALUE]*
11                       [-detailed] [-nopretty] [-array {array_name}] [-limit {number}]
12                       [-stats] [-if format]* <datasetname>
13

DESCRIPTION

15       gdalmdiminfo program lists various information about a  GDAL  supported
16       multidimensional  raster dataset as JSON output. It follows the follow‐
17       ing JSON schema
18
19       The following command line parameters can appear in any order
20
21       -detailed
22              Most verbose output. Report attribute data types and array  val‐
23              ues.
24
25       -nopretty
26              Outputs on a single line without any indentation.
27
28       -array {array_name}
29              Name  of  the array used to restrict the output to the specified
30              array.
31
32       -limit {number}
33              Number of values in each dimension that is  used  to  limit  the
34              display  of array values. By default, unlimited. Only taken into
35              account if used with -detailed.
36
37       -oo <NAME=VALUE>
38              Dataset open option (format specific).  This option may be  used
39              several times.
40
41       -arrayoption <NAME=VALUE>
42              Option passed to GDALGroup::GetMDArrayNames() to filter reported
43              arrays. Such option is format specific. Consult driver  documen‐
44              tation.  This option may be used several times.
45
46       -stats Read  and display image statistics. Force computation if no sta‐
47              tistics are stored in an image.
48
49              New in version 3.2.
50
51
52       -if <format>
53              Format/driver name to be attempted to open the input file(s). It
54              is  generally not necessary to specify it, but it can be used to
55              skip automatic driver detection, when it fails to select the ap‐
56              propriate  driver.  This option can be repeated several times to
57              specify several candidate drivers.
58
59              New in version 3.2.
60
61

C API

63       This utility is also callable from C with GDALMultiDimInfo().
64

EXAMPLES

66       • Display general structure1
67
68          $ gdalmdiminfo netcdf-4d.nc
69
70          {
71            "type": "group",
72            "name": "/",
73            "attributes": {
74              "Conventions": "CF-1.5"
75            },
76            "dimensions": [
77              {
78                "name": "levelist",
79                "full_name": "/levelist",
80                "size": 2,
81                "type": "VERTICAL",
82                "indexing_variable": "/levelist"
83              },
84              {
85                "name": "longitude",
86                "full_name": "/longitude",
87                "size": 10,
88                "type": "HORIZONTAL_X",
89                "direction": "EAST",
90                "indexing_variable": "/longitude"
91              },
92              {
93                "name": "latitude",
94                "full_name": "/latitude",
95                "size": 10,
96                "type": "HORIZONTAL_Y",
97                "direction": "NORTH",
98                "indexing_variable": "/latitude"
99              },
100              {
101                "name": "time",
102                "full_name": "/time",
103                  "size": 4,
104                "type": "TEMPORAL",
105                "indexing_variable": "/time"
106                }
107            ],
108            "arrays": {
109              "levelist": {
110                "datatype": "Int32",
111                "dimensions": [
112                    "/levelist"
113                  ],
114                "attributes": {
115                  "long_name": "pressure_level"
116                },
117                "unit": "millibars"
118              },
119              "longitude": {
120                "datatype": "Float32",
121                "dimensions": [
122                  "/longitude"
123                ],
124                "attributes": {
125                  "standard_name": "longitude",
126                  "long_name": "longitude",
127                  "axis": "X"
128                },
129                "unit": "degrees_east"
130              },
131              "latitude": {
132                "datatype": "Float32",
133                "dimensions": [
134                  "/latitude"
135                ],
136                "attributes": {
137                  "standard_name": "latitude",
138                  "long_name": "latitude",
139                  "axis": "Y"
140                },
141                "unit": "degrees_north"
142              },
143              "time": {
144                "datatype": "Float64",
145                "dimensions": [
146                  "/time"
147                ],
148                "attributes": {
149                  "standard_name": "time",
150                  "calendar": "standard"
151                },
152                "unit": "hours since 1900-01-01 00:00:00"
153              },
154              "t": {
155                "datatype": "Int32",
156                "dimensions": [
157                  "/time",
158                  "/levelist",
159                  "/latitude",
160                  "/longitude"
161                ],
162                "nodata_value": -32767
163              }
164            },
165            "structural_info": {
166              "NC_FORMAT": "CLASSIC"
167            }
168          }
169
170       • Display detailed information about a given array
171
172          $ gdalmdiminfo netcdf-4d.nc -array t -detailed -limit 3
173

AUTHOR

175       Even Rouault <even.rouault@spatialys.com>
176
178       1998-2023
179
180
181
182
183                                 Oct 30, 2023                  GDALMDIMINFO(1)
Impressum