.\" 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 "GDALMDIMINFO" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdalmdiminfo \- ساختار و محتوای یک مجموعه داده چندبعدی را گزارش می‌کند
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
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>
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fBgdalmdiminfo\fP اطلاعات مختلفی را درباره یک مجموعه داده رستر چندبعدی پشتیبانی‌شده توسط GDAL به صورت خروجی JSON فهرست می‌کند. این خروجی از طرح‌واره JSON زیر پیروی می‌کند: \X'tty: link https://github.com/OSGeo/gdal/blob/release/3.13/apps/data/gdalmdiminfo_output.schema.json'\fI\%gdalmdiminfo_output.schema.json\fP\X'tty: link'\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
معادل در رابط خط فرمان جدید \(dqgdal\(dq:
.sp
\fI\%gdal mdim info\fP را ببینید\&.
.UNINDENT
.UNINDENT
.sp
پارامترهای خط فرمان زیر می‌توانند به هر ترتیبی قرار گیرند:
.INDENT 0.0
.TP
.B \-\-help
نمایش این پیام راهنما و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-general
پیام راهنمای کوتاهی درباره گزینه‌های عمومی خط فرمان GDAL نمایش می‌دهد و خارج می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-detailed
پرجزئیات‌ترین خروجی. نوع داده صفت‌ها (attributes) و مقادیر آرایه را گزارش می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B \-nopretty
خروجی را در یک سطر و بدون هیچ‌گونه تورفتگی تولید می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-array <array_name>
نام آرایه‌ای که برای محدود کردن خروجی به آرایه مشخص‌شده استفاده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-limit <number>
تعداد مقادیر در هر بُعد که برای محدود کردن نمایش مقادیر آرایه به کار می‌رود. به‌طور پیش‌فرض، نامحدود است. تنها در صورت استفاده با \-detailed در نظر گرفته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-oo <NAME>=<VALUE>
گزینه باز کردن مجموعه داده (مختص قالب).
این گزینه می‌تواند چندین بار استفاده شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-arrayoption <NAME>=<VALUE>
گزینه‌ای که به \fI\%GDALGroup::GetMDArrayNames()\fP ارسال می‌شود تا آرایه‌های گزارش‌شده را فیلتر کند. این گزینه مختص قالب است؛ مستندات درایور را بررسی کنید.
این گزینه می‌تواند چندین بار استفاده شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-stats
خواندن و نمایش آمارهای آرایه. در صورتی که هیچ آماری در آرایه ذخیره نشده باشد، محاسبه آن را اجباری می‌کند.
.sp
اضافه شده در نسخه 3.2.

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

.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفق در نظر گرفته می‌شوند).
.SH "رابط سی (C API)"
.sp
این ابزار همچنین از طریق زبان C با \fI\%GDALMultiDimInfo()\fP قابل فراخوانی است\&.
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱: نمایش ساختار کلی"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdalmdiminfo 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
.SS "مثال ۲: نمایش اطلاعات دقیق درباره یک آرایه مشخص"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdalmdiminfo netcdf\-4d.nc \-array t \-detailed \-limit 3
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Even Rouault <even.rouault@spatialys.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.