.\" 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-RASTER-MOSAIC" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-mosaic \- ساخت یک موزاییک .sp در نسخهٔ 3.11 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX کاربرد: gdal raster mosaic [OPTIONS] ... ساخت یک موزاییک، به صورت مجازی (VRT) یا محقق‌شده (فیزیکی). آرگومان‌های موضعی: \-i, \-\-input مجموعه‌داده‌های رستر ورودی (یا تعیین @ برای اشاره به فایلی حاوی نام فایل‌ها) [۱.. مقدار] [الزامی] [در pipelineها در دسترس نیست] \-o, \-\-output مجموعه‌دادهٔ رستر خروجی [الزامی] [در pipelineها در دسترس نیست] گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوهٔ استفاده به عنوان سند JSON و خروج \-\-config = گزینهٔ پیکربندی [می‌تواند تکرار شود] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در pipelineها در دسترس نیست] گزینه‌ها: \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی (مقدار \(dqGDALG\(dq مجاز است) [در pipelineها در دسترس نیست] \-\-co, \-\-creation\-option = گزینهٔ ساخت [می‌تواند تکرار شود] [در pipelineها در دسترس نیست] \-\-overwrite تعیین اینکه آیا رونویسی مجموعه‌دادهٔ خروجی موجود مجاز است یا خیر [در pipelineها در دسترس نیست] مانعة‌الجمع با \-\-append \-\-append الحاق به عنوان یک زیرمجموعه‌داده به خروجی موجود [در pipelineها در دسترس نیست] مانعة‌الجمع با \-\-overwrite \-b, \-\-band باند(های) ورودی (شاخص بر پایهٔ ۱) [می‌تواند تکرار شود] \-\-absolute\-path تعیین اینکه آیا مسیر مجموعه‌داده‌های ورودی باید به صورت یک مسیر مطلق ذخیره شود یا خیر \-\-resolution ,|same|average|common|highest|lowest> تفکیک‌پذیری هدف (در واحدهای CRS مقصد) (پیش‌فرض: same) \-\-bbox جعبهٔ محصورکنندهٔ هدف به صورت xmin,ymin,xmax,ymax (در واحدهای CRS مقصد) \-\-target\-aligned\-pixels گرد کردن محدودهٔ هدف بر اساس تفکیک‌پذیری هدف \-\-input\-nodata تنظیم مقادیر nodata برای باندهای ورودی. [۱.. مقدار] \-\-output\-nodata تنظیم مقادیر nodata در سطح باند مقصد. [۱.. مقدار] \-\-hide\-nodata باعث می‌شود باند مقصد NoData را گزارش نکند. \-\-add\-alpha هنگامی که رسترهای منبع باند آلفا ندارند، یک باند ماسک آلفا به مقصد اضافه می‌کند. \-\-pixel\-function تعیین یک تابع پیکسل برای محاسبهٔ مقدار خروجی از ورودی‌های همپوشان. PIXEL\-FUNCTION=area|argmax|argmin|cmul|complex|conj|dB|dB2amp|dB2pow|diff|div|exp|expression|geometric_mean|harmonic_mean|imag|intensity|interpolate_exp|interpolate_linear|inv|log10|max|mean|median|min|mod|mode|mul|norm_diff|phase|polar|pow|quantile|real|reclassify|replace_nodata|round|scale|sqrt|sum \-\-pixel\-function\-arg = تعیین آرگومان(ها) برای ارسال به تابع پیکسل [می‌تواند تکرار شود] گزینه‌های پیشرفته: \-\-if, \-\-input\-format قالب‌های ورودی [می‌تواند تکرار شود] [در pipelineها در دسترس نیست] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [می‌تواند تکرار شود] [در pipelineها در دسترس نیست] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp این برنامه از فهرستی از مجموعه‌داده‌های GDAL ورودی، یک موزاییک می‌سازد که می‌تواند یک موزاییک مجازی در قالب \fI\%VRT (Virtual Dataset)\fP، یا در یک قالب رستر مرسوم‌تر مانند GeoTIFF باشد. .sp نویسه‌های عام (wildcard) مانند \(aq*\(aq، \(aq?\(aq یا \(aq[\(aq] مربوط به \fI\%VSIGlob()\fP می‌توانند برای نام مجموعه‌داده‌های ورودی استفاده شوند، حتی برای فایل‌هایی که در سامانه‌های فایل شبکه‌ای مانند /vsis3/، /vsigs/، /vsiaz/ و غیره قرار دارند. همچنین اگر پیشوند نام یک مجموعه‌دادهٔ ورودی نویسهٔ \fI@\fP باشد، فرض می‌شود که آن فایل حاوی فهرستی از نام‌های واقعی مجموعه‌داده‌ها (هر خط یک نام) برای استفاده به عنوان مجموعه‌داده‌های ورودی است. .sp دستور \fBgdal raster mosaic\fP بررسی‌هایی انجام می‌دهد تا اطمینان حاصل شود که همهٔ فایل‌هایی که در فایل حاصل قرار می‌گیرند دارای ویژگی‌های مشابهی هستند: تعداد باندها، سیستم تصویر (projection)، تفسیر رنگ (color interpretation) و غیره. در غیر این صورت، فایل‌هایی که با ویژگی‌های مشترک مطابقت نداشته باشند، نادیده گرفته خواهند شد. .sp از GDAL 3.12 به بعد، می‌توان یک تابع (مانند \fBmin\fP، \fBmean\fP، \fBmedian\fP) را تعیین کرد (\fI\%\-\-pixel\-function\fP) تا مقادیر پیکسل از ورودی‌های همپوشان محاسبه شوند. اگر تابعی تعیین نشود، یا در نسخه‌های پیشین، ترتیب فهرست ورودی برای تعیین اولویت استفاده می‌شود. فایل‌هایی که در انتهای فهرست قرار دارند، فایل‌هایی هستند که محتوا از آن‌ها واکشی خواهد شد. توجه داشته باشید که nodata برای واکشی احتمالی داده‌ها از مجموعه‌داده‌های با اولویت پایین‌تر لحاظ خواهد شد، اما در حال حاضر، کانال آلفا برای انجام ترکیب آلفا (alpha compositing) در نظر گرفته نمی‌شود (بنابراین منبعی با 0=alpha که روی منبع دیگری قرار می‌گیرد، محتوای آن را بازنویسی خواهد کرد). این رفتار ممکن است در نسخه‌های بعدی تغییر کند. .sp از GDAL 3.12 به بعد، این دستور همچنین می‌تواند به عنوان گام نخست در \fI\%gdal raster pipeline\fP\& استفاده شود..SH "خروجی GDALG (مجموعه‌داده در لحظه / جریانی) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))" .sp این برنامه از سریال‌سازی خط فرمان به‌صورت یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. سپس فایل حاصل می‌تواند با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP به‌عنوان یک مجموعه‌داده رستر باز شده و خط لوله (pipeline) مشخص‌شده را به‌صورت در لحظه / جریانی اعمال کند. .SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-absolute\-path در نسخه 3.12.0 اضافه شد. .sp هنگام نوشتن یک فایل VRT، نوشتن مسیر مطلق مجموعه‌داده‌های ورودی را فعال می‌کند. به‌طور پیش‌فرض، نام فایل‌های ورودی (در صورت امکان) به‌صورت نسبی نسبت به نام فایل VRT نوشته می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-add\-alpha در صورتی که رستر مبدأ فاقد آن باشد، یک باند ماسک آلفا به خروجی اضافه می‌کند. عمدتاً برای منابع RGB (یا منابع مقیاس خاکستری) کاربرد دارد. باند آلفا در لحظه با مقدار 0 در نواحی فاقد رستر مبدأ، و با مقدار 255 در نواحی دارای رستر مبدأ پر می‌شود. اثر آن این است که یک نمایشگر RGBA نواحی بدون رسترهای مبدأ را به‌صورت شفاف و نواحی دارای رسترهای مبدأ را به‌صورت کدر و مات رندر می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-b, \-\-band یک ورودی را برای پردازش انتخاب می‌کند. شماره‌گذاری باندها از 1 آغاز می‌شود. اگر باندهای ورودی تنظیم نشوند، همه باندها به خروجی اضافه خواهند شد. می‌توان از چندین سوییچ \fI\%\-b\fP برای انتخاب مجموعه‌ای از باندهای ورودی استفاده کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-bbox ,,, محدوده ارجاع‌جغرافیایی (georeferenced) فایل خروجی را تنظیم می‌کند. مقادیر باید در واحدهای ارجاع‌جغرافیایی بیان شوند. در صورت عدم تعیین، محدوده خروجی برابر با حداقل جعبه مرزی (minimum bounding box) مجموعه رسترهای مبدأ خواهد بود. پیکسل‌های درون محدوده خروجی که توسط رستر مبدأ پوشش داده نشده‌اند، به‌عنوان پیکسل‌های معتبر با مقدار صفر خوانده می‌شوند مگر اینکه مقدار NODATA با استفاده از \fI\%\-\-output\-nodata\fP مشخص شده باشد یا با \fI\%\-\-add\-alpha\fP\& یک باند ماسک آلفا اضافه گردد. .UNINDENT .INDENT 0.0 .TP .B \-\-hide\-nodata حتی اگر هر باندی حاوی مقدار nodata باشد، ارائه این گزینه باعث می‌شود باند خروجی NoData را گزارش نکند. این گزینه هنگامی که می‌خواهید رنگ پس‌زمینه مجموعه‌داده را کنترل کنید مفید است. با استفاده همزمان از گزینه \fI\%\-\-add\-alpha\fP، می‌توانید مجموعه‌داده‌ای آماده کنید که مقدار nodata را گزارش نمی‌دهد اما در نواحی فاقد داده، شفاف است. .UNINDENT .INDENT 0.0 .TP .B \-\-input\-nodata [,]... مقادیر nodata را برای باندهای ورودی تنظیم می‌کند (می‌توان مقادیر متفاوتی برای هر باند ارائه داد). اگر این گزینه مشخص نشود، تنظیمات درونی nodata در مجموعه‌داده‌های مبدأ (در صورت وجود) استفاده خواهند شد. مقدار تنظیم‌شده توسط این گزینه در عنصر NODATA از هر عنصر \fBComplexSource\fP نوشته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-nodata [,]... مقادیر nodata را در سطح باند خروجی تنظیم می‌کند (می‌توان مقادیر متفاوتی برای هر باند ارائه داد). اگر بیش از یک مقدار مشخص شود، تمام مقادیر باید در نقل‌قول قرار گیرند تا به‌عنوان یک آرگومان واحد سیستم‌عامل حفظ شوند (\fI\%Example 1\fP). اگر این گزینه مشخص نشود، تنظیمات درونی nodata در اولین مجموعه‌داده (در صورت وجود) استفاده خواهند شد. مقدار تنظیم‌شده با این گزینه در عنصر \fBNoDataValue\fP از هر \fBVRTRasterBand element\fP\& نوشته می‌شود. از مقدار \fINone\fP برای نادیده گرفتن تنظیمات nodata درونی در مجموعه‌داده‌های مبدأ استفاده کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-pixel\-function نام تابعی را برای محاسبه یک مقدار از ورودی‌های هم‌پوشان مشخص می‌کند. برای مشاهده فهرستی از توابع پیکسل موجود، \fI\%Built\-in Pixel Functions\fP\& را ببینید. اگر تابعی مشخص نشود، مقادیر از آخرین ورودی هم‌پوشان دریافت خواهند شد. .sp در نسخه 3.12 اضافه شد. .UNINDENT .INDENT 0.0 .TP .B \-\-pixel\-function\-arg آرگومانی را برای ارائه به یک تابع پیکسل، در قالب \fB=\fP\& مشخص می‌کند. می‌توان با تکرار این گزینه چندین آرگومان را تعیین کرد. .sp در نسخه 3.12 اضافه شد. .UNINDENT .INDENT 0.0 .TP .B \-\-resolution {|same|highest|lowest|average} در صورتی که تفکیک‌پذیری (resolution) تمام فایل‌های ورودی یکسان نباشد، پرچم \fI\%\-\-resolution\fP به کاربر امکان می‌دهد تا نحوه محاسبه تفکیک‌پذیری خروجی را کنترل کند. .sp \fIsame\fP، مقدار پیش‌فرض، بررسی می‌کند که آیا همه رسترهای مبدأ تفکیک‌پذیری یکسانی دارند یا خیر، و در غیر این صورت با خطا متوقف می‌شود. .sp \fIhighest\fP کوچک‌ترین مقادیر ابعاد پیکسل را در میان مجموعه رسترهای مبدأ انتخاب می‌کند. .sp \fIlowest\fP بزرگ‌ترین مقادیر ابعاد پیکسل را در میان مجموعه رسترهای مبدأ انتخاب می‌کند. .sp \fIaverage\fP میانگین ابعاد پیکسل را در میان مجموعه رسترهای مبدأ محاسبه می‌کند. .sp \fIcommon\fP بزرگ‌ترین مقسوم‌علیه مشترک ابعاد پیکسل مبدأ را تعیین می‌کند، مثلاً 0.2 برای ابعاد پیکسل مبدأ 0.4 و 0.6. .sp ,. مقادیر باید در واحدهای ارجاع‌جغرافیایی بیان شوند. هر دو باید مقادیری مثبت باشند. .UNINDENT .INDENT 0.0 .TP .B \-\-target\-aligned\-pixels (پیکسل‌های هم‌تراز با هدف) مختصات محدوده فایل خروجی را با مقادیر \fI\%\-\-resolution\fP تراز می‌کند، به‌گونه‌ای که محدوده تراز‌شده شامل حداقل محدوده باشد. تراز کردن به این معنی است که xmin / resx، ymin / resy، xmax / resx و ymax / resy مقادیر صحیح باشند. .UNINDENT.SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-append الحاق رستر ورودی به‌عنوان یک زیرمجموعه‌داده (subdataset) جدید به یک فایل خروجی موجود. تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده‌ها پشتیبانی می‌کنند؛ مانند \fI\%GTiff \-\- GeoTIFF File Format\fP و \fI\%GPKG \-\- GeoPackage raster\fP. همچنین اگر مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از فرمت‌ها یک یا چند گزینه اختیاری ساخت (creation option) دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و این‌که آیا فایل باید کاشی‌بندی (tiled) شود یا خیر، پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت موجود بسته به درایور فرمت متفاوت هستند و برخی فرمت‌های ساده هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات خود فرمت، منبع اصلی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر فرمت، به مستندات اختصاصی در \fI\%Raster drivers\fP مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام فرمت/درایور برای تلاش جهت باز کردن فایل(های) ورودی. معمولاً تعیین آن ضروری نیست، اما در صورتی که تشخیص خودکار درایور نتواند درایور مناسب را انتخاب کند، می‌توان از آن برای نادیده گرفتن تشخیص خودکار استفاده کرد. این گزینه می‌تواند چندین بار برای تعیین چندین درایور کاندید تکرار شود. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند. به‌ویژه، برخی از درایورها الزامات خاصی برای پسوند فایل دارند. .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه‌داده (مخصوص هر فرمت). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format فرمت رستر خروجی مورد استفاده را مشخص می‌کند. مقادیر مجاز را می‌توان با این دستور به دست آورد: \fBgdal \-\-formats | grep raster | grep rw | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite به برنامه اجازه می‌دهد تا فایل یا مجموعه‌داده هدفِ موجود را رونویسی (overwrite) کند. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌داده هدف از قبل وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود. .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: ساخت یک موزاییک مجازی با رنگ پس‌زمینه آبی (RGB: 0 0 255) .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster mosaic \-\-hide\-nodata \-\-output\-nodata=0,0,255 doq/*.tif doq_index.vrt .EE .UNINDENT .UNINDENT .SS مثال ۲: ایجاد یک موزاییک Cloud Optimized GeoTIFF (COG) از تمام فایل‌های GeoTIFF در یک پوشه .sp از آنجا که اندازه فایل GeoTIFF حاصل بیش از 4 GB خواهد بود، از گزینه ساخت \fI\%BIGTIFF=YES\fP استفاده می‌شود. .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster mosaic \-\-output\-format COG \-\-creation\-option BIGTIFF=YES *.tif mosaic.tif .EE .UNINDENT .UNINDENT.SH "نویسنده (AUTHOR)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .