| GDAL-RASTER-FILL-NODATA(1) | GDAL | GDAL-RASTER-FILL-NODATA(1) |
نام (NAME)
gdal-raster-fill-nodata - پر کردن مقادیر nodata در مجموعهداده رستر
در نسخه 3.11 اضافه شد.
خلاصه دستور (SYNOPSIS)
Usage: gdal raster fill-nodata [OPTIONS] <INPUT> <OUTPUT>
Fill nodata raster regions by interpolation from edges.
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
-b, --band <BAND> Input band (1-based index) (default: 1)
-d, --max-distance <MAX_DISTANCE> The maximum distance (in pixels) that the algorithm will search out for values to interpolate. (default: 100)
-s, --smoothing-iterations <SMOOTHING_ITERATIONS> The number of 3x3 average filter smoothing iterations to run after the interpolation to dampen artifacts. The default is zero smoothing iterations. (default: 0)
--mask <MASK> Use the first band of the specified file as a validity mask (zero is invalid, non-zero is valid).
--strategy <STRATEGY> By default, pixels are interpolated using an inverse distance weighting (invdist). It is also possible to choose a nearest neighbour (nearest) strategy.. STRATEGY=invdist|nearest (default: invdist)
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 fill-nodata نواحی nodata را با درونیابی از پیکسلهای معتبر پیرامون لبههای آن ناحیه پر میکند.
این زیردستور همچنین بهعنوان یک مرحله بالقوه در gdal raster pipeline در دسترس است (از GDAL 3.12).
در نسخه 3.12 اضافه شد.
خروجی GDALG (مجموعهداده درلحظه / جریانی) (GDALG OUTPUT)
این برنامه از سریالسازی خط فرمان بهعنوان یک فایل JSON با استفاده از قالب خروجی GDALG پشتیبانی میکند. فایل حاصل را میتوان سپس بهعنوان یک مجموعهداده رستر با استفاده از درایور GDALG: GDAL Streamed Algorithm باز کرد، و خط لوله مشخصشده را بهصورت درلحظه (on-the-fly) / جریانی اعمال نمود.
نکته:
گزینههای اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)
- -b, --band <BAND>
- یک باند <BAND> ورودی را برای پردازش انتخاب میکند. شمارهگذاری باندها از 1 آغاز میشود. پیشفرض، نخستین باند مجموعهداده ورودی است.
- --mask <MASK>
- استفاده از باند اول فایل مشخصشده بهعنوان ماسک اعتبار (صفر نامعتبر است، غیر صفر معتبر است).
- --max-distance <MAX_DISTANCE>
- حداکثر فاصلهای (به پیکسل) را تعیین میکند که الگوریتم برای درونیابی مقادیر جستجو خواهد کرد. پیشفرض 100 پیکسل است.
- --smoothing-iterations <SMOOTHING_ITERATIONS>
- تعداد تکرارهای هموارسازی فیلتر میانگین 3x3 را برای اعمال روی رستر پرشده جهت کاهش اعوجاجها تعیین میکند. پیشفرض 0 تکرار است.
- --strategy <STRATEGY>
- انتخاب راهبرد درونیابی (<STRATEGY>) برای استفاده. بهطور پیشفرض، پیکسلها با استفاده از وزندهی عکس فاصله (invdist) درونیابی میشوند. همچنین امکان انتخاب راهبرد نزدیکترین همسایه (nearest) وجود دارد.
گزینههای استاندارد (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)
مثال ۱: پر کردن نواحی nodata در یک رستر
این دستور استفاده از باند دوم رستر ورودی، حداکثر فاصله 50 پیکسل، 3 تکرار هموارسازی و راهبرد nearest را برای درونیابی مشخص میکند. خروجی در output.tif ذخیره خواهد شد.
gdal raster fill-nodata -b 2 --max-distance 50 --smoothing-iterations 3 \
--strategy nearest --mask mask.tif \
input.tif output.tif
نویسندگان (AUTHORS)
Alessandro Pasotti <elpaso@itopen.it>
کپیرایت و تکثیر (COPYRIGHT)
1998-2026
| August 18, 2026 |