نام (NAME)

gdal_polygonize - تولید یک لایه عارضه چندضلعی از یک رستر

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

gdal_polygonize [--help] [--help-general]
                   [-8] [-o <name>=<value>]... [-nomask]
                   [-mask <filename>] <raster_file> [-b <band>]
                   [-q] [-f <ogr_format>] [-lco <name>=<value>]...
                   [-overwrite] <out_file> [<layer>] [<fieldname>]

توضیحات (DESCRIPTION)

این ابزار برای تمام نواحی متصل پیکسل‌ها در رستر که مقدار پیکسلی یکسانی دارند، چندضلعی‌های (polygon) برداری ایجاد می‌کند. هر چندضلعی با یک مشخصه (attribute) ایجاد می‌شود که مقدار پیکسل مربوط به آن را نشان می‌دهد. همچنین می‌توان یک ماسک رستری مشخص کرد تا معلوم شود کدام پیکسل‌ها واجد شرایط پردازش هستند.

این ابزار در صورتی که منبع داده برداری خروجی وجود نداشته باشد آن را ایجاد می‌کند، در غیر این صورت تلاش خواهد کرد داده‌ها را به منبع موجود الحاق (append) کند.

این ابزار بر پایه تابع :GDALPolygonize() پیاده‌سازی شده که حاوی جزئیات بیشتری درباره الگوریتم است.

نکته:

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

راهنمایی:

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

دستور gdal raster polygonize را ببینید.

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

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

-8: استفاده از همبندی ۸-گانه. پیش‌فرض همبندی ۴-گانه است.

-nomask: عدم استفاده از ماسک اعتبار پیش‌فرض برای باند ورودی (مانند ماسک‌های nodata یا alpha).

-mask <filename>: استفاده از اولین باند فایل مشخص‌شده به عنوان ماسک اعتبار (صفر نامعتبر، و غیرصفر معتبر است). در صورت عدم تعیین، ماسک اعتبار پیش‌فرض برای باند ورودی (مانند ماسک‌های nodata یا alpha) استفاده خواهد شد (مگر اینکه -nomask تعیین شده باشد).

<raster_file>: فایل رستری مبدأ که چندضلعی‌ها از آن استخراج می‌شوند.

-b <band>: باندی در <raster_file> که چندضلعی‌ها از آن ساخته می‌شوند. این مقدار همچنین می‌تواند برابر با "mask" قرار گیرد تا نشان دهد که باید از باند ماسکِ باند اول استفاده شود (یا "mask,band_number" برای ماسک باندی خاص).

-f <ogr_format>: انتخاب قالب خروجی. در صورت عدم تعیین، قالب از روی پسوند فایل حدس زده می‌شود. از نام کوتاه قالب استفاده کنید.

-o <NAME>=<VALUE>: در نسخه 3.7 اضافه شد.
گزینه چندضلعی‌سازی (Polygonize). به مستندات :GDALPolygonize() مراجعه کنید.

-lco <NAME>=<VALUE>: در نسخه 3.7 اضافه شد.
گزینه ایجاد لایه (وابسته به قالب انتخابی).

-overwrite: در نسخه 3.8 اضافه شد.
بازنویسی لایه خروجی در صورتی که از قبل وجود داشته باشد.

<out_file>: فایل برداری مقصد که چندضلعی‌ها در آن نوشته خواهند شد.

<layer>: نام لایه ایجادشده برای نگهداری عارضه‌های چندضلعی.

<fieldname>: نام فیلدی که باید ایجاد شود (پیش‌فرض "DN" است).

-q: اجرای اسکریپت در حالت بی‌صدا. نمایش پیشرفت متوقف شده و پیام‌های معمول نمایش داده نمی‌شوند.

وضعیت خروج (EXIT STATUS)

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

نویسندگان (AUTHORS)

Frank Warmerdam <warmerdam@pobox.com>

کپی‌رایت و تکثیر (COPYRIGHT)

1998-2026

August 18, 2026