.\" Man page generated from reStructuredText. . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "GDAL-RASTER-PANSHARPEN" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-pansharpen \- انجام عملیات پان‌شارپ کردن (Pan-sharpening) .sp افزوده شده در نسخه 3.12. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster pansharpen [OPTIONS] ... Perform a pansharpen operation. Positional arguments: \-i, \-\-panchromatic, \-\-input Input panchromatic raster dataset [required] [not available in pipelines] \-\-spectral Input spectral band dataset [1.. values] [required] \-o, \-\-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 = 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 (\(dqGDALG\(dq allowed) [not available in pipelines] \-\-co, \-\-creation\-option = 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 algorithm. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average (default: cubic) \-\-weights Weight for each input spectral band [may be repeated] \-\-nodata Override nodata value of input bands \-\-bit\-depth Override bit depth of input bands \-\-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 Number of jobs (or ALL_CPUS) (default: ALL_CPUS) Advanced Options: \-\-if, \-\-input\-format Input formats [may be repeated] [not available in pipelines] \-\-oo, \-\-open\-option = Open options [may be repeated] [not available in pipelines] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور .B gdal raster pansharpen عملیات پان‌شارپ‌سازی (pan\-sharpening یا افزایش تفکیک‌پذیری مکانی با استفاده از باند پانکروماتیک) را انجام می‌دهد. این ابزار می‌تواند یک مجموعه داده خروجی «کلاسیک» (مانند GeoTIFF) یا یک مجموعه داده VRT توصیف‌کننده عملیات پان‌شارپ‌سازی ایجاد کند. .sp این دستور به عنوان ورودی یک مجموعه داده تک‌باند پانکروماتیک و چندین باند طیفی دریافت می‌کند که معمولاً دارای تفکیک‌پذیری مکانی پایین‌تری نسبت به باند پانکروماتیک هستند. خروجی یک مجموعه داده چندبانده است (با همان تعداد باندهای طیفی ورودی) که وضوح تفکیک آن تا سطح وضوح باند پانکروماتیک ارتقا یافته است. .sp تمامی باندها باید در یک سیستم مرجع مختصات (CRS) یکسان باشند. .sp جزئیات بیشتر را می‌توان در بخش .I \%Pansharpened VRT یافت. .SH "خروجی GDALG (مجموعه داده‌های پردازش درلحظه / جریانی) (GDALG OUTPUT)" .sp این برنامه از سریال‌سازی خط فرمان به صورت یک فایل JSON با استفاده از فرمت خروجی .B GDALG پشتیبانی می‌کند. فایل حاصل را می‌توان سپس به عنوان یک مجموعه داده رستری با استفاده از درایور .I \%GDALG: GDAL Streamed Algorithm باز کرد و پایپ‌لاین مشخص‌شده را به صورت بلادرنگ / جریانی (on\-the\-fly / streamed) اعمال نمود. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-bit\-depth عمق بیتی باندهای پانکروماتیک و طیفی را مشخص می‌کند (مثلاً 12). در صورت عدم تعیین، در صورت وجود، از آیتم متادیتای NBITS باند پانکروماتیک استفاده خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-i, \-\-panchromatic, \-\-input مجموعه داده دارای باند پانکروماتیک. [الزامی] .UNINDENT .INDENT 0.0 .TP .B \-j, \-\-num\-threads تعداد رشته‌ها (threads) برای انجام بازنمونه‌برداری و خود عملیات پان‌شارپ‌سازی را مشخص می‌کند. می‌تواند یک عدد صحیح یا .B ALL_CPUS (پیش‌فرض) باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-nodata مقدار nodata را برای باندها مشخص می‌کند. برای محاسبات بازنمونه‌برداری و خود پان‌شارپ‌سازی استفاده می‌شود. در صورت عدم تنظیم، از باندهای ورودی استنتاج می‌شود، مشروط بر اینکه تنظیمات سازگاری داشته باشند. .UNINDENT .INDENT 0.0 .TP .B \-r, \-\-resampling nearest|bilinear|cubic|cubicspline|lanczos|average یک الگوریتم بازنمونه‌برداری را انتخاب می‌کند. .B cubic مقدار پیش‌فرض است. .UNINDENT .INDENT 0.0 .TP .B \-\-spatial\-extent\-adjustment union|intersection|none|none\-without\-warning رفتار برنامه را در زمانی که باندها محدوده مکانی یکسانی ندارند تعیین می‌کند. مستندات .I SpatialExtentAdjustment در .I \%Pansharpened VRT را ببینید. .B union مقدار پیش‌فرض است. .UNINDENT .INDENT 0.0 .TP .B \-\-spectral [,band=] مجموعه داده شامل یک یا چند باند طیفی. [الزامی] .sp اگر گزینه band مشخص نشود، تمامی باندهای مجموعه داده لحاظ می‌شوند. در غیر این صورت، تنها باند (num) مشخص‌شده در نظر گرفته می‌شود. یک مجموعه داده یکسان را می‌توان چندین بار تکرار کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-weights وزنی را برای محاسبه مقدار شبه پانکروماتیک مشخص می‌کند. تعداد مقادیر باید دقیقاً برابر با تعداد باندهای طیفی ورودی باشد. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-append رستر ورودی را به عنوان یک زیرمجموعه‌داده (subdataset) جدید به فایل خروجی موجود الحاق می‌کند. تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده پشتیبانی می‌کنند، مانند .I \%GTiff \-\- GeoTIFF File Format و .I \%GPKG \-\- GeoPackage raster همچنین در صورتی که مجموعه داده خروجی از قبل وجود نداشته باشد، آن را ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از فرمت‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoTIFF از گزینه‌های ساختی برای کنترل فشرده‌سازی و تعیین کاشی‌بندی (tiled) بودن فایل پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت موجود بسته به درایور فرمت متفاوت هستند و برخی فرمت‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان .I \%\-\-formats مشاهده کرد، اما مستندات خود فرمت مرجع نهایی اطلاعات مربوط به گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر فرمت، مستندات اختصاصی .I \%Raster drivers را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام فرمت/درایور برای تلاش در باز کردن فایل(های) ورودی. معمولاً نیازی به تعیین آن نیست، اما می‌توان از آن برای چشم‌پوشی از تشخیص خودکار درایور در مواقعی که درایور مناسب انتخاب نمی‌شود استفاده کرد. این گزینه می‌تواند چندین بار برای تعیین چندین درایور نامزد تکرار شود. توجه داشته باشید که این گزینه درایورها را مجبور به باز کردن مجموعه داده نمی‌کند؛ به‌ویژه برخی درایورها نیازمندی‌هایی برای پسوند فایل دارند. .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه داده (مختص فرمت). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format فرمت رستر خروجی که باید استفاده شود. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: .B gdal \-\-formats | grep raster | grep rw | sort .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite به برنامه اجازه می‌دهد تا فایل یا مجموعه داده مقصد موجود را بازنویسی کند. در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه داده مقصد از قبل وجود داشته باشد، .B gdal با خطا متوقف می‌شود. .UNINDENT .SH "کدهای وضعیت بازگشتی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار صادر می‌شوند به عنوان اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: با باندهای طیفی در یک مجموعه داده واحد" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster pansharpen panchro.tif rgb.tif pansharpened_out.tif .EE .UNINDENT .UNINDENT .SS "مثال ۲: با چند باند طیفی از یک مجموعه داده واحد با تغییر ترتیب آن‌ها" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster pansharpen panchro.tif bgr.tif,band=3 bgr.tif,band=2 bgr.tif,band=1 pansharpened_out.tif .EE .UNINDENT .UNINDENT .SS "مثال ۳: با باندهای طیفی در چندین مجموعه داده" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster pansharpen panchro.tif red.tif green.tif blue.tif pansharpened_out.tif .EE .UNINDENT .UNINDENT .SS "مثال ۴: مشخص کردن وزن‌ها" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster pansharpen \-w 0.7,0.2,0.1 panchro.tif multispectral.tif pansharpened_out.tif .EE .UNINDENT .UNINDENT .SS "مثال ۵: انتخاب باندهای RGB از یک مجموعه داده چندطیفی RGBNir در حین محاسبه شدت شبه پانکروماتیک روی ۴ باند RGBNir" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster pipeline read panchro.tif ! pansharpen rgbnir.tif ! select 1,2,3 ! write pansharpened_out.tif .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .