GDALMDIMINFO(1) GDAL GDALMDIMINFO(1)

gdalmdiminfo - ساختار و محتوای یک مجموعه داده چندبعدی را گزارش می‌کند

Usage: gdalmdiminfo [--help] [--long-usage] [--help-general]
                    [[-summary]|[-detailed]]
                    [-nopretty] [-array <array_name>] [-limit <number>]
                    [-oo <NAME>=<VALUE>]... [-if <format>]...
                    [-arrayoption <NAME>=<VALUE>]... [-stats]
                    <dataset_name>

برنامه gdalmdiminfo اطلاعات مختلفی را درباره یک مجموعه داده رستر چندبعدی پشتیبانی‌شده توسط GDAL به صورت خروجی JSON فهرست می‌کند. این خروجی از طرح‌واره JSON زیر پیروی می‌کند: gdalmdiminfo_output.schema.json.

نکته:

معادل در رابط خط فرمان جدید "gdal":

gdal mdim info را ببینید.

پارامترهای خط فرمان زیر می‌توانند به هر ترتیبی قرار گیرند:

نمایش این پیام راهنما و خروج.
--help-general
پیام راهنمای کوتاهی درباره گزینه‌های عمومی خط فرمان GDAL نمایش می‌دهد و خارج می‌شود.
پرجزئیات‌ترین خروجی. نوع داده صفت‌ها (attributes) و مقادیر آرایه را گزارش می‌دهد.
خروجی را در یک سطر و بدون هیچ‌گونه تورفتگی تولید می‌کند.
نام آرایه‌ای که برای محدود کردن خروجی به آرایه مشخص‌شده استفاده می‌شود.
تعداد مقادیر در هر بُعد که برای محدود کردن نمایش مقادیر آرایه به کار می‌رود. به‌طور پیش‌فرض، نامحدود است. تنها در صورت استفاده با -detailed در نظر گرفته می‌شود.
گزینه باز کردن مجموعه داده (مختص قالب). این گزینه می‌تواند چندین بار استفاده شود.
گزینه‌ای که به GDALGroup::GetMDArrayNames() ارسال می‌شود تا آرایه‌های گزارش‌شده را فیلتر کند. این گزینه مختص قالب است؛ مستندات درایور را بررسی کنید. این گزینه می‌تواند چندین بار استفاده شود.
خواندن و نمایش آمارهای آرایه. در صورتی که هیچ آماری در آرایه ذخیره نشده باشد، محاسبه آن را اجباری می‌کند.

اضافه شده در نسخه 3.2.

نام قالب/درایور برای تلاش جهت باز کردن فایل(های) ورودی. معمولاً تعیین آن ضروری نیست، اما می‌تواند برای صرف‌نظر از تشخیص خودکار درایور، در هنگامی که در انتخاب درایور مناسب ناموفق است، استفاده شود. این گزینه می‌تواند برای تعیین چندین درایور نامزد، چندین بار تکرار شود. توجه داشته باشید که این گزینه درایورها را مجبور به باز کردن مجموعه داده نمی‌کند. به‌ویژه، برخی از درایورها نیازمندی‌هایی برای پسوند فایل دارند.

اضافه شده در نسخه 3.2.

این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفق در نظر گرفته می‌شوند).

این ابزار همچنین از طریق زبان C با GDALMultiDimInfo() قابل فراخوانی است.

$ 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

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026