.\" 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-STACK" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-stack \- ترکیب باندهای ورودی با یکدیگر در یک خروجی چندبانده، به‌صورت مجازی (VRT) یا فیزیکی .sp در نسخه 3.11 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster stack [OPTIONS] ... Combine together input bands into a multi\-band output, either virtual (VRT) or materialized. Positional arguments: \-i, \-\-input Input raster datasets (or specify a @ to point to a file containing filenames) [1.. values] [required] [not available in pipelines] \-o, \-\-output Output raster dataset [required] [not available in pipelines] 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 (\(dqGDALG\(dq allowed) [not available in pipelines] \-\-co, \-\-creation\-option = Creation option [may be repeated] [not available in pipelines] \-\-overwrite Whether overwriting existing output dataset is allowed [not available in pipelines] Mutually exclusive with \-\-append \-\-append Append as a subdataset to existing output [not available in pipelines] Mutually exclusive with \-\-overwrite \-b, \-\-band Input band(s) (1\-based index) [may be repeated] \-\-absolute\-path Whether the path to the input datasets should be stored as an absolute path \-\-resolution ,|same|average|common|highest|lowest> Target resolution (in destination CRS units) (default: same) \-\-bbox Target bounding box as xmin,ymin,xmax,ymax (in destination CRS units) \-\-target\-aligned\-pixels Round target extent to target resolution \-\-input\-nodata Set nodata values for input bands. [1.. values] \-\-output\-nodata Set nodata values at the destination band level. [1.. values] \-\-hide\-nodata Makes the destination band not report the NoData. Advanced Options: \-\-if, \-\-input\-format Input formats [may be repeated] [not available in pipelines] \-\-oo, \-\-open\-option = Open options [may be repeated] [not available in pipelines] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp این برنامه باندهای ورودی را از مجموعه‌داده‌های GDAL در یک مجموعه‌داده با یکدیگر ترکیب می‌کند؛ این مجموعه‌داده می‌تواند یک پشته مجازی در قالب \fI\%VRT (Virtual Dataset)\fP یا در یک قالب رستر مرسوم‌تر مانند GeoTIFF باشد. .sp تمام باندهای هر فایل ورودی به عنوان باندهای خروجی مجزا افزوده می‌شوند، مگر اینکه \fI\%\-b\fP برای انتخاب زیرمجموعه‌ای از آن‌ها مشخص شده باشد. .sp فهرست مجموعه‌داده‌های GDAL ورودی را می‌توان در انتهای خط فرمان مشخص کرد یا برای فهرست‌های بسیار طولانی، در یک فایل متنی (یک نام فایل در هر خط) قرار داد. نویسه‌های عام مانند \(aq*\(aq، \(aq?\(aq یا \(aq[\(aq] مربوط به \fI\%VSIGlob()\fP را می‌توان حتی برای فایل‌های واقع بر روی سامانه‌های فایل شبکه‌ای مانند /vsis3/، /vsigs/، /vsiaz/ و غیره نیز به کار برد. .sp از نسخه 3.12 GDAL به بعد، این دستور می‌تواند به عنوان نخستین گام در \fI\%gdal raster pipeline\fP نیز استفاده شود. .SH "خروجی GDALG (مجموعه‌داده در لحظه / جریانی) (GDALG OUTPUT)" .sp این برنامه از سریال‌سازی خط فرمان به صورت یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. فایل حاصل را می‌توان سپس به عنوان یک مجموعه‌داده رستر با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP باز کرد و خط لوله (pipeline) مشخص‌شده را به‌صورت در لحظه (on\-the\-fly) یا جریانی (streamed) اعمال نمود. .SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-absolute\-path در نسخه 3.12.0 اضافه شد. .sp هنگام نوشتن یک فایل VRT، نوشتن مسیر مطلق مجموعه‌داده‌های ورودی را فعال می‌کند. به‌طور پیش‌فرض، نام فایل‌های ورودی (در صورت امکان) به‌صورت نسبی نسبت به نام فایل VRT نوشته می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-b, \-\-band انتخاب یک باند ورودی () برای پردازش. شماره‌گذاری باندها از ۱ آغاز می‌شود. اگر باندهای ورودی مشخص نشوند، تمام باندها به خروجی افزوده خواهند شد. می‌توان از چندین سوییچ \fI\%\-b\fP برای انتخاب مجموعه‌ای از باندهای ورودی استفاده کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-bbox ,,, تنظیم محدوده‌های زمین‌مرجع فایل خروجی. مقادیر باید بر حسب واحدهای زمین‌مرجع بیان شوند. اگر مشخص نشود، محدوده خروجی برابر با حداقل کادر احاطه‌کننده (bounding box) مجموعه رسترهای مبدأ خواهد بود. پیکسل‌های درون محدوده خروجی که توسط هیچ رستر مبدأ پوشش داده نشده‌اند، به عنوان پیکسل‌های معتبر با مقدار صفر خوانده می‌شوند، مگر اینکه مقدار NODATA با استفاده از \fI\%\-\-output\-nodata\fP مشخص شده باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-hide\-nodata حتی اگر هر باندی حاوی مقدار nodata باشد، ارائه این گزینه باعث می‌شود باند خروجی مقدار NoData را گزارش نکند. زمانی که می‌خواهید رنگ پس‌زمینه مجموعه‌داده را کنترل کنید مفید است. .UNINDENT .INDENT 0.0 .TP .B \-\-input\-nodata [,]... تنظیم مقادیر nodata برای باندهای ورودی (می‌توان مقادیر متفاوتی برای هر باند ارائه داد). اگر این گزینه مشخص نشود، تنظیمات ذاتی nodata در مجموعه‌داده‌های مبدأ (در صورت وجود) استفاده خواهد شد. مقدار تعیین‌شده توسط این گزینه در عنصر NODATA از هر عنصر \fBComplexSource\fP نوشته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-nodata [,]... تنظیم مقادیر nodata در سطح باند خروجی (می‌توان مقادیر متفاوتی برای هر باند ارائه داد). اگر بیش از یک مقدار ارائه شود، تمام مقادیر باید داخل علامت نقل‌قول قرار گیرند تا به عنوان یک آرگومان واحد در سیستم‌عامل نگه‌داشته شوند. اگر این گزینه مشخص نشود، تنظیمات ذاتی nodata در نخستین مجموعه‌داده (در صورت وجود) استفاده خواهد شد. مقدار تعیین‌شده توسط این گزینه در عنصر \fBNoDataValue\fP از هر عنصر \fBVRTRasterBand\fP نوشته می‌شود. از مقدار \fINone\fP برای نادیده گرفتن تنظیمات ذاتی nodata در مجموعه‌داده‌های مبدأ استفاده کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-resolution {|same|highest|lowest|average} در صورتی که تفکیک‌پذیری تمام فایل‌های ورودی یکسان نباشد، پرچم \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 = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ساخت دارند که می‌توانند برای کنترل جزئیات فایل ایجادشده استفاده شوند. به عنوان مثال، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و کاشی‌بندی فایل پشتیبانی می‌کند. .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 به برنامه اجازه می‌دهد تا فایل یا مجموعه‌داده هدفِ موجود را بازنویسی کند. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌داده هدف از قبل وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود. .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار صادر می‌شوند، به منزله اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: ساخت یک پشته RGB از ۳ فایل ورودی تک‌بانده .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster stack red.tif green.tif blue.tif rgb.tif .EE .UNINDENT .UNINDENT .SS مثال ۲: ساخت یک پشته مجازی (VRT) از ۲ فایل ورودی تک‌بانده .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster stack raster1.tif raster2.tif result.vrt .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .