GDAL-RASTER-PANSHARPEN(1) GDAL GDAL-RASTER-PANSHARPEN(1)

gdal-raster-pansharpen - انجام عملیات پان‌شارپ کردن (Pan-sharpening)

افزوده شده در نسخه 3.12.

Usage: gdal raster pansharpen [OPTIONS] <INPUT> <SPECTRAL>... <OUTPUT>
Perform a pansharpen operation.
Positional arguments:
  -i, --panchromatic, --input <INPUT>                      Input panchromatic raster dataset [required] [not available in pipelines]
  --spectral <SPECTRAL>                                    Input spectral band dataset [1.. values] [required]
  -o, --output <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 <KEY>=<VALUE>                                   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>      Output format ("GDALG" allowed) [not available in pipelines]
  --co, --creation-option <KEY>=<VALUE>                    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
  -r, --resampling <RESAMPLING>                            Resampling algorithm. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average (default: cubic)
  --weights <WEIGHTS>                                      Weight for each input spectral band [may be repeated]
  --nodata <NODATA>                                        Override nodata value of input bands
  --bit-depth <BIT-DEPTH>                                  Override bit depth of input bands
  --spatial-extent-adjustment <SPATIAL-EXTENT-ADJUSTMENT>  Select behavior when bands have not the same extent. SPATIAL-EXTENT-ADJUSTMENT=union|intersection|none|none-without-warning (default: union)
  -j, --num-threads <NUM-THREADS>                          Number of jobs (or ALL_CPUS) (default: ALL_CPUS)
Advanced Options:
  --if, --input-format <INPUT-FORMAT>                      Input formats [may be repeated] [not available in pipelines]
  --oo, --open-option <KEY>=<VALUE>                        Open options [may be repeated] [not available in pipelines]

دستور gdal raster pansharpen عملیات پان‌شارپ‌سازی (pan-sharpening یا افزایش تفکیک‌پذیری مکانی با استفاده از باند پانکروماتیک) را انجام می‌دهد. این ابزار می‌تواند یک مجموعه داده خروجی «کلاسیک» (مانند GeoTIFF) یا یک مجموعه داده VRT توصیف‌کننده عملیات پان‌شارپ‌سازی ایجاد کند.

این دستور به عنوان ورودی یک مجموعه داده تک‌باند پانکروماتیک و چندین باند طیفی دریافت می‌کند که معمولاً دارای تفکیک‌پذیری مکانی پایین‌تری نسبت به باند پانکروماتیک هستند. خروجی یک مجموعه داده چندبانده است (با همان تعداد باندهای طیفی ورودی) که وضوح تفکیک آن تا سطح وضوح باند پانکروماتیک ارتقا یافته است.

تمامی باندها باید در یک سیستم مرجع مختصات (CRS) یکسان باشند.

جزئیات بیشتر را می‌توان در بخش Pansharpened VRT یافت.

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

عمق بیتی باندهای پانکروماتیک و طیفی را مشخص می‌کند (مثلاً 12). در صورت عدم تعیین، در صورت وجود، از آیتم متادیتای NBITS باند پانکروماتیک استفاده خواهد شد.
مجموعه داده دارای باند پانکروماتیک. [الزامی]
تعداد رشته‌ها (threads) برای انجام بازنمونه‌برداری و خود عملیات پان‌شارپ‌سازی را مشخص می‌کند. می‌تواند یک عدد صحیح یا ALL_CPUS (پیش‌فرض) باشد.
مقدار nodata را برای باندها مشخص می‌کند. برای محاسبات بازنمونه‌برداری و خود پان‌شارپ‌سازی استفاده می‌شود. در صورت عدم تنظیم، از باندهای ورودی استنتاج می‌شود، مشروط بر اینکه تنظیمات سازگاری داشته باشند.
یک الگوریتم بازنمونه‌برداری را انتخاب می‌کند. cubic مقدار پیش‌فرض است.
رفتار برنامه را در زمانی که باندها محدوده مکانی یکسانی ندارند تعیین می‌کند. مستندات SpatialExtentAdjustment در Pansharpened VRT را ببینید. union مقدار پیش‌فرض است.
مجموعه داده شامل یک یا چند باند طیفی. [الزامی]

اگر گزینه band مشخص نشود، تمامی باندهای مجموعه داده لحاظ می‌شوند. در غیر این صورت، تنها باند (num) مشخص‌شده در نظر گرفته می‌شود. یک مجموعه داده یکسان را می‌توان چندین بار تکرار کرد.

وزنی را برای محاسبه مقدار شبه پانکروماتیک مشخص می‌کند. تعداد مقادیر باید دقیقاً برابر با تعداد باندهای طیفی ورودی باشد.

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

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

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

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

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

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

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

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

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

gdal raster pansharpen panchro.tif rgb.tif pansharpened_out.tif

gdal raster pansharpen panchro.tif bgr.tif,band=3 bgr.tif,band=2 bgr.tif,band=1 pansharpened_out.tif

gdal raster pansharpen panchro.tif red.tif green.tif blue.tif pansharpened_out.tif

gdal raster pansharpen -w 0.7,0.2,0.1 panchro.tif multispectral.tif pansharpened_out.tif

gdal raster pipeline read panchro.tif ! pansharpen rgbnir.tif ! select 1,2,3 ! write pansharpened_out.tif

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026