GDAL-RASTER-FILL-NODATA(1) GDAL GDAL-RASTER-FILL-NODATA(1)

gdal-raster-fill-nodata - پر کردن مقادیر nodata در مجموعه‌داده رستر

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

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]

دستور gdal raster fill-nodata نواحی nodata را با درون‌یابی از پیکسل‌های معتبر پیرامون لبه‌های آن ناحیه پر می‌کند.

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

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

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

نکته:

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

یک باند <BAND> ورودی را برای پردازش انتخاب می‌کند. شماره‌گذاری باندها از 1 آغاز می‌شود. پیش‌فرض، نخستین باند مجموعه‌داده ورودی است.
استفاده از باند اول فایل مشخص‌شده به‌عنوان ماسک اعتبار (صفر نامعتبر است، غیر صفر معتبر است).
حداکثر فاصله‌ای (به پیکسل) را تعیین می‌کند که الگوریتم برای درون‌یابی مقادیر جستجو خواهد کرد. پیش‌فرض 100 پیکسل است.
تعداد تکرارهای هموارسازی فیلتر میانگین 3x3 را برای اعمال روی رستر پرشده جهت کاهش اعوجاج‌ها تعیین می‌کند. پیش‌فرض 0 تکرار است.
انتخاب راهبرد درون‌یابی (<STRATEGY>) برای استفاده. به‌طور پیش‌فرض، پیکسل‌ها با استفاده از وزن‌دهی عکس فاصله (invdist) درون‌یابی می‌شوند. همچنین امکان انتخاب راهبرد نزدیک‌ترین همسایه (nearest) وجود دارد.

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

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

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

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

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

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

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

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

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

این دستور استفاده از باند دوم رستر ورودی، حداکثر فاصله 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

Alessandro Pasotti <elpaso@itopen.it>

1998-2026

August 18, 2026