GDAL-RASTER-SELECT(1) GDAL GDAL-RASTER-SELECT(1)

gdal-raster-select - انتخاب زیرمجموعه‌ای از باندهای یک مجموعه داده رستر

در نسخه 3.11 اضافه شد.

کاربرد: gdal raster select [OPTIONS] <INPUT> <OUTPUT> <BAND>
انتخاب زیرمجموعه‌ای از باندهای یک مجموعه داده رستر.
آرگومان‌های مکانی:
  -i, --input <INPUT>                                  مجموعه داده‌های رستر ورودی [الزامی] [در خط‌های لوله در دسترس نیست]
  -o, --output <OUTPUT>                                مجموعه داده رستر خروجی [الزامی] [در خط‌های لوله در دسترس نیست]
  -b, --band <BAND>                                    باند(ها) (نمایه مبتنی بر ۱، 'mask'، 'mask:<band>' یا تفسیر رنگی مانند 'red') [۱.. مقدار] [الزامی]
گزینه‌های عمومی:
  -h, --help                                           نمایش پیام راهنما و خروج
  --json-usage                                         نمایش نحوه استفاده به صورت سند JSON و خروج
  --config <KEY>=<VALUE>                               گزینه پیکربندی [می‌تواند تکرار شود]
  -q, --quiet                                          حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خط‌های لوله در دسترس نیست]
گزینه‌ها:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی ("GDALG" مجاز است) [در خط‌های لوله در دسترس نیست]
  --co, --creation-option <KEY>=<VALUE>                گزینه ساخت [می‌تواند تکرار شود] [در خط‌های لوله در دسترس نیست]
  --overwrite                                          آیا رونویسی مجموعه داده خروجی موجود مجاز است [در خط‌های لوله در دسترس نیست]
                                                       مانعه‌الجمع با --append
  --append                                             الحاق به عنوان یک زیرمجموعه داده به خروجی موجود [در خط‌های لوله در دسترس نیست]
                                                       مانعه‌الجمع با --overwrite
  --exclude                                            مستثنی کردن باندهای مشخص‌شده
  --mask <MASK>                                        باند ماسک (شاخص مبتنی بر ۱، 'mask'، 'mask:<band>' یا 'none')
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                  قالب‌های ورودی [می‌تواند تکرار شود] [در خط‌های لوله در دسترس نیست]
  --oo, --open-option <KEY>=<VALUE>                    گزینه‌های باز کردن [می‌تواند تکرار شود] [در خط‌های لوله در دسترس نیست]

از gdal raster select می‌توان برای انتخاب و مرتب‌سازی مجدد زیرمجموعه‌ای از باندهای رستر از یک مجموعه داده رستر استفاده کرد.

این زیردستور همچنین به عنوان یک گام بالقوه در gdal raster pipeline در دسترس است.

این برنامه از سریال‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از قالب خروجی GDALG پشتیبانی می‌کند. فایل حاصل را می‌توان سپس به عنوان یک مجموعه داده رستر با استفاده از درایور GDALG: GDAL Streamed Algorithm باز کرد و خط لوله مشخص‌شده را به صورت بی‌درنگ / جریانی اعمال نمود.

در نسخه 3.13 اضافه شد.

رفتار الگوریتم را به گونه‌ای تغییر می‌دهد که تمام باندها انتخاب شوند، به جز باندهایی که با --band مشخص شده‌اند.

یک یا چند باند ورودی را انتخاب می‌کند. شماره‌گذاری باندها از ۱ آغاز می‌شود. می‌توان چندین مقدار را برای انتخاب مجموعه‌ای از باندهای ورودی جهت نوشتن در فایل خروجی یا مرتب‌سازی دوباره باندها تعیین کرد. مقدار ویژه mask به معنای باند ماسک نخستین باند مجموعه داده ورودی است. باند ماسک هر باندی را می‌توان با mask:<band> مشخص کرد. باند ماسکی که با --band انتخاب شود، به یک باند معمولی در مجموعه داده خروجی تبدیل خواهد شد.

از GDAL 3.13 به بعد، مقدار <BAND> همچنین می‌تواند یک تفسیر رنگی مانند "red"، "green"، "blue"، "alpha"، "nir" و غیره باشد.

یک باند ورودی را برای ایجاد باند ماسک مجموعه داده خروجی انتخاب می‌کند. شماره‌گذاری باندها از ۱ آغاز می‌شود. مقدار ویژه mask به معنای باند ماسک نخستین باند مجموعه داده ورودی است. باند ماسک هر باندی را می‌توان با mask:<band> مشخص کرد. مقدار <BAND> را می‌توان روی none تنظیم کرد تا در صورت وجود ماسک سراسری در مجموعه داده ورودی، از کپی کردن آن جلوگیری شود. در غیر این صورت به طور پیش‌فرض کپی می‌شود، مگر اینکه ماسک یک کانال آلفا باشد، یا اینکه صراحتاً برای تبدیل شدن به یک باند معمولی در مجموعه داده خروجی انتخاب شده باشد (--band mask).

رستر ورودی را به عنوان یک زیرمجموعه داده جدید به فایل خروجی موجود الحاق می‌کند. تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه داده پشتیبانی می‌کنند، مانند GTiff -- GeoTIFF File Format و GPKG -- GeoPackage raster. این گزینه همچنین در صورتی که مجموعه داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.
بسیاری از قالب‌ها یک یا چند گزینه اختیاری ساخت دارند که می‌توانند برای کنترل جزئیات فایل ایجادشده به کار روند. به عنوان مثال، درایور GeoTIFF از گزینه‌های ساختی برای کنترل فشرده‌سازی و کاشی‌بندی بودن فایل پشتیبانی می‌کند.

می‌تواند تکرار شود.

گزینه‌های ساختِ در دسترس بر اساس درایور قالب متغیر است و برخی قالب‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات قالب، منبع نهایی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر قالب، مستندات اختصاصی قالب را در Raster drivers ببینید.

نام قالب/درایور برای تلاش جهت باز کردن فایل(های) ورودی. معمولاً نیازی به تعیین آن نیست، اما در صورتی که تشخیص خودکار درایور در انتخاب درایور مناسب ناموفق باشد، می‌تواند برای رد کردن تشخیص خودکار به کار رود. این گزینه می‌تواند چندین بار برای تعیین چندین درایور نامزد تکرار شود. توجه داشته باشید که این کار آن درایورها را مجبور به باز کردن مجموعه داده نمی‌کند. به‌ویژه، برخی درایورها الزاماتی روی پسوند فایل دارند.

می‌تواند تکرار شود.

گزینه باز کردن مجموعه داده (مختص قالب).

می‌تواند تکرار شود.

مشخص می‌کند از کدام قالب رستر خروجی استفاده شود. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: gdal --formats | grep raster | grep rw | sort
به برنامه اجازه می‌دهد فایل یا مجموعه داده مقصد موجود را رونویسی کند. در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه داده مقصد از قبل وجود داشته باشد، gdal با خطا متوقف می‌شود.

این برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا کد غیر صفر را بازمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار صادر می‌شوند، به منزله اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).

$ gdal raster select --band 3,2,1 bgr.tif rgb.tif --overwrite

$ gdal raster select --band red,green,blue input.tif rgb.tif --overwrite

$ gdal raster select --band 1,2,3 --mask 4 --co COMPRESS=JPEG,PHOTOMETRIC=YCBCR rgba.tif rgb_mask.tif

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026