.\" 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 "GDALMDIMTRANSLATE" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdalmdimtranslate \- تبدیل داده‌های چندبُعدی میان فرمت‌های مختلف و استخراج زیرمجموعه
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdalmdimtranslate [\-\-help] [\-\-long\-usage] [\-\-help\-general]
                         [\-if <format>]... [\-of <output_format>]
                         [\-co <NAME>=<VALUE>]...
                         [[\-array <array_spec>]...]
                         [\-arrayoption <NAME>=<VALUE>]...
                         [[\-group <group_spec>]...]
                         [\-subset <subset_spec>]...
                         [\-scaleaxes <scaleaxes_spec>] [\-strict]
                         [\-oo <NAME>=<VALUE>]... [\-\-quiet]
                         <src_dataset> <dst_dataset>
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه
\fBgdalmdimtranslate\fP
رسترهای چندبُعدی را میان فرمت‌های مختلف تبدیل می‌کند، و/یا می‌تواند تبدیل انتخابی آرایه‌ها و گروه‌های خاص، و/یا عملیات استخراج زیرمجموعه (subsetting) را انجام دهد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
معادل در رابط خط فرمان جدید \(dqgdal\(dq:
.sp
دستور
\fI\%gdal mdim convert\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 \-q, \-\-quiet
جلوگیری از نمایش پیام‌های پیشرفت و سایر خروجی‌های غیرخطا.
.UNINDENT
.INDENT 0.0
.TP
.B \-if <format>
نام فرمت/درایور برای تلاش جهت باز کردن فایل(های) ورودی. معمولاً تعیین آن ضروری نیست، اما می‌تواند برای صرف‌نظر کردن از تشخیص خودکار درایور، در مواقعی که درایور مناسب را به درستی انتخاب نمی‌کند، استفاده شود.
این گزینه می‌تواند چندین بار تکرار شود تا چند درایور کاندید مشخص گردد.
توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه داده نمی‌کند؛ به‌ویژه، برخی از درایورها نیازمندی‌هایی برای پسوند فایل دارند.
.sp
در نسخه 3.2 اضافه شد.

.UNINDENT
.INDENT 0.0
.TP
.B \-of <format>
فرمت خروجی را انتخاب می‌کند. این گزینه می‌تواند فرمتی باشد که از خروجی چندبُعدی پشتیبانی می‌کند (مانند \fI\%NetCDF: Network Common Data Form\fP، \fI\%Multidimensional VRT\fP)، یا یک فرمت دوبُعدی \(dqکلاسیک\(dq در صورتی که از سایر عملیات تبدیل مشخص‌شده تنها یک آرایه دوبُعدی منفرد حاصل شود. هنگامی که این گزینه مشخص نشده باشد، در صورت امکان فرمت از روی پسوند نام فایل مقصد حدس زده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-co <NAME>=<VALUE>
بسیاری از فرمت‌ها یک یا چند گزینه اختیاری ایجاد (creation options) دارند که می‌توانند برای کنترل جزئیات فایل ایجادشده استفاده شوند.
.sp
گزینه‌های ایجاد موجود بر اساس درایور فرمت متفاوت هستند و برخی فرمت‌های ساده اصلاً هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان
\fI\%\-\-format\fP
مشاهده کرد، اما مستندات مربوط به آن فرمت منبع اصلی اطلاعات درباره گزینه‌های ایجاد درایور است. مستندات اختصاصی فرمت در
\fI\%Raster drivers\fP
را برای گزینه‌های ایجاد مجاز هر فرمت ببینید.
.sp
گزینه‌های ایجاد در سطح آرایه را می‌توان با افزودن پیشوند
\fBARRAY:\fP
به آن‌ها ارسال کرد. برای جزئیات بیشتر در رابطه با این گزینه‌ها
\fI\%GDALGroup::CopyFrom()\fP
را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-array <array_spec>
به جای تبدیل کل مجموعه داده، یک آرایه را انتخاب کرده و در صورت نیاز عملیاتی روی آن انجام دهید. این گزینه می‌تواند چندین بار برای اعمال روی آرایه‌های مختلف مشخص شود.
.sp
مقدار <array_spec> می‌تواند صرفاً نام یک آرایه باشد که احتمالاً از نحو نام کامل (/group/subgroup/array_name) استفاده می‌کند. یا می‌تواند ترکیبی از گزینه‌ها با نحو زیر باشد:
name={src_array_name}[,dstname={dst_array_name}][,resample=yes][,transpose=[{axis1},{axis2},...][,view={view_expr}]
.sp
گزینه‌های زیر به ترتیب پردازش می‌شوند:
.INDENT 7.0
.IP \(bu 2
گزینه
\fBresample=yes\fP
درخواست می‌کند که آرایه از طریق
\fI\%GDALMDArray::GetResampled()\fP\&
بازنمونه‌برداری شود.
.IP \(bu 2
.INDENT 2.0
.TP
.B [{axis1},{axis2},...]
آرگومان
\fI\%GDALMDArray::Transpose()\fP\&
است. برای مثال،
transpose=[1,0]
ترتیب محورهای یک آرایه دوبُعدی را جابه‌جا می‌کند.
\fI\%مثال ۵\fP\&
را ببینید.
.UNINDENT
.IP \(bu 2
مقدار {view_expr} مقدار آرگومان
\fIviewExpr\fP
در
\fI\%GDALMDArray::GetView()\fP\&
است.
\fI\%مثال ۴\fP\&
را ببینید.
.UNINDENT
.sp
هنگام مشخص کردن یک view_expr که برشی یا استخراج زیرمجموعه را روی یک بُعد انجام می‌دهد، عملیات معادل روی متغیر شاخص‌گذاری مربوطه نیز اعمال خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-arrayoption <NAME>=<VALUE>
در نسخه 3.9 اضافه شد.

.sp
گزینه‌ای که به
\fI\%GDALGroup::GetMDArrayNames()\fP
ارسال می‌شود تا آرایه‌های گزارش‌شده را فیلتر کند. چنین گزینه‌ای مختص به فرمت است. به مستندات درایور مراجعه کنید.
این گزینه می‌تواند چندین بار استفاده شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-group <group_spec>
به جای تبدیل کل مجموعه داده، یک گروه را انتخاب کرده و در صورت نیاز عملیاتی روی آن انجام دهید. این گزینه می‌تواند چندین بار برای اعمال روی گروه‌های مختلف مشخص شود. اگر فقط یک گروه مشخص شود، محتوای آن مستقیماً در گروه ریشه مقصد کپی خواهد شد. اگر چندین گروه مشخص شوند، در زیر گروه ریشه مقصد کپی می‌شوند.
.sp
مقدار <group_spec> می‌تواند فقط نام یک گروه باشد که احتمالاً از نحو نام کامل (/group/subgroup/subsubgroup_name) استفاده می‌کند. یا می‌تواند ترکیبی از گزینه‌ها با نحو زیر باشد:
name={src_group_name}[,dstname={dst_group_name}][,recursive=no]
.UNINDENT
.INDENT 0.0
.TP
.B \-subset <subset_spec>
عملیات استخراج زیرمجموعه (برش یا قطعه‌بندی) را در امتداد یک بُعد انجام می‌دهد، به شرطی که آن بُعد توسط یک متغیر تک‌بُعدی از نوع داده عددی یا رشته‌ای که مقادیر آن به طور یکنواخت مرتب شده‌اند شاخص‌گذاری شده باشد.
مقدار <subset_spec> دقیقاً از
\X'tty: link https://portal.opengeospatial.org/files/09-147r3'\fI\%کدگذاری OGC WCS 2.0 KVP\fP\X'tty: link'
برای استخراج زیرمجموعه پیروی می‌کند.
.sp
یعنی dim_name(min_val,max_val) یا dim_name(sliced_val).
نحو اول، بُعد dim_name را به مقادیری در محدوده [min_val,max_val] محدود می‌کند. نحو دوم، بُعد dim_name را روی مقدار sliced_val برش می‌زند (و این بُعد از آرایه‌هایی که به آن ارجاع دارند حذف خواهد شد).
.sp
استفاده از
.B \-subset
با تعیین گزینه
\fIview\fP
در
.B \-array
ناسازگار است.
.sp
\fI\%مثال ۲\fP\&
را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-scaleaxes <scaleaxes_spec>
یک ضریب مقیاس صحیح را روی یک یا چند بُعد اعمال می‌کند، به این صورت که به ازای هر N مقدار، ۱ مقدار را استخراج می‌کند (بدون بازنمونه‌برداری).
.sp
مقدار <scaleaxes_spec> دقیقاً از نحو کدگذاری KVP پارامتر SCALEAXES در
\X'tty: link https://portal.opengeospatial.org/files/12-039'\fI\%افزونه مقیاس‌بندی OGC WCS 2.0\fP\X'tty: link'
پیروی می‌کند، اما به ضرایب مقیاس صحیح محدود است.
.sp
یعنی <dim1_name>(<scale_factor>)[,<dim2_name>(<scale_factor>)]...
.sp
استفاده از
.B \-scaleaxes
با تعیین گزینه
\fIview\fP
در
.B \-array
ناسازگار است.
.sp
\fI\%مثال ۳\fP\&
را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-strict
به‌طور پیش‌فرض، برخی از خطاها در حین تبدیل نادیده گرفته می‌شوند، مانند عدم توانایی در نوشتن ویژگی‌های گروه. با تعیین این گزینه، چنین خطاهایی باعث شکست فرآیند خواهند شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-oo <NAME>=<VALUE>
در نسخه 3.4 اضافه شد.

.sp
گزینه باز کردن مجموعه داده مبدأ (مختص به فرمت).
.UNINDENT
.INDENT 0.0
.TP
.B <src_dataset>
نام مجموعه داده مبدأ.
.UNINDENT
.INDENT 0.0
.TP
.B <dst_dataset>
نام فایل مقصد.
.UNINDENT
.SH "کد وضعیت خروجی (RETURN STATUS CODE)"
.sp
برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار ارسال می‌شوند، یک اجرای موفق در نظر گرفته می‌شوند).
.SH "رابط سی (C API)"
.sp
این ابزار از زبان C نیز با
\fI\%GDALMultiDimTranslate()\fP\&
قابل فراخوانی است.
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱: تبدیل یک فایل netCDF به یک فایل چندبُعدی VRT"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdalmdimtranslate in.nc out.vrt
.EE
.UNINDENT
.UNINDENT
.SS "مثال ۲: استخراج یک برش دوبُعدی از یک آرایه time,Y,X"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdalmdimtranslate in.nc out.tif \-subset \(aqtime(\(dq2010\-01\-01\(dq)\(aq \-array temperature
.EE
.UNINDENT
.UNINDENT
.SS "مثال ۳: زیرنمونه‌گیری در امتداد محورهای X و Y"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdalmdimtranslate in.nc out.nc \-scaleaxes \(dqX(2),Y(2)\(dq
.EE
.UNINDENT
.UNINDENT
.SS "مثال ۴: مرتب‌سازی مجدد مقادیر یک آرایه"
.sp
مرتب‌سازی مجدد مقادیر آرایه time,Y,X در امتداد محور Y از بالا به پایین به پایین به بالا (یا برعکس).
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdalmdimtranslate in.nc out.nc \-array \(dqname=temperature,view=[:,::\-1,:]\(dq
.EE
.UNINDENT
.UNINDENT
.SS "مثال ۵: ترانهادن یک آرایه با ترتیب ابعاد X,Y,time به time,Y,X"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdalmdimtranslate in.nc out.nc \-array \(dqname=temperature,transpose=[2,1,0]\(dq
.EE
.UNINDENT
.UNINDENT
.SH "نویسنده (AUTHOR)"
Even Rouault <even.rouault@spatialys.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.