.\" 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-SELECT" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-select \- انتخاب زیرمجموعه‌ای از باندهای یک مجموعه داده رستر .sp در نسخه 3.11 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX کاربرد: gdal raster select [OPTIONS] انتخاب زیرمجموعه‌ای از باندهای یک مجموعه داده رستر. آرگومان‌های مکانی: \-i, \-\-input مجموعه داده‌های رستر ورودی [الزامی] [در خط‌های لوله در دسترس نیست] \-o, \-\-output مجموعه داده رستر خروجی [الزامی] [در خط‌های لوله در دسترس نیست] \-b, \-\-band باند(ها) (نمایه مبتنی بر ۱، \(aqmask\(aq، \(aqmask:\(aq یا تفسیر رنگی مانند \(aqred\(aq) [۱.. مقدار] [الزامی] گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده به صورت سند JSON و خروج \-\-config = گزینه پیکربندی [می‌تواند تکرار شود] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خط‌های لوله در دسترس نیست] گزینه‌ها: \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی (\(dqGDALG\(dq مجاز است) [در خط‌های لوله در دسترس نیست] \-\-co, \-\-creation\-option = گزینه ساخت [می‌تواند تکرار شود] [در خط‌های لوله در دسترس نیست] \-\-overwrite آیا رونویسی مجموعه داده خروجی موجود مجاز است [در خط‌های لوله در دسترس نیست] مانعه‌الجمع با \-\-append \-\-append الحاق به عنوان یک زیرمجموعه داده به خروجی موجود [در خط‌های لوله در دسترس نیست] مانعه‌الجمع با \-\-overwrite \-\-exclude مستثنی کردن باندهای مشخص‌شده \-\-mask باند ماسک (شاخص مبتنی بر ۱، \(aqmask\(aq، \(aqmask:\(aq یا \(aqnone\(aq) گزینه‌های پیشرفته: \-\-if, \-\-input\-format قالب‌های ورودی [می‌تواند تکرار شود] [در خط‌های لوله در دسترس نیست] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [می‌تواند تکرار شود] [در خط‌های لوله در دسترس نیست] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp از \fBgdal raster select\fP می‌توان برای انتخاب و مرتب‌سازی مجدد زیرمجموعه‌ای از باندهای رستر از یک مجموعه داده رستر استفاده کرد. .sp این زیردستور همچنین به عنوان یک گام بالقوه در \fI\%gdal raster pipeline\fP در دسترس است. .SH "خروجی GDALG (مجموعه داده بی‌درنگ / جریانی) (GDALG OUTPUT)" .sp این برنامه از سریال‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. فایل حاصل را می‌توان سپس به عنوان یک مجموعه داده رستر با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP باز کرد و خط لوله مشخص‌شده را به صورت بی‌درنگ / جریانی اعمال نمود. .SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-exclude در نسخه 3.13 اضافه شد. .sp رفتار الگوریتم را به گونه‌ای تغییر می‌دهد که تمام باندها انتخاب شوند، به جز باندهایی که با \fI\%\-\-band\fP مشخص شده‌اند\&. .UNINDENT .INDENT 0.0 .TP .B \-\-band یک یا چند باند ورودی را انتخاب می‌کند. شماره‌گذاری باندها از ۱ آغاز می‌شود. می‌توان چندین مقدار را برای انتخاب مجموعه‌ای از باندهای ورودی جهت نوشتن در فایل خروجی یا مرتب‌سازی دوباره باندها تعیین کرد. مقدار ویژه \fBmask\fP به معنای باند ماسک نخستین باند مجموعه داده ورودی است. باند ماسک هر باندی را می‌توان با \fBmask:\fP مشخص کرد\&. باند ماسکی که با \fB\-\-band\fP انتخاب شود، به یک باند معمولی در مجموعه داده خروجی تبدیل خواهد شد. .sp از GDAL 3.13 به بعد، مقدار همچنین می‌تواند یک تفسیر رنگی مانند \(dqred\(dq، \(dqgreen\(dq، \(dqblue\(dq، \(dqalpha\(dq، \(dqnir\(dq و غیره باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-mask یک باند ورودی را برای ایجاد باند ماسک مجموعه داده خروجی انتخاب می‌کند. شماره‌گذاری باندها از ۱ آغاز می‌شود. مقدار ویژه \fBmask\fP به معنای باند ماسک نخستین باند مجموعه داده ورودی است. باند ماسک هر باندی را می‌توان با \fBmask:\fP مشخص کرد\&. مقدار را می‌توان روی \fBnone\fP تنظیم کرد تا در صورت وجود ماسک سراسری در مجموعه داده ورودی، از کپی کردن آن جلوگیری شود. در غیر این صورت به طور پیش‌فرض کپی می‌شود، مگر اینکه ماسک یک کانال آلفا باشد، یا اینکه صراحتاً برای تبدیل شدن به یک باند معمولی در مجموعه داده خروجی انتخاب شده باشد (\fB\-\-band mask\fP). .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-append رستر ورودی را به عنوان یک زیرمجموعه داده جدید به فایل خروجی موجود الحاق می‌کند. تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه داده پشتیبانی می‌کنند، مانند \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 این برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا کد غیر صفر را بازمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار صادر می‌شوند، به منزله اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: مرتب‌سازی دوباره یک مجموعه داده ۳ باندی با ترتیب باندهای آبی، سبز، قرمز به قرمز، سبز، آبی .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster select \-\-band 3,2,1 bgr.tif rgb.tif \-\-overwrite .EE .UNINDENT .UNINDENT .SS مثال ۲: انتخاب باندهای ورودی بر اساس تفسیر رنگی آنها .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster select \-\-band red,green,blue input.tif rgb.tif \-\-overwrite .EE .UNINDENT .UNINDENT .SS مثال ۳: تبدیل یک مجموعه داده RGBA به یک GeoTIFF فشرده‌شده با JPEG و YCbCr .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster select \-\-band 1,2,3 \-\-mask 4 \-\-co COMPRESS=JPEG,PHOTOMETRIC=YCBCR rgba.tif rgb_mask.tif .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .