GDAL-RASTER-SIEVE(1) GDAL GDAL-RASTER-SIEVE(1)

gdal-raster-sieve - حذف چندضلعی‌های کوچک رستر

در نسخهٔ 3.11 اضافه شد.

Usage: gdal raster sieve [OPTIONS] <INPUT> <OUTPUT>
Remove small polygons from a raster dataset.
Positional arguments:
  -i, --input <INPUT>                                  Input raster datasets [required] [not available in pipelines]
  -o, --output <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 <KEY>=<VALUE>                               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>  Output format ("GDALG" allowed) [not available in pipelines]
  --co, --creation-option <KEY>=<VALUE>                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
  --mask <MASK>                                        Use the first band of the specified file as a validity mask (all pixels with a value other than zero will be considered suitable for inclusion in polygons)
  -b, --band <BAND>                                    Input band (1-based index)
  -s, --size-threshold <SIZE-THRESHOLD>                Minimum size of polygons to keep (default: 2)
  -c, --connect-diagonal-pixels                        Consider diagonal pixels as connected
Advanced Options:
  --if, --input-format <INPUT-FORMAT>                  Input formats [may be repeated] [not available in pipelines]
  --oo, --open-option <KEY>=<VALUE>                    Open options [may be repeated] [not available in pipelines]

دستور gdal raster sieve چندضلعی‌های رستری کوچک‌تر از یک اندازهٔ آستانهٔ مشخص‌شده (برحسب پیکسل) را حذف کرده و آن‌ها را با مقدار پیکسل بزرگ‌ترین چندضلعی همسایه جایگزین می‌کند.

مجموعه‌داده ورودی به‌صورت داده‌های عدد صحیح (integer) خوانده می‌شود، به این معنی که مقادیر ممیز شناور (floating point) به اعداد صحیح گرد می‌شوند. تغییر مقیاس (re-scaling) داده‌های مبدأ ممکن است در برخی موارد ضروری باشد (به‌عنوان مثال، داده‌های ۳۲ بیتی ممیز شناور با min=0 و max=1).

این زیردستور همچنین به‌عنوان یک مرحلهٔ بالقوه از gdal raster pipeline در دسترس است (از نسخهٔ GDAL 3.12 به بعد).

در نسخهٔ 3.12 اضافه شد.

این برنامه از سریال‌سازی خط فرمان در قالب یک فایل JSON با استفاده از قالب خروجی GDALG پشتیبانی می‌کند. سپس می‌توان فایل حاصل را با استفاده از درایور GDALG: GDAL Streamed Algorithm به‌عنوان یک مجموعه‌داده رستر باز کرد و خط لولهٔ مشخص‌شده را به‌صورت در لحظه (on-the-fly) / جاری‌شده (streamed) اعمال نمود.

نکته:

با این حال این الگوریتم به‌صورت بومی با حالت جریانی سازگار نیست. در نتیجه، یک مجموعه‌داده موقت تولید خواهد شد که ممکن است زمان پردازش قابل‌توجهی را هنگام باز کردن ایجاد کند.

باند ورودی (اندیس با پایهٔ ۱)
پیکسل‌های مورب (پیکسل‌های واقع در گوشه‌ها) را متصل در نظر می‌گیرد. رفتار پیش‌فرض تنها متصل در نظر گرفتن پیکسل‌هایی است که با لبه‌ها در تماس هستند که معادل اتصال ۴گانه (4-connectivity) است. هنگامی که این گزینه انتخاب شود، الگوریتم پیکسل‌های گوشه را نیز متصل در نظر خواهد گرفت که معادل اتصال ۸گانه (8-connectivity) است.
از نخستین باند فایل مشخص‌شده به‌عنوان ماسک اعتبارسنجی استفاده می‌کند: تمام پیکسل‌های موجود در باند ماسک با مقداری غیر از صفر، برای گنجانده شدن در چندضلعی‌ها مناسب در نظر گرفته می‌شوند.
حداقل اندازهٔ چندضلعی‌ها برای نگه‌داری (پیش‌فرض: 2)

رستر ورودی را به‌عنوان یک زیرمجموعه‌دادهٔ جدید به یک فایل خروجی موجود الحاق می‌کند. تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده‌ها پشتیبانی می‌کنند، مانند GTiff -- GeoTIFF File Format و GPKG -- GeoPackage raster. همچنین در صورتی که مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.
بسیاری از قالب‌ها یک یا چند گزینهٔ اختیاری ساخت دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. به‌عنوان مثال، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و کاشی‌بندی شدن فایل پشتیبانی می‌کند.

می‌تواند تکرار شود.

گزینه‌های ساخت موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینهٔ ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینهٔ خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان قالب، منبع قطعی اطلاعات دربارهٔ گزینه‌های ساخت درایور است. برای مشاهدهٔ گزینه‌های ساخت مجاز برای هر قالب، به مستندات اختصاصی قالب‌های Raster drivers مراجعه کنید.

نام قالب/درایور برای تلاش جهت باز کردن فایل(های) ورودی. به‌طور کلی نیازی به مشخص کردن آن نیست، اما می‌توان از آن برای نادیده گرفتن تشخیص خودکار درایور، در مواقعی که در انتخاب درایور مناسب ناموفق است، استفاده کرد. این گزینه را می‌توان چندین بار برای تعیین چندین درایور کاندید تکرار کرد. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند. به‌ویژه، برخی از درایورها نیازمندی‌هایی برای پسوند فایل دارند.

می‌تواند تکرار شود.

گزینهٔ باز کردن مجموعه‌داده (مخصوص قالب).

می‌تواند تکرار شود.

کدام قالب رستر خروجی استفاده شود. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: gdal --formats | grep raster | grep rw | sort
به برنامه اجازه می‌دهد فایل یا مجموعه‌دادهٔ هدفِ موجود را بازنویسی کند. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌دادهٔ هدف از قبل وجود داشته باشد، gdal با خطا متوقف می‌شود.

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

$ gdal raster sieve -b 2 -s 10 input.tif output.tif

Alessandro Pasotti <elpaso@itopen.it>

1998-2026

August 18, 2026