.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GDAL-MDIM-INFO" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-mdim-info \- دریافت اطلاعات درباره یک مجموعه داده چندبُعدی
.sp
در نسخه 3.11 اضافه شد.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
کاربرد: 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>  قالب‌های ورودی [می‌تواند تکرار شود]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal mdim info\fP اطلاعات گوناگونی را درباره یک مجموعه داده چندبُعدی
پشتیبانی‌شده توسط GDAL فهرست می‌کند، و هنگام استفاده از خط فرمان آن‌ها را در جریان خروجی
استاندارد، یا هنگام استفاده از API در پارامتر \fBoutput\fP بازمی‌گرداند.
.sp
موارد زیر (در صورت مشخص بودن) به صورت JSON گزارش خواهند شد:
.INDENT 0.0
.IP \(bu 2
درایور قالبی که برای دسترسی به فایل استفاده شده است.
.IP \(bu 2
سلسله‌مراتب گروه‌ها
.IP \(bu 2
مشخصه‌های گروه
.IP \(bu 2
.INDENT 2.0
.TP
.B آرایه‌ها:
.INDENT 7.0
.IP \(bu 2
نام
.IP \(bu 2
نام ابعاد، اندازه‌ها، متغیر نمایه‌سازی
.IP \(bu 2
نوع داده
.IP \(bu 2
مشخصه‌ها
.IP \(bu 2
SRS
.IP \(bu 2
مقدار Nodata
.IP \(bu 2
واحدها
.IP \(bu 2
آمارها (در صورت درخواست)
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های زیر در دسترس هستند:.SS گزینه‌های استاندارد
.INDENT 0.0
.TP
.B \-\-summary
در نسخهٔ 3.13 اضافه شد.

.sp
تنها سلسله‌مراتب گروه و آرایه را، بدون اطلاعات دقیق دربارهٔ مشخصه‌ها یا ابعاد، گزارش می‌دهد.
با \fI\%\-\-detailed\fP به‌طور هم‌زمان قابل استفاده نیست.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-detailed
پرجزئیات‌ترین خروجی. انواع داده‌های مشخصه‌ها و مقادیر آرایه را گزارش می‌دهد.
با \fI\%\-\-summary\fP به‌طور هم‌زمان قابل استفاده نیست.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-array <array_name>
نام آرایه‌ای که برای محدود کردن خروجی به آرایهٔ مشخص‌شده استفاده می‌شود.
.sp
\fBنکته:\fP
.INDENT 7.0
.INDENT 3.5
در صورتی که نام مجموعه داده پیش‌تر مشخص شده باشد، تکمیل خودکار Bash برای \fI\%\-\-array\fP امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-limit <number>
تعداد مقادیر در هر بُعد که برای محدود کردن نمایش مقادیر آرایه استفاده
می‌شود. به‌طور پیش‌فرض، نامحدود است. تنها در صورتی لحاظ می‌شود که همراه با
\-detailed استفاده شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-array\-option <NAME>=<VALUE>
گزینه‌ای که برای فیلتر کردن آرایه‌های گزارش‌شده به \fI\%GDALGroup::GetMDArrayNames()\fP ارسال
می‌شود. چنین گزینه‌ای مختص به قالب است. به مستندات درایور مراجعه کنید.
این گزینه می‌تواند چندین بار استفاده شود.
.sp
\fBنکته:\fP
.INDENT 7.0
.INDENT 3.5
در صورتی که نام مجموعه داده پیش‌تر مشخص شده باشد، تکمیل خودکار Bash برای \fI\%\-\-array\-option\fP امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-stats
خواندن و نمایش آمارهای آرایه. در صورتی که هیچ آماری در یک آرایه
ذخیره نشده باشد، محاسبه را اجباری می‌کند.
.UNINDENT
.SS گزینه‌های پیشرفته
.INDENT 0.0
.TP
.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
گزینهٔ باز کردن مجموعه داده (مختص به قالب).
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-if, \-\-input\-format <format>
نام قالب/درایور که برای تلاش جهت باز کردن فایل(های) ورودی استفاده می‌شود. به‌طور کلی
تعیین آن ضروری نیست، اما در مواقعی که تشخیص خودکار درایور در انتخاب درایور مناسب
ناموفق باشد، می‌تواند برای رد کردن تشخیص خودکار استفاده شود.
این گزینه را می‌توان چندین بار برای تعیین چند درایور کاندید تکرار کرد.
توجه داشته باشید که این کار، آن درایورها را مجبور به باز کردن مجموعه داده نمی‌کند. به‌ویژه،
برخی از درایورها نیازمندی‌هایی برای پسوند فایل دارند.
.sp
می‌تواند تکرار شود.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
برنامه در صورت موفقیت، کد وضعیت 0 و در صورت بروز خطا، مقدار غیرصفر بازمی‌گرداند
(خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفقیت‌آمیز در نظر
گرفته می‌شوند)..SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱: دریافت اطلاعات فایل netcdf\-4d.nc به‌صورت خروجی JSON"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal mdim info netcdf\-4d.nc
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqtype\(dq: \(dqgroup\(dq,
  \(dqname\(dq: \(dq/\(dq,
  \(dqattributes\(dq: {
    \(dqConventions\(dq: \(dqCF\-1.5\(dq
  },
  \(dqdimensions\(dq: [
    {
      \(dqname\(dq: \(dqlevelist\(dq,
      \(dqfull_name\(dq: \(dq/levelist\(dq,
      \(dqsize\(dq: 2,
      \(dqtype\(dq: \(dqVERTICAL\(dq,
      \(dqindexing_variable\(dq: \(dq/levelist\(dq
    },
    {
      \(dqname\(dq: \(dqlongitude\(dq,
      \(dqfull_name\(dq: \(dq/longitude\(dq,
      \(dqsize\(dq: 10,
      \(dqtype\(dq: \(dqHORIZONTAL_X\(dq,
      \(dqdirection\(dq: \(dqEAST\(dq,
      \(dqindexing_variable\(dq: \(dq/longitude\(dq
    },
    {
      \(dqname\(dq: \(dqlatitude\(dq,
      \(dqfull_name\(dq: \(dq/latitude\(dq,
      \(dqsize\(dq: 10,
      \(dqtype\(dq: \(dqHORIZONTAL_Y\(dq,
      \(dqdirection\(dq: \(dqNORTH\(dq,
      \(dqindexing_variable\(dq: \(dq/latitude\(dq
    },
    {
      \(dqname\(dq: \(dqtime\(dq,
      \(dqfull_name\(dq: \(dq/time\(dq,
        \(dqsize\(dq: 4,
      \(dqtype\(dq: \(dqTEMPORAL\(dq,
      \(dqindexing_variable\(dq: \(dq/time\(dq
      }
  ],
  \(dqarrays\(dq: {
    \(dqlevelist\(dq: {
      \(dqdatatype\(dq: \(dqInt32\(dq,
      \(dqdimensions\(dq: [
          \(dq/levelist\(dq
        ],
      \(dqattributes\(dq: {
        \(dqlong_name\(dq: \(dqpressure_level\(dq
      },
      \(dqunit\(dq: \(dqmillibars\(dq
    },
    \(dqlongitude\(dq: {
      \(dqdatatype\(dq: \(dqFloat32\(dq,
      \(dqdimensions\(dq: [
        \(dq/longitude\(dq
      ],
      \(dqattributes\(dq: {
        \(dqstandard_name\(dq: \(dqlongitude\(dq,
        \(dqlong_name\(dq: \(dqlongitude\(dq,
        \(dqaxis\(dq: \(dqX\(dq
      },
      \(dqunit\(dq: \(dqdegrees_east\(dq
    },
    \(dqlatitude\(dq: {
      \(dqdatatype\(dq: \(dqFloat32\(dq,
      \(dqdimensions\(dq: [
        \(dq/latitude\(dq
      ],
      \(dqattributes\(dq: {
        \(dqstandard_name\(dq: \(dqlatitude\(dq,
        \(dqlong_name\(dq: \(dqlatitude\(dq,
        \(dqaxis\(dq: \(dqY\(dq
      },
      \(dqunit\(dq: \(dqdegrees_north\(dq
    },
    \(dqtime\(dq: {
      \(dqdatatype\(dq: \(dqFloat64\(dq,
      \(dqdimensions\(dq: [
        \(dq/time\(dq
      ],
      \(dqattributes\(dq: {
        \(dqstandard_name\(dq: \(dqtime\(dq,
        \(dqcalendar\(dq: \(dqstandard\(dq
      },
      \(dqunit\(dq: \(dqhours since 1900\-01\-01 00:00:00\(dq
    },
    \(dqt\(dq: {
      \(dqdatatype\(dq: \(dqInt32\(dq,
      \(dqdimensions\(dq: [
        \(dq/time\(dq,
        \(dq/levelist\(dq,
        \(dq/latitude\(dq,
        \(dq/longitude\(dq
      ],
      \(dqnodata_value\(dq: \-32767
    }
  },
  \(dqstructural_info\(dq: {
    \(dqNC_FORMAT\(dq: \(dqCLASSIC\(dq
  }
}
.EE
.UNINDENT
.UNINDENT.SH "نویسنده (AUTHOR)"
Even Rouault <even.rouault@spatialys.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.