GDALMDIMINFO(1)                      GDAL                      GDALMDIMINFO(1)

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

خلاصه دستور (SYNOPSIS)

          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>

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

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

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

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

       --help نمایش این پیام راهنما و خروج.

       --help-general
              پیام راهنمای کوتاهی درباره گزینه‌های عمومی خط فرمان GDAL نمایش
              می‌دهد و خارج می‌شود.

       -detailed
              پرجزئیات‌ترین خروجی. نوع داده صفت‌ها (attributes) و مقادیر آرایه
              را گزارش می‌دهد.

       -nopretty
              خروجی را در یک سطر و بدون هیچ‌گونه تورفتگی تولید می‌کند.

       -array <array_name>
              نام آرایه‌ای که برای محدود کردن خروجی به آرایه مشخص‌شده استفاده
              می‌شود.

       -limit <number>
              تعداد مقادیر در هر بُعد که برای محدود کردن نمایش مقادیر آرایه به
              کار می‌رود. به‌طور پیش‌فرض، نامحدود است. تنها در صورت استفاده با
              -detailed در نظر گرفته می‌شود.

       -oo <NAME>=<VALUE>
              گزینه باز کردن مجموعه داده (مختص قالب).  این گزینه می‌تواند چندین
              بار استفاده شود.

       -arrayoption <NAME>=<VALUE>
              گزینه‌ای که به GDALGroup::GetMDArrayNames() ارسال می‌شود تا
              آرایه‌های گزارش‌شده را فیلتر کند. این گزینه مختص قالب است؛ مستندات
              درایور را بررسی کنید.  این گزینه می‌تواند چندین بار استفاده شود.

       -stats خواندن و نمایش آمارهای آرایه. در صورتی که هیچ آماری در آرایه
              ذخیره نشده باشد، محاسبه آن را اجباری می‌کند.

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


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

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


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

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

مثال‌ها (EXAMPLES)
   مثال ۱: نمایش ساختار کلی

          $ 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

نویسندگان (AUTHORS)
       Even Rouault <even.rouault@spatialys.com>

کپی‌رایت و تکثیر (COPYRIGHT)
       1998-2026

                                August 18, 2026                GDALMDIMINFO(1)