.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "GDAL-RASTER-FILL-NODATA" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-fill-nodata \- پر کردن مقادیر nodata در مجموعه‌داده رستر .sp در نسخه 3.11 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster fill\-nodata [OPTIONS] Fill nodata raster regions by interpolation from edges. 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 (\(dqGDALG\(dq 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 \-b, \-\-band Input band (1\-based index) (default: 1) \-d, \-\-max\-distance The maximum distance (in pixels) that the algorithm will search out for values to interpolate. (default: 100) \-s, \-\-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 Use the first band of the specified file as a validity mask (zero is invalid, non\-zero is valid). \-\-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 formats [may be repeated] [not available in pipelines] \-\-oo, \-\-open\-option = Open options [may be repeated] [not available in pipelines] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster fill\-nodata\fP نواحی nodata را با درون‌یابی از پیکسل‌های معتبر پیرامون لبه‌های آن ناحیه پر می‌کند. .sp این زیردستور همچنین به‌عنوان یک مرحله بالقوه در \fI\%gdal raster pipeline\fP در دسترس است (از GDAL 3.12). .sp در نسخه 3.12 اضافه شد. .SH "خروجی GDALG (مجموعه‌داده درلحظه / جریانی) (GDALG OUTPUT)" .sp این برنامه از سریال‌سازی خط فرمان به‌عنوان یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. فایل حاصل را می‌توان سپس به‌عنوان یک مجموعه‌داده رستر با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP باز کرد، و خط لوله مشخص‌شده را به‌صورت درلحظه (on\-the\-fly) / جریانی اعمال نمود. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 با این حال، این الگوریتم به‌صورت ذاتی با پردازش جریانی سازگار نیست. در نتیجه یک مجموعه‌داده موقت ایجاد خواهد شد که ممکن است هنگام باز کردن باعث صرف زمان پردازش قابل‌توجهی شود. .UNINDENT .UNINDENT .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-b, \-\-band یک باند ورودی را برای پردازش انتخاب می‌کند. شماره‌گذاری باندها از 1 آغاز می‌شود. پیش‌فرض، نخستین باند مجموعه‌داده ورودی است. .UNINDENT .INDENT 0.0 .TP .B \-\-mask استفاده از باند اول فایل مشخص‌شده به‌عنوان ماسک اعتبار (صفر نامعتبر است، غیر صفر معتبر است). .UNINDENT .INDENT 0.0 .TP .B \-\-max\-distance حداکثر فاصله‌ای (به پیکسل) را تعیین می‌کند که الگوریتم برای درون‌یابی مقادیر جستجو خواهد کرد. پیش‌فرض 100 پیکسل است. .UNINDENT .INDENT 0.0 .TP .B \-\-smoothing\-iterations تعداد تکرارهای هموارسازی فیلتر میانگین 3x3 را برای اعمال روی رستر پرشده جهت کاهش اعوجاج‌ها تعیین می‌کند. پیش‌فرض 0 تکرار است. .UNINDENT .INDENT 0.0 .TP .B \-\-strategy انتخاب راهبرد درون‌یابی () برای استفاده. به‌طور پیش‌فرض، پیکسل‌ها با استفاده از وزن‌دهی عکس فاصله (\fIinvdist\fP) درون‌یابی می‌شوند. همچنین امکان انتخاب راهبرد نزدیک‌ترین همسایه (\fInearest\fP) وجود دارد. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-append الحاق رستر ورودی به‌عنوان یک زیرمجموعه‌داده جدید به یک فایل خروجی موجود. تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده پشتیبانی می‌کنند، مانند \fI\%GTiff \-\- GeoTIFF File Format\fP و \fI\%GPKG \-\- GeoPackage raster\fP\&. این گزینه همچنین در صورت عدم وجود مجموعه‌داده خروجی، آن را ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توانند برای کنترل جزئیات فایل ایجادشده استفاده شوند. برای نمونه، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و اینکه آیا فایل باید تایل‌بندی شود، پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت موجود بسته به درایور قالب متغیر است، و برخی قالب‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات مربوط به همان قالب مرجع قطعی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز برای هر قالب، به مستندات اختصاصی قالب در \fI\%Raster drivers\fP مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام قالب/درایوری که برای باز کردن فایل(های) ورودی تلاش می‌شود. معمولاً نیازی به مشخص کردن آن نیست، اما در صورتی که تشخیص خودکار درایور در انتخاب درایور مناسب ناموفق باشد، می‌تواند برای نادیده گرفتن آن استفاده شود. این گزینه می‌تواند چندین بار برای مشخص کردن چندین درایور کاندید تکرار شود. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند. به‌ویژه، برخی درایورها نیازمندی‌هایی برای پسوند فایل دارند. .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه‌داده (مختص هر قالب). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format تعیین قالب رستر خروجی برای استفاده. مقادیر مجاز را می‌توان با این دستور مشاهده کرد: \fBgdal \-\-formats | grep raster | grep rw | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite اجازه به برنامه برای رونویسی روی فایل یا مجموعه‌داده مقصد موجود. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌داده مقصد از قبل وجود داشته باشد، \fBgdal\fP خطا می‌دهد. .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp این برنامه در صورت موفقیت کد وضعیت 0، و در صورت بروز خطا کد غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به‌صورت هشدار صادر می‌شوند، اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: پر کردن نواحی nodata در یک رستر" .sp این دستور استفاده از باند دوم رستر ورودی، حداکثر فاصله 50 پیکسل، 3 تکرار هموارسازی و راهبرد \fInearest\fP را برای درون‌یابی مشخص می‌کند. خروجی در \fIoutput.tif\fP ذخیره خواهد شد\&. .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster fill\-nodata \-b 2 \-\-max\-distance 50 \-\-smoothing\-iterations 3 \e \-\-strategy nearest \-\-mask mask.tif \e input.tif output.tif .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Alessandro Pasotti .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .