| GDAL_PANSHARPEN(1) | GDAL | GDAL_PANSHARPEN(1) |
نام (NAME)
gdal_pansharpen - اجرای عملیات پان‌شارپ‌سازی (پان‌شارپنینگ)
خلاصه دستور (SYNOPSIS)
gdal_pansharpen [--help] [--help-general]
<pan_dataset>
<spectral_dataset>[,band=<num>] [<spectral_dataset>[,band=<num>]]...
<out_dataset>
[-of <format>] [-b <band>]... [-w <weight_val>]...
[-r {nearest|bilinear|cubic|cubicspline|lanczos|average}]
[-threads {ALL_CPUS|<number>}] [-bitdepth <val>] [-nodata <val>]
[-spat_adjust {union|intersection|none|nonewithoutwarning}]
[-co <NAME>=<VALUE>]... [-q]
توضیحات (DESCRIPTION)
دستور gdal_pansharpen یک عملیات پان‌شارپ‌سازی (pan-sharpening) را اجرا می‌کند. این دستور می‌تواند یک مجموعه‌داده خروجی "کلاسیک" (مانند GeoTIFF) یا یک مجموعه‌داده VRT که عملیات پان‌شارپ‌سازی را توصیف می‌کند ایجاد نماید.
جزئیات بیشتر را می‌توان در بخش Pansharpened VRT یافت.
نکته:
نکته:
gdal raster pansharpen را ببینید.
- --help
- نمایش این پیام راهنما و خروج
- --help-general
- نمایش یک پیام کوتاه درباره نحوه استفاده از گزینه‌های عمومی خط فرمان GDAL و خروج.
- -of <format>
- انتخاب فرمت خروجی. در صورت عدم تعیین، فرمت از روی پسوند فایل حدس زده می‌شود. از نام کوتاه فرمت استفاده کنید. VRT نیز می‌تواند استفاده شود.
- -b <band>
- انتخاب باند band از باندهای طیفی ورودی برای خروجی. باندها از 1 به ترتیبی که باندهای طیفی مشخص شده‌اند شماره‌گذاری می‌شوند. چندین گزینه -b قابل استفاده است. در صورت عدم استفاده از گزینه -b، تمامی باندهای طیفی ورودی برای خروجی تنظیم می‌شوند.
- -w <weight_val>
- تعیین یک وزن برای محاسبه مقدار پانکروماتیک کاذب (pseudo panchromatic). باید به تعداد باندهای طیفی ورودی، گزینه -w وجود داشته باشد.
- -r {nearest|bilinear|cubic|cubicspline|lanczos|average}
- انتخاب الگوریتم بازنمونه‌برداری (resampling). پیش‌فرض cubic است.
- -threads {ALL_CPUS|<number>}
- تعیین تعداد رشته‌ها (threads) برای انجام بازنمونه‌برداری و خود پان‌شارپ‌سازی. می‌تواند یک عدد صحیح یا ALL_CPUS باشد.
- -bitdepth <val>
- تعیین عمق بیتی باندهای پانکروماتیک و طیفی (مثلاً 12). در صورت عدم تعیین، در صورت وجود، از آیتم متادیتای NBITS باند پانکروماتیک استفاده خواهد شد.
- -nodata <val>
- تعیین مقدار nodata برای باندها. برای محاسبات بازنمونه‌برداری و خود عملیات پان‌شارپ‌سازی استفاده می‌شود. در صورت عدم تنظیم، از باندهای ورودی استنتاج می‌شود، مشروط بر اینکه تنظیمات سازگاری داشته باشند.
- -spat_adjust {union|intersection|none|nonewithoutwarning}
- انتخاب رفتار هنگامی که باندها وسعت مکانی (extent) یکسانی ندارند. مستندات SpatialExtentAdjustment را در Pansharpened VRT ببینید. پیش‌فرض union است.
- -co <NAME>=<VALUE>
- بسیاری از
فرمت‌ها یک
یا چند
گزینه ساخت
اختیاری
دارند که
می‌توان از
آن‌ها برای
کنترل
جزئیات
فایل
ایجادشده
استفاده
کرد. برای
نمونه،
درایور GeoTIFF از
گزینه‌های
ساخت برای
کنترل
فشرده‌سازی
و تعیین
کاشی‌بندی
(tiled) بودن فایل
پشتیبانی
می‌کند.
گزینه‌های ساخت موجود بسته به درایور فرمت متفاوت هستند، و برخی فرمت‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان --format مشاهده کرد، اما مستندات خود فرمت مرجع نهایی اطلاعات مربوط به گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر فرمت، مستندات اختصاصی فرمت Raster drivers را ببینید.
- -q
- سرکوب نمایشگر پیشرفت و سایر خروجی‌های غیر از خطا.
- <pan_dataset>
- مجموعه‌داده دارای باند پانکروماتیک (باند اول استفاده خواهد شد).
- <spectral_dataset>[,band=<num>]
- مجموعه‌داده با یک یا چند باند طیفی. اگر گزینه band مشخص نشود، تمامی باندهای مجموعه‌داده در نظر گرفته می‌شوند. در غیر این صورت، تنها باند (num)ام مشخص‌شده در نظر گرفته می‌شود. همان مجموعه‌داده می‌تواند چندین بار تکرار شود.
- <out_dataset>
- مجموعه‌داده خروجی
باندها باید در سیستم تصویر (پروژکشن) یکسانی باشند.
کد وضعیت خروجی (RETURN STATUS CODE)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفق در نظر گرفته می‌شوند).
مثال‌ها (EXAMPLES)
مثال ۱: با باندهای طیفی در یک مجموعه‌داده منفرد
gdal_pansharpen panchro.tif multispectral.tif pansharpened_out.tif
مثال ۲: با چند باند طیفی از یک مجموعه‌داده منفرد، همراه با بازآرایی ترتیب
gdal_pansharpen panchro.tif multispectral.tif,band=3 multispectral.tif,band=2 multispectral.tif,band=1 pansharpened_out.tif
مثال ۳: با باندهای طیفی در چندین مجموعه‌داده
gdal_pansharpen panchro.tif band1.tif band2.tif band3.tif pansharpened_out.tif
مثال ۴: تعیین وزن‌ها
gdal_pansharpen -w 0.7 -w 0.2 -w 0.1 panchro.tif multispectral.tif pansharpened_out.tif
مثال ۵: تعیین باندهای RGB از یک مجموعه‌داده چندطیفی RGBNir همزمان با محاسبه شدت پانکروماتیک کاذب بر روی ۴ باند RGBNir
gdal_pansharpen -b 1 -b 2 -b 3 panchro.tif rgbnir.tif pansharpened_out.tif
نویسنده (AUTHOR)
Even Rouault <even.rouault@spatialys.com>
حق نشر (COPYRIGHT)
1998-2026
| August 18, 2026 |