GDAL-RASTER-SIEVE(1) GDAL GDAL-RASTER-SIEVE(1) نام (NAME) gdal-raster-sieve - حذف چندضلعی‌های کوچک رستر در نسخهٔ 3.11 اضافه شد. خلاصه دستور (SYNOPSIS) Usage: gdal raster sieve [OPTIONS] Remove small polygons from a raster dataset. Positional arguments: -i, --input Input raster datasets [required] [not available in pipelines] -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 ("GDALG" 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 --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 Input band (1-based index) -s, --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 formats [may be repeated] [not available in pipelines] --oo, --open-option = Open options [may be repeated] [not available in pipelines] توضیحات (DESCRIPTION) دستور gdal raster sieve چندضلعی‌های رستری کوچک‌تر از یک اندازهٔ آستانهٔ مشخص‌شده (برحسب پیکسل) را حذف کرده و آن‌ها را با مقدار پیکسل بزرگ‌ترین چندضلعی همسایه جایگزین می‌کند. مجموعه‌داده ورودی به‌صورت داده‌های عدد صحیح (integer) خوانده می‌شود، به این معنی که مقادیر ممیز شناور (floating point) به اعداد صحیح گرد می‌شوند. تغییر مقیاس (re-scaling) داده‌های مبدأ ممکن است در برخی موارد ضروری باشد (به‌عنوان مثال، داده‌های ۳۲ بیتی ممیز شناور با min=0 و max=1). این زیردستور همچنین به‌عنوان یک مرحلهٔ بالقوه از gdal raster pipeline در دسترس است (از نسخهٔ GDAL 3.12 به بعد). در نسخهٔ 3.12 اضافه شد. خروجی GDALG (مجموعه‌داده در لحظه / جاری‌شده) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET)) این برنامه از سریال‌سازی خط فرمان در قالب یک فایل JSON با استفاده از قالب خروجی GDALG پشتیبانی می‌کند. سپس می‌توان فایل حاصل را با استفاده از درایور GDALG: GDAL Streamed Algorithm به‌عنوان یک مجموعه‌داده رستر باز کرد و خط لولهٔ مشخص‌شده را به‌صورت در لحظه (on-the-fly) / جاری‌شده (streamed) اعمال نمود. نکته: با این حال این الگوریتم به‌صورت بومی با حالت جریانی سازگار نیست. در نتیجه، یک مجموعه‌داده موقت تولید خواهد شد که ممکن است زمان پردازش قابل‌توجهی را هنگام باز کردن ایجاد کند. گزینه‌های مختص برنامه (PROGRAM-SPECIFIC OPTIONS) -b, --band باند ورودی (اندیس با پایهٔ ۱) -c, --connect-diagonal-pixels پیکسل‌های مورب (پیکسل‌های واقع در گوشه‌ها) را متصل در نظر می‌گیرد. رفتار پیش‌فرض تنها متصل در نظر گرفتن پیکسل‌هایی است که با لبه‌ها در تماس هستند که معادل اتصال ۴گانه (4-connectivity) است. هنگامی که این گزینه انتخاب شود، الگوریتم پیکسل‌های گوشه را نیز متصل در نظر خواهد گرفت که معادل اتصال ۸گانه (8-connectivity) است. --mask از نخستین باند فایل مشخص‌شده به‌عنوان ماسک اعتبارسنجی استفاده می‌کند: تمام پیکسل‌های موجود در باند ماسک با مقداری غیر از صفر، برای گنجانده شدن در چندضلعی‌ها مناسب در نظر گرفته می‌شوند. -s, --size-threshold حداقل اندازهٔ چندضلعی‌ها برای نگه‌داری (پیش‌فرض: 2) گزینه‌های استاندارد (STANDARD OPTIONS) --append رستر ورودی را به‌عنوان یک زیرمجموعه‌دادهٔ جدید به یک فایل خروجی موجود الحاق می‌کند. تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده‌ها پشتیبانی می‌کنند، مانند GTiff -- GeoTIFF File Format و GPKG -- GeoPackage raster. همچنین در صورتی که مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند. --co, --creation-option = بسیاری از قالب‌ها یک یا چند گزینهٔ اختیاری ساخت دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. به‌عنوان مثال، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و کاشی‌بندی شدن فایل پشتیبانی می‌کند. می‌تواند تکرار شود. گزینه‌های ساخت موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینهٔ ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینهٔ خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان قالب، منبع قطعی اطلاعات دربارهٔ گزینه‌های ساخت درایور است. برای مشاهدهٔ گزینه‌های ساخت مجاز برای هر قالب، به مستندات اختصاصی قالب‌های Raster drivers مراجعه کنید. --if, --input-format نام قالب/درایور برای تلاش جهت باز کردن فایل(های) ورودی. به‌طور کلی نیازی به مشخص کردن آن نیست، اما می‌توان از آن برای نادیده گرفتن تشخیص خودکار درایور، در مواقعی که در انتخاب درایور مناسب ناموفق است، استفاده کرد. این گزینه را می‌توان چندین بار برای تعیین چندین درایور کاندید تکرار کرد. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند. به‌ویژه، برخی از درایورها نیازمندی‌هایی برای پسوند فایل دارند. می‌تواند تکرار شود. --oo, --open-option = گزینهٔ باز کردن مجموعه‌داده (مخصوص قالب). می‌تواند تکرار شود. -f, --of, --format, --output-format کدام قالب رستر خروجی استفاده شود. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: gdal --formats | grep raster | grep rw | sort --overwrite به برنامه اجازه می‌دهد فایل یا مجموعه‌دادهٔ هدفِ موجود را بازنویسی کند. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌دادهٔ هدف از قبل وجود داشته باشد، gdal با خطا متوقف می‌شود. وضعیت خروج (EXIT STATUS) این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا کد غیرصفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به‌صورت هشدار صادر می‌شوند، اجرای موفق در نظر گرفته می‌شوند). مثال‌ها (EXAMPLES) مثال ۱: حذف چندضلعی‌های کوچک‌تر از ۱۰ پیکسل از باند ۲ یک رستر. $ gdal raster sieve -b 2 -s 10 input.tif output.tif نویسندگان (AUTHORS) Alessandro Pasotti کپی‌رایت و تکثیر (COPYRIGHT) 1998-2026 August 18, 2026 GDAL-RASTER-SIEVE(1)