| 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 |