GDAL-MDIM-INFO(1) GDAL GDAL-MDIM-INFO(1)

gdal-mdim-info - دریافت اطلاعات درباره یک مجموعه داده چندبُعدی

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

کاربرد: gdal mdim info [OPTIONS] <INPUT>
بازگرداندن اطلاعات مربوط به یک مجموعه داده چندبُعدی.
آرگومان‌های موقعیتی:
  -i, --dataset, --input <INPUT>       مجموعه داده رستر چندبُعدی ورودی [لازم]
گزینه‌های عمومی:
  -h, --help                           نمایش پیام راهنما و خروج
  --json-usage                         نمایش نحوه استفاده به صورت سند JSON و خروج
  --config <KEY>=<VALUE>               گزینه پیکربندی [می‌تواند تکرار شود]
گزینه‌ها:
  --summary                            تنها گزارش سلسله‌مراتب گروه و آرایه، بدون اطلاعات تفصیلی درباره مشخصه‌ها یا ابعاد.
                                       ناسازگار با --detailed
  --detailed                           پرجزئیات‌ترین خروجی. گزارش نوع داده مشخصه‌ها و مقادیر آرایه.
                                       ناسازگار با --summary
  --array <ARRAY>                      نام آرایه، جهت محدود کردن خروجی به آرایه مشخص‌شده.
  --limit <LIMIT>                      تعداد مقادیر در هر بُعد که برای محدود کردن نمایش مقادیر آرایه استفاده می‌شود.
  --array-option <KEY>=<VALUE>         گزینه ارائه‌شده به GDALGroup::GetMDArrayNames() برای فیلتر کردن آرایه‌های گزارش‌شده. [می‌تواند تکرار شود]
  --stats                              خواندن و نمایش آمار تصویر.
گزینه‌های پیشرفته:
  --oo, --open-option <KEY>=<VALUE>    گزینه‌های باز کردن [می‌تواند تکرار شود]
  --if, --input-format <INPUT-FORMAT>  قالب‌های ورودی [می‌تواند تکرار شود]

دستور gdal mdim info اطلاعات گوناگونی را درباره یک مجموعه داده چندبُعدی پشتیبانی‌شده توسط GDAL فهرست می‌کند، و هنگام استفاده از خط فرمان آن‌ها را در جریان خروجی استاندارد، یا هنگام استفاده از API در پارامتر output بازمی‌گرداند.

موارد زیر (در صورت مشخص بودن) به صورت JSON گزارش خواهند شد:

  • درایور قالبی که برای دسترسی به فایل استفاده شده است.
  • سلسله‌مراتب گروه‌ها
  • مشخصه‌های گروه
آرایه‌ها:
  • نام
  • نام ابعاد، اندازه‌ها، متغیر نمایه‌سازی
  • نوع داده
  • مشخصه‌ها
  • SRS
  • مقدار Nodata
  • واحدها
  • آمارها (در صورت درخواست)

گزینه‌های زیر در دسترس هستند:.SS گزینه‌های استاندارد

در نسخهٔ 3.13 اضافه شد.

تنها سلسله‌مراتب گروه و آرایه را، بدون اطلاعات دقیق دربارهٔ مشخصه‌ها یا ابعاد، گزارش می‌دهد. با --detailed به‌طور هم‌زمان قابل استفاده نیست.

پرجزئیات‌ترین خروجی. انواع داده‌های مشخصه‌ها و مقادیر آرایه را گزارش می‌دهد. با --summary به‌طور هم‌زمان قابل استفاده نیست.
نام آرایه‌ای که برای محدود کردن خروجی به آرایهٔ مشخص‌شده استفاده می‌شود.

نکته:

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

نکته:

در صورتی که نام مجموعه داده پیش‌تر مشخص شده باشد، تکمیل خودکار Bash برای --array-option امکان‌پذیر است.
خواندن و نمایش آمارهای آرایه. در صورتی که هیچ آماری در یک آرایه ذخیره نشده باشد، محاسبه را اجباری می‌کند.

گزینهٔ باز کردن مجموعه داده (مختص به قالب).

می‌تواند تکرار شود.

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

می‌تواند تکرار شود.

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

$ gdal mdim info 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"
  }
}
Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026