.\" 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-CONVERT" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-mdim-convert \- تبدیل یک مجموعه داده چندبُعدی .sp افزوده شده در نسخه 3.11. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal mdim convert [OPTIONS] Convert a multidimensional dataset. Positional arguments: \-i, \-\-input Input raster or multidimensional raster dataset [required] \-o, \-\-output Output multidimensional raster dataset (created by algorithm) [required] Common Options: \-h, \-\-help Display help message and exit \-\-json\-usage Display usage as JSON document and exit \-\-config = Configuration option [may be repeated] \-q, \-\-quiet Quiet mode (no progress bar or warning message) [not available in pipelines] Options: \-f, \-\-of, \-\-format, \-\-output\-format Output format \-\-co, \-\-creation\-option = Creation option [may be repeated] \-\-overwrite Whether overwriting existing output dataset is allowed \-\-array Select a single array instead of converting the whole dataset. [may be repeated] \-\-array\-option = Option passed to GDALGroup::GetMDArrayNames() to filter arrays. [may be repeated] \-\-group Select a single group instead of converting the whole dataset. [may be repeated] \-\-subset Select a subset of the data. [may be repeated] \-\-scale\-axes Applies a integral scale factor to one or several dimensions [may be repeated] \-\-strict Turn warnings into failures. Advanced Options: \-\-oo, \-\-open\-option = Open options [may be repeated] \-\-if, \-\-input\-format Input formats [may be repeated] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal mdim convert\fP می‌تواند برای تبدیل داده‌های چندبُعدی بین فرمت‌های مختلف استفاده شود. .sp گزینه‌های زیر در دسترس هستند: .SS "گزینه‌های استاندارد (Standard options)" .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format انتخاب فرمت خروجی. این می‌تواند فرمتی باشد که از خروجی چندبُعدی پشتیبانی می‌کند (مانند \fI\%NetCDF: Network Common Data Form\fP، \fI\%Multidimensional VRT\fP)، یا یک فرمت «کلاسیک» ۲بُعدی، در صورتی که نتیجه سایر عملیات تبدیل مشخص‌شده تنها یک آرایه ۲بُعدی منفرد باشد. زمانی که این گزینه مشخص نشود، فرمت در صورت امکان از روی پسوند نام فایل مقصد حدس زده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از فرمت‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توانند برای کنترل ویژگی‌های خاص فایل ایجادشده استفاده شوند. .sp گزینه‌های ساخت موجود بسته به درایور فرمت متفاوت هستند و برخی فرمت‌های ساده هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان \fI\%\-\-format\fP مشاهده کرد، اما مستندات مربوط به همان فرمت مرجع اصلی اطلاعات درباره گزینه‌های ساخت درایور است. برای مشاهده گزینه‌های مجاز ساخت هر فرمت، مستندات اختصاصی \fI\%Raster drivers\fP را ببینید. .sp گزینه‌های ساخت در سطح آرایه را می‌توان با افزودن پیشوند \fBARRAY:\fP ارسال کرد. برای جزئیات بیشتر درباره این گزینه‌ها \fI\%GDALGroup::CopyFrom()\fP را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite به برنامه اجازه می‌دهد تا فایل یا مجموعه داده هدف موجود را بازنویسی کند. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه داده هدف از قبل وجود داشته باشد \fBgdal\fP با خطا مواجه می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-array به‌جای تبدیل کل مجموعه داده، یک آرایه را انتخاب کرده و در صورت امکان عملیاتی روی آن انجام می‌دهد. این گزینه را می‌توان چندین بار برای کار روی آرایه‌های مختلف مشخص کرد. .sp عبارت می‌تواند صرفاً نام یک آرایه باشد که احتمالاً از ساختار نام‌گذاری کامل (/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 \-\-array\-option = گزینه‌ای که برای فیلتر کردن آرایه‌های گزارش‌شده به \fI\%GDALGroup::GetMDArrayNames()\fP ارسال می‌شود. چنین گزینه‌ای مختص فرمت است. به مستندات درایور مراجعه کنید. این گزینه می‌تواند چندین بار استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-\-group به‌جای تبدیل کل مجموعه داده، یک گروه را انتخاب کرده و در صورت امکان عملیاتی روی آن انجام می‌دهد. این گزینه را می‌توان چندین بار برای کار روی گروه‌های مختلف مشخص کرد. اگر فقط یک گروه مشخص شود، محتوای آن مستقیماً در گروه ریشه هدف کپی خواهد شد. اگر چندین گروه مشخص شوند، زیر گروه ریشه هدف کپی می‌شوند. .sp عبارت می‌تواند صرفاً نام یک گروه باشد که احتمالاً از ساختار نام‌گذاری کامل (/group/subgroup/subsubgroup_name) استفاده می‌کند. یا می‌تواند ترکیبی از گزینه‌ها با ساختار زیر باشد: \fBname={src_group_name}[,dstname={dst_group_name}][,recursive=no]\fP .UNINDENT .INDENT 0.0 .TP .B \-\-subset عملیات تعیین زیرمجموعه (برش یا تکه‌کردن) را در امتداد یک بُعد انجام می‌دهد، به شرطی که آن بُعد توسط یک متغیر ۱بُعدی از نوع داده عددی یا رشته‌ای شاخص‌گذاری شده باشد و مقادیر آن به‌صورت یکنواخت مرتب شده باشند. عبارت برای زیرمجموعه‌گیری دقیقاً از \X'tty: link https://portal.opengeospatial.org/files/09-147r3'\fI\%OGC WCS 2.0 KVP encoding\fP\X'tty: link' پیروی می‌کند. .sp به‌صورت \fBdim_name(min_val,max_val)\fP یا \fBdim_name(sliced_val)\fP ساختار اول بُعد \fBdim_name\fP را به مقادیر موجود در بازه [min_val,max_val] محدود می‌کند. ساختار دوم بُعد dim_name را روی مقدار sliced_val برش می‌دهد (و این بُعد از آرایه‌هایی که به آن ارجاع می‌دهند حذف خواهد شد). .sp توجه داشته باشید که نام بُعد به حروف بزرگ و کوچک حساس است. .sp با تکرار این گزینه می‌توان چندین عملیات زیرمجموعه‌گیری را در امتداد ابعاد مختلف مشخص کرد. .sp استفاده از \-\-subset با مشخص کردن گزینه \fIview\fP در \-\-array ناسازگار است. .sp \fI\%مثال ۲\fP یا \fI\%مثال ۳\fP را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-scale\-axes یک ضریب مقیاس عدد صحیح را روی یک یا چند بُعد اعمال می‌کند، یعنی از هر N مقدار، ۱ مقدار را استخراج می‌کند (بدون بازنمونه‌برداری). .sp عبارت دقیقاً از ساختار کدگذاری KVP پارامتر SCALEAXES در \X'tty: link https://portal.opengeospatial.org/files/12-039'\fI\%OGC WCS 2.0 Scaling Extension\fP\X'tty: link' پیروی می‌کند، اما به ضرایب مقیاس عدد صحیح محدود است. .sp یعنی \fB()\fP\&. .sp با تکرار این گزینه می‌توان چندین عملیات مقیاس‌بندی را در امتداد ابعاد مختلف مشخص کرد. .sp استفاده از \-\-scale\-axes با مشخص کردن گزینه \fIview\fP در \-\-array ناسازگار است. .sp \fI\%مثال ۴\fP را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-strict به‌طور پیش‌فرض، برخی از خطاها در طول تبدیل نادیده گرفته می‌شوند، مانند عدم امکان نوشتن ویژگی‌های گروه. با تنظیم این گزینه، چنین خطاهایی باعث شکست فرآیند خواهند شد. .UNINDENT .SS "گزینه‌های پیشرفته (Advanced options)" .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه داده (مختص فرمت). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام فرمت/درایور که برای باز کردن فایل(های) ورودی بررسی می‌شود. به‌طور کلی مشخص کردن آن ضروری نیست، اما می‌تواند برای رد کردن تشخیص خودکار درایور، در مواقعی که درایور مناسب را انتخاب نمی‌کند، استفاده شود. این گزینه می‌تواند چندین بار برای تعیین چندین درایور کاندید تکرار شود. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه داده نمی‌کند. به‌ویژه، برخی از درایورها الزاماتی برای پسوند فایل دارند. .sp می‌تواند تکرار شود. .UNINDENT .SH "کد وضعیت بازگشتی (RETURN STATUS CODE)" .sp برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا کد غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار صادر می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: تبدیل یک فایل netCDF به یک فایل VRT چندبُعدی" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal mdim convert in.nc out.vrt .EE .UNINDENT .UNINDENT .SS "مثال ۲: استخراج یک برش ۲بُعدی از یک آرایه time,Y,X" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal mdim convert in.nc out.tif \-\-subset \(dqtime(\e\(dq2010\-01\-01\e\(dq)\(dq \-\-array temperature .EE .UNINDENT .UNINDENT .SS "مثال ۳: استخراج یک قطعه ۳بُعدی از یک فایل GRIB دارای شاخص زمانی به یک GeoTIFF چندبانده" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal mdim convert /vsicurl/https://tgftp.nws.noaa.gov/SL.us008001/ST.opnl/DF.gr2/DC.ndfd/AR.conus/VP.001\-003/ds.qpf.bin tst.tif \-\-subset \(dqTIME(1763164800,1763251200)\(dq \-\-array QPF_0\-SFC \-\-co COMPRESS=DEFLATE .EE .UNINDENT .UNINDENT .SS "مثال ۴: زیرنمونه‌برداری در امتداد محورهای x و y" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal mdim convert in.nc out.nc \-\-scale\-axes \(dqx(2),y(2)\(dq .EE .UNINDENT .UNINDENT .SS "مثال ۵: بازچینی مقادیر یک آرایه" .sp بازچینی مقادیر آرایه time,Y,X در امتداد محور Y از بالا به پایین به پایین به بالا (یا برعکس) .INDENT 0.0 .INDENT 3.5 .sp .EX gdal mdim convert 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 gdal mdim convert in.nc out.nc \-\-array \(dqname=temperature,transpose=[2,1,0]\(dq .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .