| GDAL-RASTER-SIEVE(1) | GDAL | GDAL-RASTER-SIEVE(1) |
نام (NAME)
gdal-raster-sieve - حذف چندضلعیهای کوچک رستر
در نسخهٔ 3.11 اضافه شد.
خلاصه دستور (SYNOPSIS)
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]
توضیحات (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 <BAND>
- باند ورودی (اندیس با پایهٔ ۱)
- -c, --connect-diagonal-pixels
- پیکسلهای مورب (پیکسلهای واقع در گوشهها) را متصل در نظر میگیرد. رفتار پیشفرض تنها متصل در نظر گرفتن پیکسلهایی است که با لبهها در تماس هستند که معادل اتصال ۴گانه (4-connectivity) است. هنگامی که این گزینه انتخاب شود، الگوریتم پیکسلهای گوشه را نیز متصل در نظر خواهد گرفت که معادل اتصال ۸گانه (8-connectivity) است.
- --mask <MASK>
- از نخستین باند فایل مشخصشده بهعنوان ماسک اعتبارسنجی استفاده میکند: تمام پیکسلهای موجود در باند ماسک با مقداری غیر از صفر، برای گنجانده شدن در چندضلعیها مناسب در نظر گرفته میشوند.
- -s, --size-threshold <SIZE-THRESHOLD>
- حداقل اندازهٔ چندضلعیها برای نگهداری (پیشفرض: 2)
گزینههای استاندارد (STANDARD OPTIONS)
- --append
- رستر ورودی را بهعنوان یک زیرمجموعهدادهٔ جدید به یک فایل خروجی موجود الحاق میکند. تنها با درایورهایی کار میکند که از افزودن زیرمجموعهدادهها پشتیبانی میکنند، مانند GTiff -- GeoTIFF File Format و GPKG -- GeoPackage raster. همچنین در صورتی که مجموعهداده خروجی هنوز وجود نداشته باشد، آن را ایجاد میکند.
- --co, --creation-option <NAME>=<VALUE>
- بسیاری از
قالبها یک
یا چند
گزینهٔ
اختیاری
ساخت دارند
که میتوان
از آنها
برای کنترل
جزئیات
فایل
ایجادشده
استفاده
کرد.
بهعنوان
مثال،
درایور GeoTIFF از
گزینههای
ساخت برای
کنترل
فشردهسازی
و
کاشیبندی
شدن فایل
پشتیبانی
میکند.
میتواند تکرار شود.
گزینههای ساخت موجود بسته به درایور قالب متفاوت است و برخی قالبهای ساده اصلاً هیچ گزینهٔ ساختی ندارند. فهرستی از گزینههای پشتیبانیشده برای یک قالب را میتوان با گزینهٔ خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان قالب، منبع قطعی اطلاعات دربارهٔ گزینههای ساخت درایور است. برای مشاهدهٔ گزینههای ساخت مجاز برای هر قالب، به مستندات اختصاصی قالبهای Raster drivers مراجعه کنید.
- --if, --input-format <format>
- نام
قالب/درایور
برای تلاش
جهت باز
کردن
فایل(های)
ورودی.
بهطور کلی
نیازی به
مشخص کردن
آن نیست،
اما
میتوان از
آن برای
نادیده
گرفتن
تشخیص
خودکار
درایور، در
مواقعی که
در انتخاب
درایور
مناسب
ناموفق
است،
استفاده
کرد. این
گزینه را
میتوان
چندین بار
برای تعیین
چندین
درایور
کاندید
تکرار کرد.
توجه داشته
باشید که
این گزینه
آن
درایورها
را مجبور به
باز کردن
مجموعهداده
نمیکند.
بهویژه،
برخی از
درایورها
نیازمندیهایی
برای پسوند
فایل دارند.
میتواند تکرار شود.
- --oo, --open-option <NAME>=<VALUE>
- گزینهٔ باز
کردن
مجموعهداده
(مخصوص
قالب).
میتواند تکرار شود.
- -f, --of, --format, --output-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 <elpaso@itopen.it>
کپیرایت و تکثیر (COPYRIGHT)
1998-2026
| August 18, 2026 |