gdalmdiminfo

Added in version 3.1.

多次元データセットの構造と内容を報告します.

概要

gdalmdiminfo [--help] [--help-general]
             [-oo <NAME>=<VALUE>]... [-arrayoption <NAME>=<VALUE>]...
             [-detailed] [-nopretty] [-array <array_name>] [-limit <number>]
             [-stats] [-if <format>]... <datasetname>

説明

gdalmdiminfo プログラムは, GDAL がサポートする多次元ラスターデータセットについてのさまざまな情報を JSON 出力でリストします. 以下の JSON スキーマ に従います.

以下のコマンドラインパラメータは任意の順序で現れることができます

--help

このヘルプメッセージを表示して終了します

--help-general

一般的な GDAL コマンドラインオプションの使用方法の簡単なメッセージを表示して終了します.

-detailed

大多数の冗長な出力. 属性データ型と配列値を報告します.

-nopretty

インデントなしで 1 行に出力します.

-array <array_name>

出力を指定された配列に制限するために使用される配列の名前.

-limit <number>

各次元の値の数. 配列値の表示を制限するために使用されます. デフォルトでは無制限です. -detailed と一緒に使用された場合のみ考慮されます.

-oo <NAME>=<VALUE>

データセットオープンオプション (フォーマット固有). このオプションは複数回使用できます.

-arrayoption <NAME>=<VALUE>

報告される配列をフィルタリングするために GDALGroup::GetMDArrayNames() に渡されるオプション. このようなオプションはフォーマット固有です. ドライバのドキュメントを参照してください. このオプションは複数回使用できます.

-stats

画像統計を読み込んで表示します. 画像に統計が保存されていない場合は計算を強制します.

Added in version 3.2.

-if <format>

入力ファイルを開こうとするフォーマット/ドライバ名. 通常は指定する必要はありませんが, 適切なドライバを選択できない場合に自動ドライバ検出をスキップするために使用できます. このオプションは複数回繰り返すことができ, 複数の候補ドライバを指定するために使用できます. これらのドライバをデータセットを開くように強制するわけではないことに注意してください. 特に, 一部のドライバはファイル拡張子に要件を持っています.

Added in version 3.2.

C API

このユーティリティは GDALMultiDimInfo() を使用して C からも呼び出すことができます.

例

• 一般的な構造1を表示

$ 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"
  }
}

• 指定された配列に関する詳細情報を表示

$ gdalmdiminfo netcdf-4d.nc -array t -detailed -limit 3