نام (NAME)

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

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

gdal_proximity [--help] [--help-general]
                  <srcfile> <dstfile> [-srcband <n>] [-dstband <n>]
                  [-of <format>] [-co <name>=<value>]...
                  [-ot Byte/UInt16/UInt32/Float32/etc]
                  [-values <n>,<n>,<n>] [-distunits {PIXEL|GEO}]
                  [-maxdist <n>] [-nodata <n>] [-use_input_nodata {YES|NO}]
                  [-fixed-buf-val <n>]

توضیحات (DESCRIPTION)

دستور gdal_proximity یک نقشه مجاورت رستر تولید می‌کند که فاصله از مرکز هر پیکسل تا مرکز نزدیک‌ترین پیکسل شناسایی‌شده به عنوان پیکسل هدف را نشان می‌دهد. پیکسل‌های هدف آن‌هایی در رستر مبدأ هستند که مقدار پیکسل رستر برای آن‌ها در مجموعه مقادیر پیکسل هدف قرار دارد.

نکته:

ابزار gdal_proximity یک ابزار پایتون است و تنها در صورتی که بایندرهای پایتون GDAL موجود باشند در دسترس خواهد بود.

نکته کاربردی:

معادل در رابط خط فرمان جدید "gdal":

به gdal raster proximity مراجعه کنید.

گزینه‌ها (OPTIONS)

--help: نمایش پیام راهنما و خروج

--help-general: ارائه پیام استفاده مختصر برای گزینه‌های عمومی خط فرمان GDAL و خروج.

<srcfile>: فایل رستر مبدأ که برای شناسایی پیکسل‌های هدف استفاده می‌شود.

<dstfile>: فایل رستر مقصد که نقشه مجاورت در آن نوشته خواهد شد. این فایل می‌تواند یک فایل از پیش موجود با همان اندازه srcfile باشد. اگر وجود نداشته باشد، ایجاد خواهد شد.

-srcband <n>: باند مورد استفاده در فایل مبدأ را مشخص می‌کند (پیش‌فرض 1 است).

-dstband <n>: باند مورد استفاده در فایل مقصد را مشخص می‌کند (پیش‌فرض 1 است).

-of <format>: فرمت خروجی را انتخاب می‌کند. اگر مشخص نشود، فرمت از روی پسوند حدس زده می‌شود. از نام کوتاه فرمت استفاده کنید.

-co <NAME>=<VALUE>: بسیاری از فرمت‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. برای مثال، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و این‌که آیا فایل باید کاشی‌بندی (tiled) شود، پشتیبانی می‌کند.
گزینه‌های ساخت موجود بسته به درایور فرمت متفاوت است و برخی از فرمت‌های ساده هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان --format مشاهده کرد، اما مستندات خود فرمت، مرجع قطعی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر فرمت به مستندات اختصاصی Raster drivers مراجعه کنید.

-ot <type>: نوع داده پشتیبانی‌شده توسط درایور را مشخص می‌کند که می‌تواند یکی از موارد زیر باشد: Byte، UInt16، Int16، UInt32، Int32، Float32 (پیش‌فرض)، یا Float64.

-values <n>,<n>,<n>: فهرستی از مقادیر پیکسل هدف در تصویر مبدأ که باید به عنوان پیکسل هدف در نظر گرفته شوند. اگر مشخص نشود، تمام پیکسل‌های غیرصفر به عنوان پیکسل‌های هدف در نظر گرفته خواهند شد.

-distunits {PIXEL|GEO}: مشخص می‌کند که آیا فواصل تولیدشده باید بر حسب پیکسل باشند یا مختصات زمین‌مرجع (پیش‌فرض PIXEL است).

-maxdist <n>: حداکثر فاصله‌ای که باید تولید شود. مقدار nodata برای پیکسل‌های فراتر از این فاصله استفاده خواهد شد. اگر مقدار nodata ارائه نشود، مقدار nodata باند خروجی پرس‌وجو می‌شود. اگر باند خروجی مقدار nodata نداشته باشد، مقدار 65535 استفاده خواهد شد. فاصله بر حسب پیکسل تفسیر می‌شود مگر اینکه -distunits GEO مشخص شده باشد.

-nodata <n>: یک مقدار nodata را برای استفاده در رستر مجاورت مقصد مشخص می‌کند.

-use_input_nodata {YES|NO}: مشخص می‌کند که آیا پیکسل‌های nodata در رستر ورودی باید در رستر خروجی نیز nodata باشند یا خیر (پیش‌فرض NO است).

-fixed-buf-val <n>: مقداری را برای اعمال به تمام پیکسل‌هایی که در محدوده -maxdist از پیکسل‌های هدف قرار دارند (شامل خود پیکسل‌های هدف) به جای مقدار فاصله مشخص می‌کند.

کد وضعیت بازگشتی (RETURN STATUS CODE)

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

نویسنده (AUTHOR)

Frank Warmerdam <warmerdam@pobox.com>

حق نشر (COPYRIGHT)

1998-2026

August 18, 2026