.\" 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-MOSAIC" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-mdim-mosaic \- ایجاد موزاییک (مجازی یا تحقق‌یافته) از مجموعه‌داده‌های چندبُعدی .sp افزوده‌شده در نگارش 3.12. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX کاربرد: gdal mdim mosaic [گزینه‌ها] ... ایجاد موزاییک، به صورت مجازی (VRT) یا فیزیکی، از مجموعه‌داده‌های چندبُعدی. آرگومان‌های موضعی: \-i, \-\-input مجموعه‌داده‌های رستر چندبُعدی ورودی [۱.. مقدار] [الزامی] \-o, \-\-output مجموعه‌داده رستر چندبُعدی خروجی (ایجادشده توسط الگوریتم) [الزامی] گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش شیوه استفاده به صورت سند JSON و خروج \-\-config = گزینه پیکربندی [تکرارپذیر] \-q, \-\-quiet حالت بی‌صدا (عدم نمایش نوار پیشرفت یا پیام‌های هشدار) [در خطوط لوله در دسترس نیست] گزینه‌ها: \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی \-\-co, \-\-creation\-option = گزینه ایجاد [تکرارپذیر] \-\-overwrite آیا رونویسی روی مجموعه‌داده خروجی موجود مجاز است \-\-array نام آرایه(های) مورد نظر برای موزاییک. [تکرارپذیر] گزینه‌های پیشرفته: \-\-oo, \-\-open\-option = گزینه‌های باز کردن [تکرارپذیر] \-\-if, \-\-input\-format قالب‌های ورودی [تکرارپذیر] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal mdim mosaic\fP یک موزاییک از آرایه(های) چندبُعدی از فهرستی از مجموعه‌داده‌های چندبُعدی ورودی GDAL ایجاد می‌کند، که می‌تواند به صورت یک موزاییک مجازی در قالب \fI\%Multidimensional VRT (Virtual Dataset)\fP، یا در یک قالب متداول‌تر چندبُعدی مانند \fI\%NetCDF: Network Common Data Form\fP یا \fI\%Zarr\fP باشد. .sp نویسه‌های عام مانند \(aq*\(aq، \(aq?\(aq یا \(aq[\(aq] از \fI\%VSIGlob()\fP می‌توانند برای نام مجموعه‌داده‌های ورودی استفاده شوند، حتی روی فایل‌هایی که در سامانه‌های فایل شبکه‌ای مانند /vsis3/، /vsigs/، /vsiaz/ و غیره قرار دارند. همچنین اگر نام یک مجموعه‌داده ورودی با نویسه \fI@\fP شروع شود، فرض می‌شود که حاوی فهرستی از نام‌های واقعی مجموعه‌داده‌ها (هر خط یک نام) برای استفاده به عنوان ورودی است. .sp برای ایجاد یک موزاییک از یک آرایه، محدودیت‌های ساختاری مشخصی بر تمام آرایه‌های مشارکت‌کننده از مجموعه‌داده‌های ورودی اعمال می‌شود: .INDENT 0.0 .IP \(bu 2 تمام آرایه‌های مشارکت‌کننده باید نام آرایه و مسیر یکسانی داشته باشند (برای نمونه \(dq/measurements/pressure\(dq) .IP \(bu 2 باید نوع داده (data type) و مقدار nodata یکسانی داشته باشند .IP \(bu 2 باید تعداد ابعاد یکسان، با همان ترتیب و با همان نام‌ها داشته باشند .IP \(bu 2 هر بُعد از آرایه باید یک متغیر نمایه‌سازی (indexing) عددی یک‌بُعدی مرتبط داشته باشد. .UNINDENT .sp یک کاربرد متداول زمانی است که یک آرایه چندبُعدی در چندین فایل برش خورده است (اسلایس شده است) و بازسازی آرایه کامل مد نظر است. .sp این برنامه می‌تواند از موزاییک‌سازی در راستای چندین محور پشتیبانی کند. .sp ممکن است «حفره‌هایی» (holes) میان مجموعه‌داده‌های مبدأ در امتداد ابعاد موزاییک‌شده وجود داشته باشد و احتمالاً هم‌پوشانی نیز رخ دهد (اما تنها در صورت فاصله‌گذاری منظم در امتداد یک بُعد موزاییک‌شده). حفره‌ها با مقدار nodata پر می‌شوند (اگر در آرایه‌های مبدأ تعریف شده باشد) یا در غیر این صورت با صفر مقداردهی اولیه می‌شوند. در صورت هم‌پوشانی، ترتیب فهرست ورودی اولویت را تعیین می‌کند. فایل‌هایی که در انتهای فهرست قرار دارند، فایل‌هایی هستند که محتوا از آن‌ها واکشی خواهد شد. .sp کاربردهای رایج متفاوتی که این برنامه می‌تواند پوشش دهد عبارتند از: .INDENT 0.0 .IP \(bu 2 یک آرایه سه‌بُعدی در امتداد یک بُعد منفرد (برای مثال یک بُعد زمانی) در چندین فایل برش خورده است که هر برش دارای یک نمونه در امتداد آن بُعد است. در این کاربرد، مهرهای زمانی (timestamps) برش‌ها نیازی به داشتن فواصل منظم ندارند. .IP \(bu 2 یک آرایه دوبُعدی در امتداد ابعاد X و Y قطعه‌بندی یا تایل‌بندی شده است، با فاصله‌گذاری منظم در امتداد ابعاد X و Y، و مقادیر مختصات روی همان شبکه (grid) میان قطعات تراز شده‌اند. .UNINDENT .sp به طور پیش‌فرض، برای هر آرایه با دو یا چند بُعد، یک آرایه هدف ایجاد می‌شود. این رفتار را می‌توان با استفاده از گزینه \fI\%\-\-array\fP به آرایه‌های خاصی محدود کرد. .sp گزینه‌های زیر در دسترس هستند: .SS "گزینه‌های استاندارد (Standard options)" .INDENT 0.0 .TP .B \-i, \-\-input نام مجموعه‌داده‌های چندبُعدی ورودی. الزامی است. .sp نویسه‌های عام مانند \(aq*\(aq، \(aq?\(aq یا \(aq[\(aq] از \fI\%VSIGlob()\fP می‌توانند برای نام مجموعه‌داده‌های ورودی استفاده شوند، حتی روی فایل‌هایی که در سامانه‌های فایل شبکه‌ای مانند /vsis3/، /vsigs/، /vsiaz/ و غیره قرار دارند. همچنین اگر نام مجموعه‌داده ورودی با نویسه \fI@\fP شروع شود، فرض می‌شود حاوی فهرستی از نام‌های واقعی مجموعه‌داده‌ها (هر خط یک نام) برای استفاده به عنوان ورودی است. .UNINDENT .INDENT 0.0 .TP .B \-o, \-\-output نام مجموعه‌داده چندبُعدی خروجی. الزامی است. .UNINDENT .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 نام یا مسیر کامل یک یا چند آرایه برای موزاییک‌سازی. در صورت عدم تعیین، یک آرایه مقصد برای هر آرایه با دو یا چند بُعد ایجاد می‌شود. .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 برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار ارسال می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: موزاییک کردن چندین فایل netCDF با پیشوند slice که برش‌هایی از یک آرایه سه‌بُعدی هستند .INDENT 0.0 .INDENT 3.5 .sp .EX gdal mdim mosaic slice*.nc out.vrt .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .