.\" 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-PROXIMITY" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-raster-proximity \- تولید نقشه مجاورت رستر
.sp
افزوده شده در نسخه 3.12.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
کاربرد: gdal raster proximity [گزینه‌ها] <INPUT> <OUTPUT>

تولید نقشه مجاورت رستر.

آرگومان‌های موضعی:
  \-i, \-\-input <INPUT>                                      مجموعه‌داده‌های رستر ورودی [الزامی] [در خطوط لوله در دسترس نیست]
  \-o, \-\-output <OUTPUT>                                    مجموعه‌داده رستر خروجی [الزامی] [در خطوط لوله در دسترس نیست]

گزینه‌های عمومی:
  \-h, \-\-help                                               نمایش پیام راهنما و خروج
  \-\-json\-usage                                             نمایش شیوه استفاده به صورت سند JSON و خروج
  \-\-config <KEY>=<VALUE>                                   گزینه پیکربندی [تکرارپذیر]
  \-q, \-\-quiet                                              حالت بی‌صدا (عدم نمایش نوار پیشرفت یا پیام‌های هشدار) [در خطوط لوله در دسترس نیست]

گزینه‌ها:
  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>      قالب خروجی (مقدار \(dqGDALG\(dq مجاز است) [در خطوط لوله در دسترس نیست]
  \-\-co, \-\-creation\-option <KEY>=<VALUE>                    گزینه ایجاد مجموعه‌داده [تکرارپذیر] [در خطوط لوله در دسترس نیست]
  \-\-overwrite                                              آیا رونویسی روی مجموعه‌داده خروجی موجود مجاز است [در خطوط لوله در دسترس نیست]
                                                           ناسازگار با \-\-append
  \-\-append                                                 الحاق به عنوان زیرمجموعه‌داده به خروجی موجود [در خطوط لوله در دسترس نیست]
                                                           ناسازگار با \-\-overwrite
  \-\-ot, \-\-datatype, \-\-output\-data\-type <OUTPUT\-DATA\-TYPE>  نوع داده خروجی. OUTPUT\-DATA\-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64|Byte|UInt16|Int16|UInt32|Int32|Float32|Float64 (پیش‌فرض: Float32)
  \-b, \-\-band <BAND>                                        باند ورودی (اندیس مبتنی بر 1)
  \-\-target\-values <TARGET\-VALUES>                          مقادیر پیکسل هدف [تکرارپذیر]
  \-\-distance\-units <DISTANCE\-UNITS>                        واحدهای فاصله. DISTANCE\-UNITS=pixel|geo (پیش‌فرض: pixel)
  \-\-max\-distance <MAX\-DISTANCE>                            حداکثر فاصله. مقدار nodata برای پیکسل‌های فراتر از این فاصله استفاده خواهد شد (پیش‌فرض: 0)
  \-\-fixed\-value <FIXED\-VALUE>                              مقدار ثابت برای پیکسل‌هایی که در محدوده حداکثر فاصله هستند (به جای فاصله واقعی) (پیش‌فرض: 0)
  \-\-nodata <NODATA>                                        تعیین مقدار nodata برای پیکسل‌هایی که فراتر از حداکثر فاصله هستند

گزینه‌های پیشرفته:
  \-\-if, \-\-input\-format <INPUT\-FORMAT>                      قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست]
  \-\-oo, \-\-open\-option <KEY>=<VALUE>                        گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal raster proximity\fP یک نقشه مجاورت رستر تولید می‌کند که فاصله دکارتی از مرکز هر پیکسل
تا مرکز نزدیک‌ترین پیکسل شناسایی‌شده به عنوان پیکسل هدف را نشان می‌دهد.
پیکسل‌های هدف آن‌هایی در رستر مبدأ هستند که مقدار پیکسل رستر برای آن‌ها در مجموعه مقادیر پیکسل هدف قرار دارد.
.sp
این زیردستور همچنین به عنوان یک مرحله بالقوه از \fI\%gdal raster pipeline\fP در دسترس است.
.sp
افزوده شده در نسخه 3.12.
.SH "خروجی GDALG (مجموعه‌داده درجا / جریانی)"
.sp
این برنامه از سریال‌سازی خط فرمان به صورت یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند.
فایل حاصل می‌تواند با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP به عنوان یک مجموعه‌داده رستر باز شود
و خط لوله مشخص‌شده را به صورت درجا (On-the-fly) یا جریانی (Streamed) اعمال کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
با این حال این الگوریتم ذاتاً با پردازش جریانی سازگار نیست. در نتیجه یک مجموعه‌داده موقت
ایجاد خواهد شد که ممکن است زمان پردازش قابل‌توجهی را هنگام باز کردن به همراه داشته باشد.
.UNINDENT
.UNINDENT
.SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-b, \-\-band <BAND>
باند ورودی (اندیس مبتنی بر 1)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-distance\-units <pixel|geo>
واحدهای محاسبه فاصله. اگر \fIgeo\fP مشخص شود، فاصله بر حسب واحدهای زمین‌مرجع (متر یا درجه)
با استفاده از اندازه پیکسل رستر ورودی محاسبه خواهد شد.
در غیر این صورت، فاصله بر حسب پیکسل تفسیر می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-fixed\-value <FIXED\-VALUE>
تعیین یک مقدار ثابت برای نوشتن در پیکسل‌های خروجی که در محدوده \fI\%\-\-max\-distance\fP از
پیکسل‌های هدف قرار دارند، به جای فاصله واقعی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-max\-distance <MAX\-DISTANCE>
حداکثر فاصله برای جستجوی پیکسل هدف. اگر هیچ پیکسل هدفی در این فاصله یافت نشود، مقدار NoData خروجی داده خواهد شد.
فاصله بر حسب پیکسل تفسیر می‌شود مگر اینکه \fI\-\-distance\-units geo\fP مشخص شده باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-nodata <NODATA>
مقدار NoData برای رستر خروجی. در صورت عدم تعیین، مقدار NoData باند ورودی استفاده خواهد شد.
اگر باند خروجی مقدار NoData نداشته باشد، مقدار 65535 برای انواع خروجی ممیز شناور
و حداکثر مقدار قابل ذخیره‌سازی برای انواع خروجی عدد صحیح استفاده خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-target\-values <TARGET\-VALUES>
یک مقدار منفرد یا فهرستی جداشده با کاما از مقادیر پیکسل هدف در تصویر مبدأ
که باید به عنوان پیکسل‌های هدف در نظر گرفته شوند.
در صورت عدم تعیین، تمامی پیکسل‌های غیرصفر به عنوان پیکسل‌های هدف در نظر گرفته می‌شوند.
.UNINDENT
.SH "گزینه‌های استاندارد (STANDARD OPTIONS)"
.INDENT 0.0
.TP
.B \-\-append
الحاق رستر ورودی به عنوان یک زیرمجموعه‌داده جدید به فایل خروجی موجود.
فقط با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده پشتیبانی می‌کنند، مانند
\fI\%GTiff \-\- GeoTIFF File Format\fP و \fI\%GPKG \-\- GeoPackage raster\fP\&.
این گزینه همچنین در صورتی که مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-co, \-\-creation\-option <NAME>=<VALUE>
بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد دارند که می‌توان از آن‌ها
برای کنترل ویژگی‌های خاص فایل ایجادشده استفاده کرد. برای نمونه،
درایور GeoTIFF از گزینه‌های ایجاد برای کنترل فشرده‌سازی و تعیین اینکه آیا فایل
باید تایل‌بندی شود یا خیر پشتیبانی می‌کند.
.sp
می‌تواند تکرار شود.
.sp
گزینه‌های ایجاد موجود بسته به درایور قالب متفاوت است و برخی قالب‌های
ساده هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب
را می‌توان با گزینه خط فرمان
\fI\%\-\-formats\fP
مشاهده کرد، اما مستندات مربوط به همان قالب مرجع اصلی اطلاعات درباره گزینه‌های ایجاد درایور است.
برای گزینه‌های مجاز ایجاد هر قالب، به مستندات اختصاصی قالب در \fI\%Raster drivers\fP مراجعه کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-if, \-\-input\-format <format>
نام قالب/درایور برای تلاش جهت باز کردن فایل(های) ورودی. معمولاً نیازی به مشخص کردن
آن نیست، اما می‌توان از آن برای چشم‌پوشی از تشخیص خودکار درایور در مواردی که در انتخاب درایور مناسب
ناموفق است استفاده کرد.
این گزینه می‌تواند چندین بار تکرار شود تا چند درایور نامزد مشخص گردند.
توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند. به‌ویژه،
برخی درایورها نیازمندی‌هایی درباره پسوند فایل دارند.
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
گزینه باز کردن مجموعه‌داده (مختص هر قالب).
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
تعیین قالب رستر خروجی مورد استفاده. مقادیر مجاز را می‌توان با دستور زیر به دست آورد:
\fBgdal \-\-formats | grep raster | grep rw | sort\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-ot, \-\-datatype, \-\-output\-data\-type <OUTPUT\-DATA\-TYPE>
نوع داده خروجی از میان \fBByte\fP، \fBInt8\fP، \fBUInt16\fP، \fBInt16\fP، \fBUInt32\fP،
\fBInt32\fP، \fBUInt64\fP، \fBInt64\fP، \fBCInt16\fP، \fBCInt32\fP، \fBFloat32\fP،
\fBFloat64\fP، \fBCFloat32\fP، \fBCFloat64\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
اجازه دادن به برنامه برای رونویسی روی فایل یا مجموعه‌داده مقصد موجود.
در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه‌داده مقصد از قبل وجود داشته باشد،
\fBgdal\fP با خطا متوقف می‌شود.
.UNINDENT
.SH "کد وضعیت بازگشتی (RETURN STATUS CODE)"
.sp
برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند
(خطاهای غیرمسدودکننده که به صورت هشدار ارسال می‌شوند، به عنوان اجرای موفقیت‌آمیز
در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱
.INDENT 0.0
.TP
.B عنوان
نقشه مجاورت یک رستر با حداکثر فاصله ۳ پیکسل
.INDENT 7.0
.INDENT 3.5
.sp
.EX
$ gdal raster proximity \-\-max\-distance 3  input.tif output.tif
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Alessandro Pasotti <elpaso@itopen.it>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.