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

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

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


خلاصه دستور (SYNOPSIS)

          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]

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

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

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

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

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

گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)

       --bit-depth <val>
              عمق بیتی باندهای پانکروماتیک و طیفی را مشخص می‌کند (مثلاً 12). در
              صورت عدم تعیین، در صورت وجود، از آیتم متادیتای NBITS باند
              پانکروماتیک استفاده خواهد شد.

       -i, --panchromatic, --input <INPUT>
              مجموعه داده دارای باند پانکروماتیک. [الزامی]

       -j, --num-threads <value>
              تعداد رشته‌ها (threads) برای انجام بازنمونه‌برداری و خود عملیات
              پان‌شارپ‌سازی را مشخص می‌کند. می‌تواند یک عدد صحیح یا ALL_CPUS
              (پیش‌فرض) باشد.

       --nodata <val>
              مقدار nodata را برای باندها مشخص می‌کند. برای محاسبات
              بازنمونه‌برداری و خود پان‌شارپ‌سازی استفاده می‌شود. در صورت عدم
              تنظیم، از باندهای ورودی استنتاج می‌شود، مشروط بر اینکه تنظیمات
              سازگاری داشته باشند.

       -r, --resampling nearest|bilinear|cubic|cubicspline|lanczos|average
              یک الگوریتم بازنمونه‌برداری را انتخاب می‌کند.  cubic مقدار پیش‌فرض
              است.

       --spatial-extent-adjustment
       union|intersection|none|none-without-warning
              رفتار برنامه را در زمانی که باندها محدوده مکانی یکسانی ندارند
              تعیین می‌کند. مستندات SpatialExtentAdjustment در Pansharpened VRT
              را ببینید.  union مقدار پیش‌فرض است.

       --spectral <spectral_dataset>[,band=<num>]
              مجموعه داده شامل یک یا چند باند طیفی. [الزامی]

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

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

گزینه‌های استاندارد (STANDARD OPTIONS)

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

       --co, --creation-option <NAME>=<VALUE>
              بسیاری از فرمت‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توان از
              آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. برای نمونه،
              درایور GeoTIFF از گزینه‌های ساختی برای کنترل فشرده‌سازی و تعیین
              کاشی‌بندی (tiled) بودن فایل پشتیبانی می‌کند.

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

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

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

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

       --oo, --open-option <NAME>=<VALUE>
              گزینه باز کردن مجموعه داده (مختص فرمت).

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

       -f, --of, --format, --output-format <OUTPUT-FORMAT>
              فرمت رستر خروجی که باید استفاده شود. مقادیر مجاز را می‌توان با
              دستور زیر به دست آورد: gdal --formats | grep raster | grep rw |
              sort

       --overwrite
              به برنامه اجازه می‌دهد تا فایل یا مجموعه داده مقصد موجود را
              بازنویسی کند. در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه
              داده مقصد از قبل وجود داشته باشد، gdal با خطا متوقف می‌شود.

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

مثال‌ها (EXAMPLES)
   مثال ۱: با باندهای طیفی در یک مجموعه داده واحد

          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

   مثال ۵: انتخاب باندهای RGB از یک مجموعه داده چندطیفی RGBNir در حین محاسبه
       شدت شبه پانکروماتیک روی ۴ باند RGBNir

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

نویسنده (AUTHOR)
       Even Rouault <even.rouault@spatialys.com>

حق نشر (COPYRIGHT)
       1998-2026

                                August 18, 2026      GDAL-RASTER-PANSHARPEN(1)