| 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 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 |